{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://huggingbay.xyz/api/schemas","title":"Hugging Bay Public API Schemas","$defs":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"message":{"type":"string"},"required":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"Health":{"type":"object","required":["schemaVersion","ok","ready","liveness","service","verifiedDownloads"],"properties":{"schemaVersion":{"const":"hugging-bay.health.v1"},"ok":{"type":"boolean"},"ready":{"type":"boolean"},"degraded":{"type":"boolean"},"reason":{"type":"string"},"liveness":{"const":"ok"},"service":{"const":"hugging-bay"},"verifiedDownloads":{"type":"object","required":["ready"],"properties":{"ready":{"type":"boolean"},"severity":{"type":"string"}},"additionalProperties":true}},"allOf":[{"if":{"properties":{"ready":{"const":true}}},"then":{"properties":{"verifiedDownloads":{"properties":{"ready":{"const":true}}}}}}],"additionalProperties":true},"DeploymentVersion":{"type":"object","required":["schemaVersion","generatedAt","service","commit","shortCommit","commitSource","packageName","packageVersion","urls"],"properties":{"schemaVersion":{"type":"string","const":"hugging-bay.version.v1"},"generatedAt":{"type":"string","format":"date-time"},"baseUrl":{"type":"string"},"service":{"type":"string"},"packageName":{"type":"string"},"packageVersion":{"type":"string"},"commit":{"type":"string"},"shortCommit":{"type":"string"},"commitSource":{"type":"string"},"buildTime":{"type":"string"},"deployProvider":{"type":"string"},"renderServiceName":{"type":"string"},"nodeEnv":{"type":"string"},"staticContentLastmod":{"type":"string"},"urls":{"type":"object","properties":{"self":{"type":"string"},"health":{"type":"string"},"readiness":{"type":"string"},"openapi":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true},"ReviewedPeerFallback":{"type":"object","required":["id","type","protocol","status","verified","publiclyDownloadable"],"properties":{"id":{"type":"string"},"type":{"type":"string","enum":["magnet","torrent"]},"protocol":{"type":"string","enum":["bittorrent"]},"status":{"type":"string","enum":["verified"]},"verified":{"type":"boolean"},"publiclyDownloadable":{"type":"boolean"},"displayName":{"type":"string"},"infoHash":{"type":"string"},"magnetUri":{"type":["string","null"]},"sourceUrl":{"type":["string","null"]},"sizeBytes":{"type":"number"},"fileCount":{"type":"number"},"trackerCount":{"type":"number"},"submittedAt":{"type":"string"},"reviewedAt":{"type":"string"},"source":{"type":"string"},"note":{"type":"string"},"scope":{"type":"string","enum":["file","artifact-release"]},"filePath":{"type":"string"},"appliesToFile":{"type":"boolean"},"directDownload":{"type":"boolean"},"trustBoundary":{"type":"string"},"verificationTarget":{"type":"object","properties":{"sha256":{"type":"string"},"manifestUrl":{"type":["string","null"]},"distributionUrl":{"type":["string","null"]}},"additionalProperties":true}},"additionalProperties":true},"MirrorLimits":{"type":"object","properties":{"maxFileBytes":{"type":"number"},"maxTotalBytes":{"type":"number"},"maxFiles":{"type":"number"},"maxRuntimeFiles":{"type":"number"},"scanSampleBytes":{"type":"number"},"maxMirrorFileBytes":{"type":"number"},"maxMirrorTotalBytes":{"type":"number"},"storageProvider":{"type":"string"},"policy":{"type":"string"},"reviewedRiskyWeightPolicy":{"type":"string"}},"additionalProperties":true},"Principal":{"type":"object","required":["id","role","allowedOwners"],"properties":{"id":{"type":"string"},"role":{"type":"string","enum":["visitor","reader","publisher","admin"]},"allowedOwners":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"FacetCounts":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","required":["value","count"],"properties":{"value":{"type":"string"},"count":{"type":"number"}}}}},"ArtifactSummary":{"type":"object","required":["id","owner","name","repo","type","license","visibility","hostingStatus","fileCount"],"properties":{"id":{"type":"string"},"owner":{"type":"string"},"name":{"type":"string"},"repo":{"type":"string"},"type":{"type":"string"},"summary":{"type":"string"},"publisher":{"type":"string"},"sourceUrl":{"type":"string"},"license":{"type":"string"},"visibility":{"type":"string"},"verificationStatus":{"type":"string"},"scanStatus":{"type":"string"},"cardCompleteness":{"type":"number"},"tags":{"type":"array","items":{"type":"string"}},"task":{"type":["string","null"]},"modality":{"type":["string","null"]},"framework":{"type":["string","null"]},"baseModel":{"type":["string","null"]},"derivedFrom":{"type":["string","null"]},"cardMetadata":{"type":["object","null"],"additionalProperties":true},"formats":{"type":"array","items":{"type":"string"}},"worksWith":{"type":"array","items":{"type":"string"}},"runtimeFit":{"type":"object","additionalProperties":true},"sizeBytes":{"type":"number"},"sizeKnown":{"type":"boolean"},"sizeLabel":{"type":"string"},"sizeReason":{"type":"string"},"declaredSizeBytes":{"type":"number"},"mirrorCount":{"type":"number"},"downloadCount":{"type":"number"},"stars":{"type":"number"},"citations":{"type":"number"},"updatedAt":{"type":"string"},"createdAt":{"type":"string"},"upstream":{"type":["object","null"],"additionalProperties":true},"hosting":{"type":["object","null"],"additionalProperties":true},"hostingStatus":{"type":"string"},"fileCount":{"type":"number"},"hostedFileCount":{"type":"number"},"externalFileCount":{"type":"number"},"signals":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ArtifactSignals"},"sampleFiles":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ArtifactFile"}},"searchExplanation":{"type":"object","additionalProperties":true},"semanticScore":{"type":"number"},"semanticReasons":{"type":"array","items":{"type":"string"}},"semanticIntents":{"type":"array","items":{"type":"object","additionalProperties":true}}},"additionalProperties":true},"SavedArtifact":{"type":"object","required":["id","repo","owner","name","type","license","summary","hostingStatus","sourceUrl","savedAt"],"properties":{"id":{"type":"string"},"repo":{"type":"string"},"owner":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"license":{"type":"string"},"summary":{"type":"string"},"hostingStatus":{"type":"string"},"sourceUrl":{"type":"string"},"savedAt":{"type":"string"},"collection":{"type":"string","description":"Optional user-defined library collection name."},"note":{"type":"string","description":"Optional private note for the saved artifact."}},"additionalProperties":true},"LibraryResponse":{"type":"object","required":["schemaVersion","generatedAt","total","rows"],"properties":{"schemaVersion":{"const":"hugging-bay.library.v1"},"generatedAt":{"type":"string"},"total":{"type":"number"},"rows":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/SavedArtifact"}}},"additionalProperties":true},"AccountDashboard":{"type":"object","required":["schemaVersion","generatedAt","principal","stats","collections","watchlists","recentSaved","recommendedActions","agentActions","policy"],"properties":{"schemaVersion":{"const":"hugging-bay.account-dashboard.v1"},"generatedAt":{"type":"string"},"principal":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/Principal"},"stats":{"type":"object","required":["savedArtifacts","hostedSavedArtifacts","externalSavedArtifacts","collections","savedSearches","alertWatchlists","watchlistsWithNewMatches","newMatches","readerTokens","activeReaderTokens"],"properties":{"savedArtifacts":{"type":"number"},"hostedSavedArtifacts":{"type":"number"},"externalSavedArtifacts":{"type":"number"},"collections":{"type":"number"},"savedSearches":{"type":"number"},"alertWatchlists":{"type":"number"},"watchlistsWithNewMatches":{"type":"number"},"newMatches":{"type":"number"},"readerTokens":{"type":"number"},"activeReaderTokens":{"type":"number"},"verifiedReviewRuns":{"type":"number"},"reviewEvidenceItems":{"type":"number"}},"additionalProperties":true},"collections":{"type":"array","items":{"type":"object","required":["name","count","hosted","external","recent"],"properties":{"name":{"type":"string"},"count":{"type":"number"},"hosted":{"type":"number"},"external":{"type":"number"},"licenses":{"type":"object","additionalProperties":{"type":"number"}},"types":{"type":"object","additionalProperties":{"type":"number"}},"recent":{"type":"array","items":{"type":"object","additionalProperties":true}},"compareUrl":{"type":["string","null"]}},"additionalProperties":true}},"watchlists":{"type":"array","items":{"type":"object","additionalProperties":true}},"recentSaved":{"type":"array","items":{"type":"object","additionalProperties":true}},"recommendedActions":{"type":"array","items":{"type":"object","additionalProperties":true}},"agentActions":{"type":"object","additionalProperties":{"type":"string"}},"policy":{"type":"object","additionalProperties":true}},"additionalProperties":true},"AccountClearResponse":{"type":"object","required":["schemaVersion","cleared","remaining"],"properties":{"schemaVersion":{"type":"string","enum":["hugging-bay.library-clear.v1","hugging-bay.saved-searches-clear.v1"]},"cleared":{"type":"number","description":"Number of rows removed for the authenticated principal."},"remaining":{"type":"number","description":"Rows still scoped to the authenticated principal after the clear."}},"additionalProperties":true},"SavedSearchAlert":{"type":"object","required":["enabled","lastResultIds"],"properties":{"enabled":{"type":"boolean"},"lastSeenAt":{"type":"string"},"lastCheckedAt":{"type":"string"},"lastResultIds":{"type":"array","items":{"type":"string"},"maxItems":50},"delivery":{"type":"object","properties":{"browser":{"type":"object","additionalProperties":true},"apiDigest":{"type":"object","additionalProperties":true},"webhook":{"type":"object","additionalProperties":true},"email":{"type":"object","additionalProperties":true}},"additionalProperties":true}},"additionalProperties":true},"SavedSearchAlertState":{"type":"object","required":["enabled","status"],"properties":{"enabled":{"type":"boolean"},"status":{"type":"string","enum":["disabled","current","new_matches","not_checked"]},"reason":{"type":"string"},"checkedAt":{"type":"string"},"lastSeenAt":{"type":["string","null"]},"lastCheckedAt":{"type":["string","null"]},"currentResultCount":{"type":"number"},"returnedResultCount":{"type":"number"},"newResultCount":{"type":"number"},"newResultIds":{"type":"array","items":{"type":"string"}},"currentResultIds":{"type":"array","items":{"type":"string"}},"newResults":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/SavedSearchDigestRow"}},"digestUrl":{"type":"string"},"alertUrl":{"type":"string"},"delivery":{"type":"object","properties":{"delivery":{"type":"object","additionalProperties":true},"activeChannels":{"type":"array","items":{"type":"string"}},"browserDigestUrl":{"type":"string"},"apiAlertsUrl":{"type":"string"},"note":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true},"SavedSearch":{"type":"object","required":["id","label","filters","sortKey","route","browserPath","apiPath","resultCount","savedAt"],"properties":{"id":{"type":"string"},"label":{"type":"string"},"filters":{"type":"object","required":["query","types"],"properties":{"query":{"type":"string"},"types":{"type":"array","items":{"type":"string"}},"license":{"type":"string"},"task":{"type":"string"},"framework":{"type":"string"},"format":{"type":"string"},"worksWith":{"type":"string"},"owner":{"type":"string"},"source":{"type":"string"},"hosting":{"type":"string"},"reviewStatus":{"type":"string","enum":["","first-review","needs-evidence","reviewed","benchmark"]},"scanStatus":{"type":"string"},"minCardCompleteness":{"type":"string"},"verifiedOnly":{"type":"boolean"},"commercialOnly":{"type":"boolean"},"semanticMode":{"type":"boolean"}},"additionalProperties":true},"sortKey":{"type":"string","enum":["best","ready","mirrorable","trust","updated","downloads","stars","mirrors","name","size","license"]},"route":{"type":"string"},"browserPath":{"type":"string"},"apiPath":{"type":"string"},"resultCount":{"type":"number"},"savedAt":{"type":"string"},"updatedAt":{"type":"string"},"notificationsEnabled":{"type":"boolean"},"alert":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/SavedSearchAlert"},"alertState":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/SavedSearchAlertState"}},"additionalProperties":true},"SavedSearchesResponse":{"type":"object","required":["schemaVersion","generatedAt","total","rows"],"properties":{"schemaVersion":{"const":"hugging-bay.saved-searches.v1"},"generatedAt":{"type":"string"},"total":{"type":"number"},"rows":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/SavedSearch"}},"alertPolicy":{"type":"object","additionalProperties":true}},"additionalProperties":true},"SavedSearchAlertsResponse":{"type":"object","required":["schemaVersion","generatedAt","total","rows"],"properties":{"schemaVersion":{"const":"hugging-bay.saved-search-alerts.v1"},"generatedAt":{"type":"string"},"total":{"type":"number"},"rows":{"type":"array","items":{"type":"object","required":["search","alertState"],"properties":{"search":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/SavedSearch"},"alertState":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/SavedSearchAlertState"}},"additionalProperties":true}},"policy":{"type":"object","additionalProperties":true}},"additionalProperties":true},"SavedSearchDigestRow":{"type":"object","required":["id","repo","type","license","hostingStatus","hostedFileCount","externalFileCount","downloads","stars","updatedAt","urls"],"properties":{"id":{"type":"string"},"repo":{"type":"string"},"type":{"type":"string"},"license":{"type":"string"},"summary":{"type":"string"},"hostingStatus":{"type":"string"},"hostedFileCount":{"type":"number"},"externalFileCount":{"type":"number"},"downloads":{"type":"number"},"stars":{"type":"number"},"trust":{"type":["object","null"],"additionalProperties":true},"updatedAt":{"type":"string"},"urls":{"type":"object","required":["artifact","metadata","card","distribution","files"],"properties":{"artifact":{"type":"string"},"metadata":{"type":"string"},"card":{"type":"string"},"distribution":{"type":"string"},"files":{"type":"string"},"requestMirror":{"type":["string","null"]}},"additionalProperties":true}},"additionalProperties":true},"SavedSearchDigest":{"type":"object","required":["schemaVersion","generatedAt","search","browserUrl","apiUrl","digestUrl","summary","rows","newOrUpdated","hosted","requestable"],"properties":{"schemaVersion":{"const":"hugging-bay.saved-search-digest.v1"},"generatedAt":{"type":"string"},"search":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/SavedSearch"},"browserUrl":{"type":"string"},"apiUrl":{"type":"string"},"digestUrl":{"type":"string"},"summary":{"type":"object","required":["totalMatches","returnedMatches","newOrUpdated","hostedMatches","requestableMatches","topDownloads"],"properties":{"totalMatches":{"type":"number"},"returnedMatches":{"type":"number"},"newOrUpdated":{"type":"number"},"hostedMatches":{"type":"number"},"requestableMatches":{"type":"number"},"topDownloads":{"type":"number"},"nextCursor":{"type":["string","null"]}},"additionalProperties":true},"rows":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/SavedSearchDigestRow"}},"newOrUpdated":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/SavedSearchDigestRow"}},"hosted":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/SavedSearchDigestRow"}},"requestable":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/SavedSearchDigestRow"}},"agentActions":{"type":"object","additionalProperties":true},"policy":{"type":"object","additionalProperties":true}},"additionalProperties":true},"ArtifactPage":{"type":"object","required":["rows","total","limit","cursor","nextCursor","generatedAt"],"properties":{"rows":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ArtifactSummary"}},"total":{"type":"number"},"limit":{"type":"number"},"cursor":{"type":"string"},"nextCursor":{"type":["string","null"]},"facets":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/FacetCounts"},"facetsApproximate":{"type":"boolean","description":"True when facet counts cover a bounded search candidate set or returned page rather than the complete matching catalog."},"facetsScope":{"type":"string","enum":["bounded-search-candidates","returned-search-page","degraded-fallback-results"]},"estimatedTotal":{"type":"boolean","description":"True when total is bounded or estimated and must not be treated as the complete matching catalog count."},"degraded":{"type":"boolean","description":"True when the response came from a degraded, stale, or fallback catalog read."},"partial":{"type":"boolean","description":"True when returned rows may omit matching catalog entries; zero rows or totals are not authoritative."},"retryable":{"type":"boolean","description":"True when retrying may recover a more complete catalog response."},"retryAfterSeconds":{"type":"integer","minimum":1,"description":"Suggested minimum delay before retrying a degraded catalog response."},"warning":{"type":"string"},"fastPath":{"type":"string"},"recommendation":{"type":"object","required":["action","filters","message"],"properties":{"action":{"type":"string"},"filters":{"type":"array","items":{"type":"string"}},"message":{"type":"string"}},"additionalProperties":false},"explain":{"type":"object","required":["query","tokens","expandedTokenGroups","mode"],"properties":{"query":{"type":"string"},"tokens":{"type":"array","items":{"type":"string"}},"expandedTokenGroups":{"type":"array","items":{"type":"array","items":{"type":"string"}}},"mode":{"type":"string"},"note":{"type":"string"},"semantic":{"type":"object","additionalProperties":true}},"additionalProperties":true},"generatedAt":{"type":"string"}}},"FindModelResponse":{"type":"object","required":["schemaVersion","generatedAt","input","resultContract","candidates","guidance"],"properties":{"schemaVersion":{"const":"hugging-bay.find-model.v1"},"generatedAt":{"type":"string"},"input":{"type":"object","additionalProperties":true},"resultContract":{"type":"object","additionalProperties":true},"candidates":{"type":"array","items":{"type":"object","additionalProperties":true}},"bestPick":{"type":["object","null"],"additionalProperties":true},"exclusions":{"type":"array","items":{"type":"object","additionalProperties":true}},"fitUnknown":{"type":"array","items":{"type":"object","additionalProperties":true}},"degraded":{"type":"boolean"},"partial":{"type":"boolean"},"guidance":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"ArtifactDownloadPlan":{"type":"object","required":["schemaVersion","generatedAt","artifact","status","manifest","files","commands"],"properties":{"schemaVersion":{"const":"hugging-bay.artifact-download-plan.v1"},"generatedAt":{"type":"string"},"artifact":{"type":"object","additionalProperties":true},"status":{"type":"string"},"tool":{"type":"string"},"manifest":{"type":"object","additionalProperties":true},"peerFallbackReadiness":{"type":"object","additionalProperties":true},"verified":{"type":"object","additionalProperties":true},"stats":{"type":"object","additionalProperties":true},"fileIntegrity":{"type":"object","additionalProperties":true},"completionAttestation":{"type":"object","additionalProperties":true},"files":{"type":"array","items":{"type":"object","additionalProperties":true}},"commands":{"type":"array","items":{"type":"object","additionalProperties":true}},"actions":{"type":"object","additionalProperties":true},"warnings":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"ArtifactFile":{"type":"object","required":["path"],"properties":{"path":{"type":"string"},"sizeBytes":{"type":"number"},"format":{"type":["string","null"]},"sha256":{"type":["string","null"]},"risk":{"type":["string","null"]},"sourceKind":{"type":["string","null"]},"downloadPolicy":{"type":["string","null"]},"storageKey":{"type":["string","null"]},"externalUrl":{"type":["string","null"]},"peerFallbacks":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ReviewedPeerFallback"}}},"additionalProperties":true},"ToolCommand":{"type":"object","required":["id","label","command"],"properties":{"id":{"type":"string"},"tool":{"type":"string"},"label":{"type":"string"},"command":{"type":"string"},"detail":{"type":"string"},"description":{"type":"string"},"safe":{"type":"boolean"},"requiresHostedFiles":{"type":"boolean"},"docsUrl":{"type":"string"},"copyable":{"type":"boolean"}},"additionalProperties":true},"ArtifactSignals":{"type":"object","required":["size","demand","trust","readiness","action"],"properties":{"size":{"type":"object","additionalProperties":true},"demand":{"type":"object","additionalProperties":true},"trust":{"type":"object","additionalProperties":true},"readiness":{"type":"object","additionalProperties":true},"action":{"type":"object","additionalProperties":true}},"additionalProperties":true},"ModelCardFacts":{"type":"object","required":["facts","languages","datasets","metrics","evalResults","coverage"],"properties":{"source":{"type":"string"},"repoType":{"type":"string"},"sourceUrl":{"type":"string"},"declaredLicense":{"type":"string","description":"License declared by model-card metadata when available, falling back to the artifact license."},"pipelineTag":{"type":"string"},"libraryName":{"type":"string"},"baseModel":{"type":"string"},"baseModels":{"type":"array","items":{"type":"string"}},"taskCategories":{"type":"array","items":{"type":"string"}},"cardTags":{"type":"array","items":{"type":"string"}},"languages":{"type":"array","items":{"type":"string"}},"datasets":{"type":"array","items":{"type":"string"}},"metrics":{"type":"array","items":{"type":"string"}},"paperIds":{"type":"array","items":{"type":"string"}},"modelIndexNames":{"type":"array","items":{"type":"string"}},"evalResults":{"type":"array","items":{"type":"object","required":["benchmark","metric","score","task","verified"],"properties":{"benchmark":{"type":"string"},"metric":{"type":"string"},"score":{"type":"string"},"task":{"type":"string"},"verified":{"type":"boolean"}},"additionalProperties":true}},"siblingSample":{"type":"array","items":{"type":"object","required":["path","sizeBytes","lfs"],"properties":{"path":{"type":"string"},"sizeBytes":{"type":"number"},"lfs":{"type":"boolean"}},"additionalProperties":true}},"semanticTerms":{"type":"array","items":{"type":"string"}},"cardDataKeys":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","required":["rawKeyCount","normalizedFields","hasDeclaredLicense","hasEvaluationResults"],"properties":{"rawKeyCount":{"type":"number"},"normalizedFields":{"type":"number"},"hasDeclaredLicense":{"type":"boolean"},"hasPipeline":{"type":"boolean"},"hasLibrary":{"type":"boolean"},"hasBaseModel":{"type":"boolean"},"hasLanguages":{"type":"boolean"},"hasDatasets":{"type":"boolean"},"hasMetrics":{"type":"boolean"},"hasPapers":{"type":"boolean"},"hasModelIndex":{"type":"boolean"},"hasEvaluationResults":{"type":"boolean"},"hasFileHints":{"type":"boolean"},"hasTaskCategories":{"type":"boolean"},"hasCardTags":{"type":"boolean"}},"additionalProperties":true},"facts":{"type":"array","items":{"type":"object","required":["id","label","value"],"properties":{"id":{"type":"string"},"label":{"type":"string"},"value":{"type":"string"}},"additionalProperties":true}}},"additionalProperties":true},"ArtifactMetadata":{"type":"object","required":["schemaVersion","id","repo","canonicalUrl","apiUrl","filesUrl","license","hosting","agentUse"],"properties":{"schemaVersion":{"const":"hugging-bay.artifact-metadata.v1"},"id":{"type":"string"},"repo":{"type":"string"},"canonicalUrl":{"type":"string"},"apiUrl":{"type":"string"},"filesUrl":{"type":"string"},"distributionUrl":{"type":"string"},"manifestUrl":{"type":"string"},"license":{"type":"object","additionalProperties":true},"safety":{"type":"object","additionalProperties":true},"provenance":{"type":"object","additionalProperties":true},"hosting":{"type":"object","additionalProperties":true},"distribution":{"type":"object","additionalProperties":true},"metrics":{"type":"object","additionalProperties":true},"signals":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ArtifactSignals"},"modelCardFacts":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ModelCardFacts"},"agentUse":{"type":"object","additionalProperties":true}},"additionalProperties":true},"ArtifactCard":{"type":"object","required":["schemaVersion","generatedAt","artifact","actions"],"properties":{"schemaVersion":{"const":"hugging-bay.artifact-card.v1"},"generatedAt":{"type":"string"},"artifact":{"type":"object","properties":{"modelCardFacts":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ModelCardFacts"},"runtimeFit":{"type":"object","additionalProperties":true}},"additionalProperties":true},"signals":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ArtifactSignals"},"previewableFiles":{"type":"array","items":{"type":"object","additionalProperties":true}},"actions":{"type":"object","additionalProperties":true}},"additionalProperties":true},"ArtifactDistribution":{"type":"object","required":["schemaVersion","generatedAt","artifact","policy","hostedDownloads","upstream","decentralizedFallbacks"],"properties":{"schemaVersion":{"const":"hugging-bay.artifact-distribution.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"artifact":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ArtifactSummary"},"policy":{"type":"object","additionalProperties":true},"hostedDownloads":{"type":"object","properties":{"status":{"type":"string"},"hosted":{"type":"boolean"},"hostedFiles":{"type":"number"},"filesUrl":{"type":"string"},"downloadableFilesUrl":{"type":"string"},"manifestUrl":{"type":["string","null"]},"reviewedPeerFallbackReady":{"type":"boolean"},"reviewedPeerFallbackFiles":{"type":"number"},"reviewedPeerFallbackCount":{"type":"number"},"peerFallbackReadinessUrl":{"type":"string"},"rows":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/DownloadableFileRow"}}},"additionalProperties":true},"upstream":{"type":"object","additionalProperties":true},"decentralizedFallbacks":{"type":"object","properties":{"protocol":{"type":"string"},"verifiedCount":{"type":"number"},"pendingReviewCount":{"type":"number"},"requestUrl":{"type":"string"},"verified":{"type":"array","items":{"type":"object","additionalProperties":true}},"pendingReview":{"type":"array","items":{"type":"object","additionalProperties":true}}},"additionalProperties":true},"recommendedFlow":{"type":"array","items":{"type":"string"}},"actions":{"type":"object","additionalProperties":true}},"additionalProperties":true},"PeerFallbacksResponse":{"type":"object","required":["schemaVersion","generatedAt","artifact","policy","summary","readiness","verifiedFallbacks","files","actions","commands","guidance"],"properties":{"schemaVersion":{"const":"hugging-bay.peer-fallbacks.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"artifact":{"type":"object","additionalProperties":true},"policy":{"type":"object","additionalProperties":true},"summary":{"type":"object","properties":{"hostedFiles":{"type":"number"},"filesWithReviewedFallbacks":{"type":"number"},"reviewedFileFallbacks":{"type":"number"},"reviewedArtifactFallbacks":{"type":"number"},"reviewedFallbacks":{"type":"number"},"reviewedTorrentSources":{"type":"number"},"pendingReviewRequests":{"type":"number"},"ready":{"type":"boolean"}},"additionalProperties":true},"readiness":{"type":"object","additionalProperties":true},"verifiedFallbacks":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ReviewedPeerFallback"}},"files":{"type":"array","items":{"type":"object","properties":{"filePath":{"type":"string"},"sha256":{"type":"string"},"downloadUrl":{"type":["string","null"]},"manifestUrl":{"type":["string","null"]},"peerFallbacks":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ReviewedPeerFallback"}}},"additionalProperties":true}},"pendingReview":{"type":"array","items":{"type":"object","additionalProperties":true}},"actions":{"type":"object","additionalProperties":true},"commands":{"type":"array","items":{"type":"object","additionalProperties":true}},"guidance":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"ArtifactReview":{"type":"object","required":["id","artifactId","rating","title","body","createdAt"],"properties":{"id":{"type":"string"},"artifactId":{"type":"string"},"repo":{"type":"string"},"reviewer":{"type":"string"},"reviewerRole":{"type":"string"},"rating":{"type":"number","minimum":1,"maximum":5},"title":{"type":"string"},"body":{"type":"string"},"tool":{"type":"string"},"categoryRatings":{"type":"object","additionalProperties":{"type":"number","minimum":1,"maximum":5}},"version":{"type":"string"},"evidence":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/BenchmarkEvidence"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"additionalProperties":true},"BenchmarkEvidence":{"type":"object","properties":{"kind":{"type":"string","enum":["benchmark","performance","load-test"]},"benchmark":{"type":"string"},"task":{"type":"string"},"metric":{"type":"string"},"scoreValue":{"type":["number","null"]},"scoreText":{"type":"string"},"higherIsBetter":{"type":"boolean"},"hardware":{"type":"string"},"tool":{"type":"string"},"command":{"type":"string"},"runUrl":{"type":"string"},"verified":{"type":"boolean"}},"additionalProperties":true},"BenchmarkEvidenceSummary":{"type":"object","required":["count","verifiedCount","benchmarkCount","performanceCount"],"properties":{"count":{"type":"number"},"verifiedCount":{"type":"number"},"benchmarkCount":{"type":"number"},"performanceCount":{"type":"number"},"hardwareCounts":{"type":"object","additionalProperties":true},"topMetrics":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/BenchmarkEvidence"}},"recent":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/BenchmarkEvidence"}}},"additionalProperties":true},"ArtifactReviewsResponse":{"type":"object","required":["schemaVersion","artifactId","generatedAt","summary","rows"],"properties":{"schemaVersion":{"const":"hugging-bay.artifact-reviews.v1"},"artifactId":{"type":"string"},"generatedAt":{"type":"string"},"summary":{"type":"object","required":["count","averageRating","verifiedRuns","helpfulCount","reportCount","reportedReviews"],"properties":{"count":{"type":"number"},"categoryAverages":{"type":"object","additionalProperties":{"type":"number"}},"categoryCounts":{"type":"object","additionalProperties":{"type":"number"}}},"additionalProperties":true},"rows":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ArtifactReview"}}},"additionalProperties":true},"ArtifactReviewSummaryResponse":{"type":"object","required":["schemaVersion","artifactId","generatedAt","summary","rating","recentReviews","answerEngine"],"properties":{"schemaVersion":{"const":"hugging-bay.artifact-review-summary.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"artifactId":{"type":"string"},"repo":{"type":"string"},"canonicalUrl":{"type":"string"},"apiUrl":{"type":"string"},"reviewsUrl":{"type":"string"},"trustBundleUrl":{"type":"string"},"agentBundleUrl":{"type":"string"},"artifact":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ArtifactSummary"},"summary":{"type":"object","additionalProperties":true},"rating":{"type":"object","required":["count","average","distribution","helpfulCount","reportCount","reportedReviews"],"properties":{"count":{"type":"number"},"average":{"type":"number"},"distribution":{"type":"object","additionalProperties":true},"categoryAverages":{"type":"object","additionalProperties":{"type":"number"}},"categoryCounts":{"type":"object","additionalProperties":{"type":"number"}}},"additionalProperties":true},"trust":{"type":"object","additionalProperties":true},"readiness":{"type":"object","additionalProperties":true},"recentReviews":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ArtifactReview"}},"answerEngine":{"type":"object","required":["preferredCitation","extractionUrls","supportedClaims","claimBoundaries"],"properties":{"preferredCitation":{"type":"string"},"extractionUrls":{"type":"object","additionalProperties":{"type":"string"}},"supportedClaims":{"type":"array","items":{"type":"string"}},"claimBoundaries":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"actions":{"type":"object","additionalProperties":true}},"additionalProperties":true},"CommunitySignals":{"type":"object","required":["schemaVersion","generatedAt","totals","rows","recentReviews","topHelpfulReviews"],"properties":{"schemaVersion":{"const":"hugging-bay.community-signals.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"totals":{"type":"object","required":["reviews","reviewedArtifacts","verifiedRuns","benchmarkEvidence","helpfulCount","reportCount","reportedReviews"],"properties":{"reviewedArtifacts":{"type":"number"}},"additionalProperties":true},"rows":{"type":"array","items":{"type":"object","properties":{"artifact":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ArtifactSummary"},"summary":{"type":"object","additionalProperties":true}},"additionalProperties":true}},"recentReviews":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ArtifactReview"}},"topHelpfulReviews":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ArtifactReview"}}},"additionalProperties":true},"CommunityReviewQueue":{"type":"object","required":["schemaVersion","generatedAt","mode","hosting","totals","rows","agentUse"],"properties":{"schemaVersion":{"const":"hugging-bay.community-review-queue.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"apiUrl":{"type":"string"},"mode":{"type":"string","enum":["first-review","needs-evidence","benchmark"]},"hosting":{"type":"string","enum":["actionable","hosted","reviewable","all"]},"maxReviews":{"type":"number"},"totalCandidates":{"type":"number"},"totals":{"type":"object","additionalProperties":true},"rows":{"type":"array","items":{"type":"object","required":["rank","priority","reviewPriorityScore","missingEvidence","artifact","recommendedReview","urls","actions"],"properties":{"rank":{"type":"number"},"priority":{"type":"string"},"reviewPriorityScore":{"type":"number"},"reason":{"type":"string"},"missingEvidence":{"type":"array","items":{"type":"string"}},"artifact":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ArtifactSummary"},"trust":{"type":"object","additionalProperties":true},"readiness":{"type":"object","additionalProperties":true},"demand":{"type":"object","additionalProperties":true},"hosting":{"type":"object","additionalProperties":true},"reviewState":{"type":"object","additionalProperties":true},"recommendedReview":{"type":"object","additionalProperties":true},"urls":{"type":"object","additionalProperties":{"type":["string","null"]}},"actions":{"type":"object","additionalProperties":true}},"additionalProperties":true}},"agentUse":{"type":"object","additionalProperties":true}},"additionalProperties":true},"CommunityReviewMissions":{"type":"object","required":["schemaVersion","generatedAt","totals","missions","agentUse"],"properties":{"schemaVersion":{"const":"hugging-bay.community-review-missions.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"apiUrl":{"type":"string"},"humanUrl":{"type":"string"},"queueUrl":{"type":"string"},"actionsUrl":{"type":"string"},"auth":{"type":"string"},"rewardModel":{"type":"object","additionalProperties":true},"totals":{"type":"object","additionalProperties":true},"missions":{"type":"array","items":{"type":"object","required":["id","rank","badge","points","artifact","urls","actionTemplate"],"properties":{"id":{"type":"string"},"rank":{"type":"number"},"badge":{"type":"string"},"points":{"type":"number"},"priority":{"type":"string"},"artifact":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ArtifactSummary"},"missingEvidence":{"type":"array","items":{"type":"string"}},"why":{"type":"string"},"prompt":{"type":"string"},"acceptanceCriteria":{"type":"array","items":{"type":"string"}},"urls":{"type":"object","additionalProperties":{"type":["string","null"]}},"actionTemplate":{"type":"object","additionalProperties":true}},"additionalProperties":true}},"agentUse":{"type":"object","additionalProperties":true}},"additionalProperties":true},"CommunityReviewActions":{"type":"object","required":["schemaVersion","generatedAt","submitReview","examples","agentUse"],"properties":{"schemaVersion":{"const":"hugging-bay.community-review-actions.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"queueUrl":{"type":"string"},"humanQueueUrl":{"type":"string"},"schemaUrl":{"type":"string"},"submitReview":{"type":"object","additionalProperties":true},"examples":{"type":"object","additionalProperties":true},"agentUse":{"type":"object","additionalProperties":true}},"additionalProperties":true},"Activation":{"type":"object","required":["schemaVersion","generatedAt","purpose","primaryLoop","tracks","nextBestActions"],"properties":{"schemaVersion":{"const":"hugging-bay.activation.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"humanUrl":{"type":"string"},"purpose":{"type":"string"},"primaryLoop":{"type":"array","items":{"type":"string"}},"tracks":{"type":"array","items":{"type":"object","additionalProperties":true}},"nextBestActions":{"type":"array","items":{"type":"object","additionalProperties":true}},"claimBoundaries":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"HostedLocalModels":{"type":"object","required":["schemaVersion","generatedAt","criteria","filters","stats","rows","agentUse"],"properties":{"schemaVersion":{"const":"hugging-bay.hosted-local-models.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"criteria":{"type":"object","additionalProperties":true},"filters":{"type":"object","additionalProperties":true},"stats":{"type":"object","additionalProperties":true},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}},"pack":{"type":"object","additionalProperties":true},"agentUse":{"type":"object","additionalProperties":true}},"additionalProperties":true},"EvidenceRollups":{"type":"object","required":["schemaVersion","generatedAt","totals","rollups","rows"],"properties":{"schemaVersion":{"const":"hugging-bay.evidence-rollups.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"totals":{"type":"object","required":["evidenceRows","verifiedEvidenceRows","artifactCount"],"additionalProperties":true},"rollups":{"type":"object","properties":{"benchmarks":{"type":"array","items":{"type":"object","additionalProperties":true}},"tools":{"type":"array","items":{"type":"object","additionalProperties":true}},"hardware":{"type":"array","items":{"type":"object","additionalProperties":true}},"artifactTypes":{"type":"array","items":{"type":"object","additionalProperties":true}}},"additionalProperties":true},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}},"caveat":{"type":"string"}},"additionalProperties":true},"CompareArtifacts":{"type":"object","required":["schemaVersion","generatedAt","rows","columns","guidance"],"properties":{"schemaVersion":{"const":"hugging-bay.compare.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"count":{"type":"number"},"missing":{"type":"array","items":{"type":"string"}},"strongest":{"type":"object","additionalProperties":true},"columns":{"type":"array","items":{"type":"string"}},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}},"guidance":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"ResolveArtifact":{"type":"object","required":["schemaVersion","generatedAt","input","normalized","status","actions","guidance"],"properties":{"schemaVersion":{"const":"hugging-bay.resolve.v1"},"generatedAt":{"type":"string"},"input":{"type":"string"},"normalized":{"type":"object","required":["raw","source","repo","supported"],"properties":{"raw":{"type":"string"},"source":{"type":"string"},"repo":{"type":"string"},"owner":{"type":"string"},"name":{"type":"string"},"repoType":{"type":"string"},"kind":{"type":"string"},"supported":{"type":"boolean"},"reason":{"type":"string"}},"additionalProperties":true},"status":{"type":"string","enum":["found","missing","unsupported"]},"artifact":{"anyOf":[{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ArtifactSummary"},{"type":"null"}]},"hostedDownloads":{"type":"object","properties":{"count":{"type":"number"},"rows":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/DownloadableFileRow"}}},"additionalProperties":true},"fallback":{"type":"object","properties":{"searchUrl":{"type":"string"},"rows":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ArtifactSummary"}}},"additionalProperties":true},"actions":{"type":"object","additionalProperties":true},"guidance":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"SourceRequest":{"type":"object","required":["repo"],"properties":{"repo":{"type":"string","description":"Full upstream URL or owner/name reference."},"source":{"type":"string","enum":["huggingface","modelscope","github","zenodo","arxiv"]},"useCase":{"type":"string","maxLength":500},"targetTool":{"type":"string","maxLength":120},"desiredFiles":{"type":"array","items":{"type":"string"},"maxItems":20},"contact":{"type":"string","maxLength":240,"description":"Private operator-only contact hint. Never returned in public status responses."}},"additionalProperties":true},"SourceRequestStatus":{"type":"object","required":["schemaVersion","generatedAt","id","status","request","actions","guidance"],"properties":{"schemaVersion":{"const":"hugging-bay.source-request-status.v1"},"generatedAt":{"type":"string"},"id":{"type":"string"},"status":{"type":"string"},"created":{"type":"boolean"},"newRequest":{"type":"boolean"},"indexed":{"type":"boolean"},"request":{"type":"object","required":["source","repo","requestCount"],"properties":{"source":{"type":"string"},"repo":{"type":"string"},"repoType":{"type":"string"},"requestCount":{"type":"number"},"firstRequestedAt":{"type":"string"},"lastRequestedAt":{"type":"string"}},"additionalProperties":true},"artifact":{"anyOf":[{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ArtifactSummary"},{"type":"null"}]},"actions":{"type":"object","additionalProperties":true},"guidance":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"FilePreview":{"type":"object","required":["schemaVersion","artifactId","repo","filePath","renderHint","text","truncated"],"properties":{"schemaVersion":{"const":"hugging-bay.file-preview.v1"},"generatedAt":{"type":"string"},"artifactId":{"type":"string"},"repo":{"type":"string"},"filePath":{"type":"string"},"format":{"type":"string"},"contentType":{"type":"string"},"sizeBytes":{"type":"number"},"bytesRead":{"type":"number"},"truncated":{"type":"boolean"},"renderHint":{"type":"string","enum":["markdown","json","jsonl","csv","tsv","yaml","toml","text"]},"sha256":{"type":"string"},"text":{"type":"string"},"columns":{"type":"array","items":{"type":"string"}},"rows":{"type":"array","items":{}},"urls":{"type":"object","additionalProperties":true}},"additionalProperties":true},"DownloadableFileRow":{"type":"object","required":["artifactId","visibility","repo","filePath","sha256","sourceKind","downloadUrl","manifestUrl"],"properties":{"artifactId":{"type":"string"},"visibility":{"type":"string","enum":["public"]},"owner":{"type":"string"},"name":{"type":"string"},"repo":{"type":"string"},"type":{"type":"string"},"license":{"type":"string"},"summary":{"type":"string"},"filePath":{"type":"string"},"format":{"type":"string"},"risk":{"type":"string"},"sizeBytes":{"type":"number"},"storageSizeBytes":{"type":"number"},"sha256":{"type":"string"},"sourceKind":{"type":"string"},"storageProvider":{"type":"string"},"hostingStatus":{"type":"string"},"downloadUrl":{"type":"string"},"manifestUrl":{"type":"string"},"manifestKeyUrl":{"type":"string"},"peerFallbacks":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ReviewedPeerFallback"}},"trust":{"type":"object","properties":{"verified":{"type":"boolean"},"hashAlgorithm":{"type":"string"},"manifestRequired":{"type":"boolean"},"directDownloadTrustBoundary":{"type":"string"}},"additionalProperties":true},"tools":{"type":"array","items":{"type":"string"}},"updatedAt":{"type":"string"}},"additionalProperties":true},"DownloadableFilesResponse":{"type":"object","required":["stats","rows","generatedAt"],"properties":{"stats":{"type":"object","required":["hostedArtifacts","hostedFiles","hostedBytes"],"additionalProperties":true},"pack":{"type":["object","null"],"properties":{"slug":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"artifactCount":{"type":"number"},"hostedArtifacts":{"type":"number"},"downloadableFilesUrl":{"type":"string"}},"additionalProperties":true},"rows":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/DownloadableFileRow"}},"candidateRows":{"type":"array","items":{"type":"object","additionalProperties":true}},"candidateStats":{"type":"object","additionalProperties":true},"downloadableVerificationRequired":{"type":"boolean"},"generatedAt":{"type":"string"}},"additionalProperties":true},"UseCaseRecommendationRow":{"type":"object","required":["id","repo","type","license","fitScore","fitReasons","recommendedAction","actionLabel","urls"],"properties":{"id":{"type":"string"},"repo":{"type":"string"},"type":{"type":"string"},"license":{"type":"string"},"summary":{"type":"string"},"hostingStatus":{"type":"string"},"hostedFileCount":{"type":"number"},"downloadCount":{"type":"number"},"fitScore":{"type":"number"},"fitReasons":{"type":"array","items":{"type":"string"}},"recommendedAction":{"type":"string"},"actionLabel":{"type":"string"},"urls":{"type":"object","additionalProperties":true}},"additionalProperties":true},"UseCaseRecommender":{"type":"object","required":["schemaVersion","generatedAt","useCase","profile","search","rows","guidance"],"properties":{"schemaVersion":{"const":"hugging-bay.use-case-recommender.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"input":{"type":"string"},"useCase":{"type":"string"},"profile":{"type":"object","additionalProperties":true},"search":{"type":"object","additionalProperties":true},"rows":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/UseCaseRecommendationRow"}},"suggestedUseCases":{"type":"array","items":{"type":"object","additionalProperties":true}},"guidance":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"MirrorPackSummary":{"type":"object","required":["slug","title","description","artifactCount","hostedArtifacts"],"properties":{"slug":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"artifactCount":{"type":"number"},"hostedArtifacts":{"type":"number"}},"additionalProperties":true},"MirrorPackDetail":{"type":"object","required":["slug","title","description","artifactCount","hostedArtifacts","rows"],"properties":{"slug":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"artifactCount":{"type":"number"},"hostedArtifacts":{"type":"number"},"rows":{"type":"array","items":{"type":"object","required":["id","repo","type","license","hostedFiles","hostingStatus"],"additionalProperties":true}},"generatedAt":{"type":"string"}},"additionalProperties":true},"MirrorDemandRow":{"type":"object","required":["id","repo","type","license","status","eligible","requestCount","tractionScore"],"properties":{"id":{"type":"string"},"repo":{"type":"string"},"type":{"type":"string"},"license":{"type":"string"},"status":{"type":"string"},"eligible":{"type":"boolean"},"requestCount":{"type":"number"},"smallSafeFiles":{"type":"number"},"smallSafeBytes":{"type":"number"},"usefulFiles":{"type":"number"},"usefulBytes":{"type":"number"},"usefulFileScore":{"type":"number"},"runtimeFileCount":{"type":"number"},"supportFileCount":{"type":"number"},"largeSkipped":{"type":"number"},"autoMirrorReady":{"type":"boolean"},"worksWith":{"type":"array","items":{"type":"string"}},"downloads":{"type":"number"},"stars":{"type":"number"},"tractionScore":{"type":"number"},"mirrorTier":{"type":"string"},"reviewStatus":{"type":"string"},"reviewReason":{"type":"string"},"why":{"type":"array","items":{"type":"string"}},"riskFlags":{"type":"array","items":{"type":"string"}},"topicSlugs":{"type":"array","items":{"type":"string"}},"completedAction":{"anyOf":[{"type":"null"},{"type":"object","properties":{"label":{"type":"string"},"status":{"type":"string"},"hostedFiles":{"type":"number"},"downloadPageUrl":{"type":"string"},"downloadableFilesUrl":{"type":"string"},"manifestUrl":{"type":"string"}},"additionalProperties":true}]},"readiness":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/MirrorReadiness"}},"additionalProperties":true},"MirrorRequestStatus":{"type":"object","required":["schemaVersion","requestId","status","storedStatus","terminalDecision","canonicalState","outcomes"],"properties":{"schemaVersion":{"const":"hugging-bay.mirror-request-status.v1"},"requestId":{"type":"string"},"status":{"type":"string","enum":["requested","partial","blocked","completed","quarantined","rejected"]},"storedStatus":{"type":"string"},"terminalDecision":{"type":["object","null"],"required":["auditId","commandId","transitionEventId","decisionKind","auditDigest"],"additionalProperties":false,"properties":{"auditId":{"type":"string","pattern":"^mirror-request-terminal-[a-f0-9]{32}$"},"commandId":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{7,127}$"},"transitionEventId":{"type":"string","pattern":"^mirror-request-terminal-transition-[a-f0-9]{32}$"},"decisionKind":{"type":"string","enum":["blocked","completed","quarantined","rejected"]},"auditDigest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"}}},"canonicalState":{"type":"object","additionalProperties":true},"outcomes":{"type":"object","required":["mirrorComplete","usable","successfulRun","successfulRunEvidence"],"additionalProperties":false,"properties":{"mirrorComplete":{"type":"boolean","description":"True only for a matching audited completed mirror-request transition."},"usable":{"type":"boolean","description":"Canonical artifact completeness, verification, execution readiness, and download readiness are unavailable during containment."},"successfulRun":{"type":["boolean","null"],"description":"Null when this request-status surface has not evaluated accepted-run evidence."},"successfulRunEvidence":{"type":"string","enum":["not-evaluated-by-request-status"]}}}},"additionalProperties":true},"MirrorNode":{"type":"object","required":["id","name","region","endpoint","health","publicOnly","freshnessMinutes","artifactCount","bandwidthTb"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"region":{"type":"string"},"endpoint":{"type":"string","format":"uri"},"health":{"type":"string","enum":["healthy","stale","degraded","quarantined"]},"publicOnly":{"type":"boolean"},"freshnessMinutes":{"type":"number"},"artifactCount":{"type":"number"},"bandwidthTb":{"type":"number"}},"additionalProperties":true},"MirrorReadiness":{"type":"object","required":["score","level","action","recommendedFiles","blockers"],"properties":{"score":{"type":"number"},"level":{"type":"string","enum":["unknown","hosted","ready","reviewable","blocked","needs-detail"]},"action":{"type":"string"},"worksWith":{"type":"array","items":{"type":"string"}},"toolUse":{"type":"array","items":{"type":"object","additionalProperties":true}},"safeFormats":{"type":"array","items":{"type":"string"}},"recommendedFiles":{"type":"array","items":{"type":"object","additionalProperties":true}},"blockers":{"type":"array","items":{"type":"string"}},"positives":{"type":"array","items":{"type":"string"}},"autoMirrorReady":{"type":"boolean"},"runtimeFileCount":{"type":"number"},"supportFileCount":{"type":"number"},"usefulFiles":{"type":"number"},"usefulBytes":{"type":"number"},"usefulFileScore":{"type":"number"},"largeSkipped":{"type":"number"},"hostedFiles":{"type":"number"},"externalFiles":{"type":"number"},"totalFiles":{"type":"number"},"limits":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/MirrorLimits"},"selectedMirrorCommand":{"type":"string"}},"additionalProperties":true},"MirrorReadinessResponse":{"type":"object","required":["schemaVersion","generatedAt","summary","rows"],"properties":{"schemaVersion":{"const":"hugging-bay.mirror-readiness.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"summary":{"type":"object","additionalProperties":true},"policy":{"type":"object","additionalProperties":true},"rows":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/MirrorDemandRow"}},"agentUse":{"type":"object","additionalProperties":true}},"additionalProperties":true},"MirrorScalePlan":{"type":"object","required":["schemaVersion","generatedAt","summary","rows","policy"],"properties":{"schemaVersion":{"const":"hugging-bay.mirror-scale-plan.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"input":{"type":"object","additionalProperties":true},"summary":{"type":"object","additionalProperties":true},"storage":{"type":"object","additionalProperties":true},"policy":{"type":"object","additionalProperties":true},"commands":{"type":"object","additionalProperties":true},"rows":{"type":"array","items":{"allOf":[{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/MirrorDemandRow"},{"type":"object","properties":{"candidateBytes":{"type":"number"},"candidateFileCount":{"type":"number"},"supportOnly":{"type":"boolean"},"requiresReview":{"type":"boolean"},"runtimeFilesIncluded":{"type":"boolean"},"requiresRiskOverride":{"type":"boolean"},"reviewedRiskyWeightFiles":{"type":"number"}},"additionalProperties":true}]}},"blockedSample":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/MirrorDemandRow"}},"agentUse":{"type":"object","additionalProperties":true}},"additionalProperties":true},"MirrorBatch":{"type":"object","required":["schemaVersion","id","status","rows","summary","createdAt"],"properties":{"schemaVersion":{"const":"hugging-bay.mirror-batch.v1"},"id":{"type":"string"},"status":{"type":"string","enum":["planned","approved","running","completed","completed_with_errors","failed","blocked"]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"approvedAt":{"type":"string"},"completedAt":{"type":"string"},"failedAt":{"type":"string"},"createdBy":{"type":"string"},"approvedBy":{"type":"string"},"summary":{"type":"object","additionalProperties":true},"input":{"type":"object","additionalProperties":true},"policy":{"type":"object","additionalProperties":true},"commands":{"type":"object","additionalProperties":true},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}},"actionLog":{"type":"array","items":{"type":"string"}},"recovery":{"type":"object","additionalProperties":true},"lastError":{"type":"string"}},"additionalProperties":true},"MirrorBatchList":{"type":"object","required":["schemaVersion","generatedAt","rows"],"properties":{"schemaVersion":{"const":"hugging-bay.mirror-batches.v1"},"generatedAt":{"type":"string"},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"additionalProperties":true},"MirrorSweepStatus":{"type":"object","required":["schemaVersion","generatedAt","schedule","summary"],"properties":{"schemaVersion":{"const":"hugging-bay.mirror-sweep-status.v1"},"generatedAt":{"type":"string"},"schedule":{"type":"object","additionalProperties":true},"summary":{"type":"object","additionalProperties":true},"latestBatches":{"type":"array","items":{"type":"object","additionalProperties":true}},"recoverable":{"type":"array","items":{"type":"object","additionalProperties":true}},"planPreview":{"type":"object","additionalProperties":true},"actions":{"type":"object","additionalProperties":true},"operatorGuidance":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"ReviewedMirrorSweepRun":{"type":"object","required":["schemaVersion","startedAt","status","input","safety"],"properties":{"schemaVersion":{"const":"hugging-bay.reviewed-mirror-sweep-run.v1"},"startedAt":{"type":"string"},"completedAt":{"type":["string","null"]},"actor":{"type":"string"},"status":{"type":"string"},"input":{"type":"object","additionalProperties":true},"safety":{"type":"object","additionalProperties":true},"plan":{"type":"object","additionalProperties":true},"batch":{"type":"object","additionalProperties":true},"approval":{"type":"object","additionalProperties":true},"run":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/MirrorBatchRun"},"urls":{"type":"object","additionalProperties":true},"next":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"AdminOperationsInbox":{"type":"object","required":["schemaVersion","generatedAt","summary","items","sourceDocuments","actions"],"properties":{"schemaVersion":{"const":"hugging-bay.admin-operations-inbox.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"summary":{"type":"object","required":["totalItems","critical","high","medium"],"additionalProperties":true},"items":{"type":"array","items":{"type":"object","required":["id","kind","priority","priorityScore","title"],"properties":{"id":{"type":"string"},"kind":{"type":"string"},"priority":{"type":"string","enum":["critical","high","medium","low"]},"priorityScore":{"type":"number"},"status":{"type":"string"},"title":{"type":"string"},"detail":{"type":"string"},"repo":{"type":"string"},"artifactId":{"type":"string"},"actionUrl":{"type":"string"},"apiUrl":{"type":"string"},"command":{"type":"string"},"metadata":{"type":"object","additionalProperties":true}},"additionalProperties":true}},"sourceDocuments":{"type":"object","additionalProperties":{"type":"string"}},"actions":{"type":"object","additionalProperties":{"type":"string"}},"operatorGuidance":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"AdminPeerFallbackQueue":{"type":"object","required":["schemaVersion","generatedAt","summary","rows","actions"],"properties":{"schemaVersion":{"const":"hugging-bay.admin-peer-fallback-queue.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"input":{"type":"object","additionalProperties":true},"summary":{"type":"object","additionalProperties":true},"rows":{"type":"array","items":{"type":"object","required":["id","artifactId","repo","status"],"properties":{"id":{"type":"string"},"artifactId":{"type":"string"},"repo":{"type":"string"},"status":{"type":"string"},"submittedAt":{"type":"string"},"sourceUrl":{"type":"string"},"infoHash":{"type":"string"},"fileScopes":{"type":"array","items":{"type":"string"}},"readiness":{"type":"object","additionalProperties":true},"urls":{"type":"object","additionalProperties":{"type":"string"}},"reviewBodies":{"type":"object","additionalProperties":true},"commands":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":true}},"actions":{"type":"object","additionalProperties":{"type":"string"}},"operatorGuidance":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"MirrorBatchRun":{"type":"object","required":["schemaVersion","batchId","dryRun","summary","results"],"properties":{"schemaVersion":{"const":"hugging-bay.mirror-batch-run.v1"},"batchId":{"type":"string"},"dryRun":{"type":"boolean"},"status":{"type":"string"},"summary":{"type":"object","additionalProperties":true},"results":{"type":"array","items":{"type":"object","additionalProperties":true}}},"additionalProperties":true},"BrowserExtensionRelease":{"type":"object","required":["schemaVersion","status","installationAvailable","verificationState","reason","guidance","inspection"],"properties":{"schemaVersion":{"const":"hugging-bay.browser-extension-release.v2"},"generatedAt":{"type":"string"},"status":{"const":"not-served"},"installationAvailable":{"const":false},"verificationState":{"const":"unknown"},"reason":{"const":"public_extension_not_served"},"guidance":{"type":"string"},"inspection":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":false},"BrowserExtensionInstall":{"type":"object","required":["schemaVersion","status","installationAvailable","verificationState","reason","guidance","inspection"],"properties":{"schemaVersion":{"const":"hugging-bay.browser-extension-install.v2"},"generatedAt":{"type":"string"},"status":{"const":"not-served"},"installationAvailable":{"const":false},"verificationState":{"const":"unknown"},"reason":{"const":"public_extension_not_served"},"guidance":{"type":"string"},"inspection":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":false},"BrowserExtensionStoreKit":{"type":"object","required":["schemaVersion","status","installationAvailable","verificationState","reason","guidance","inspection"],"properties":{"schemaVersion":{"const":"hugging-bay.browser-extension-store-kit.v2"},"generatedAt":{"type":"string"},"status":{"const":"not-served"},"installationAvailable":{"const":false},"verificationState":{"const":"unknown"},"reason":{"const":"public_extension_not_served"},"guidance":{"type":"string"},"inspection":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":false},"PythonSdkRelease":{"type":"object","required":["schemaVersion","name","version","runtime","install","files","capabilities","agentUse"],"properties":{"schemaVersion":{"const":"hugging-bay.python-sdk-release.v1"},"generatedAt":{"type":"string"},"name":{"type":"string"},"version":{"type":"string"},"runtime":{"type":"string"},"dependencies":{"type":"array","items":{"type":"string"}},"install":{"type":"object","additionalProperties":true},"files":{"type":"array","items":{"type":"object","additionalProperties":true}},"capabilities":{"type":"object","additionalProperties":true},"agentUse":{"type":"object","additionalProperties":true}},"additionalProperties":true},"UploadedSourceFile":{"type":"object","required":["path","sizeBytes","contentType","contentBase64"],"properties":{"path":{"type":"string"},"sizeBytes":{"type":"number"},"contentType":{"type":"string"},"contentBase64":{"type":"string","description":"Strict base64 file payload. Placeholder values are rejected."}},"additionalProperties":false},"PublishDraft":{"type":"object","required":["owner","name","type","summary","sourceUrl","license","visibility","provenance"],"properties":{"owner":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"summary":{"type":"string"},"description":{"type":"string"},"sourceUrl":{"type":"string"},"license":{"type":"string"},"visibility":{"type":"string","enum":["public","private","gated"]},"tags":{"type":"string"},"task":{"type":"string"},"framework":{"type":"string"},"sizeGb":{"type":"string"},"provenance":{"type":"string"},"sourceFiles":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/UploadedSourceFile"}},"largeUploadManifestId":{"type":"string","description":"Completed upload session id for large releases. Mutually exclusive with sourceFiles."}},"additionalProperties":true},"PublisherApplication":{"type":"object","required":["namespace","displayName","contact","sourceUrl","artifactTypes","intendedUse","provenancePlan","acceptedTerms"],"properties":{"namespace":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{2,39}$"},"displayName":{"type":"string","minLength":2,"maxLength":120},"contact":{"type":"string","minLength":5,"maxLength":160},"website":{"type":"string","pattern":"^(https://|$)","maxLength":240},"sourceUrl":{"type":"string","pattern":"^https://"},"artifactTypes":{"type":"array","minItems":1,"items":{"type":"string","enum":["llm","embedding","audio","vision","agent","dataset","app","tool","eval"]}},"intendedUse":{"type":"string","minLength":30,"maxLength":1200},"provenancePlan":{"type":"string","minLength":30,"maxLength":1200},"expectedUploads":{"type":"string","maxLength":400},"acceptedTerms":{"const":true}},"additionalProperties":false},"PublisherKeyIssue":{"type":"object","required":["schemaVersion","case","principal","apiKey","next"],"properties":{"schemaVersion":{"const":"hugging-bay.publisher-key-issue.v1"},"generatedAt":{"type":"string"},"case":{"type":"object","additionalProperties":true},"principal":{"type":"object","required":["id","role","allowedOwners"],"properties":{"id":{"type":"string"},"role":{"type":"string","enum":["publisher"]},"displayName":{"type":"string"},"allowedOwners":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"apiKey":{"type":"object","required":["id","principalId","role","allowedOwners","tokenPrefix","token"],"properties":{"id":{"type":"string"},"principalId":{"type":"string"},"role":{"type":"string","enum":["publisher"]},"displayName":{"type":"string"},"allowedOwners":{"type":"array","items":{"type":"string"}},"status":{"type":"string"},"tokenPrefix":{"type":"string"},"token":{"type":"string","description":"One-time plaintext publisher token. Stored server-side only as a hash."},"warning":{"type":"string"}},"additionalProperties":true},"next":{"type":"object","additionalProperties":true}},"additionalProperties":true},"PublisherApiKey":{"type":"object","required":["id","principalId","role","allowedOwners","status","tokenPrefix","createdAt"],"properties":{"id":{"type":"string"},"principalId":{"type":"string"},"role":{"type":"string","enum":["publisher"]},"displayName":{"type":"string"},"allowedOwners":{"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["active","revoked"]},"tokenPrefix":{"type":"string"},"createdAt":{"type":"string"},"revokedAt":{"type":"string"},"purpose":{"type":"string"}},"additionalProperties":true},"PublisherApiKeysResponse":{"type":"object","required":["schemaVersion","generatedAt","principal","rows","stats","actions"],"properties":{"schemaVersion":{"const":"hugging-bay.publisher-api-keys.v1"},"generatedAt":{"type":"string"},"principal":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/Principal"},"rows":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/PublisherApiKey"}},"stats":{"type":"object","additionalProperties":true},"actions":{"type":"object","additionalProperties":true}},"additionalProperties":true},"PublisherApiKeyIssue":{"type":"object","required":["schemaVersion","generatedAt","principal","apiKey","next"],"properties":{"schemaVersion":{"const":"hugging-bay.publisher-api-key-issue.v1"},"generatedAt":{"type":"string"},"principal":{"type":"object","additionalProperties":true},"apiKey":{"type":"object","required":["id","principalId","role","allowedOwners","status","tokenPrefix","createdAt","token"],"properties":{"id":{"type":"string"},"principalId":{"type":"string"},"role":{"type":"string","enum":["publisher"]},"displayName":{"type":"string"},"allowedOwners":{"type":"array","items":{"type":"string"}},"status":{"type":"string"},"tokenPrefix":{"type":"string"},"createdAt":{"type":"string"},"purpose":{"type":"string"},"token":{"type":"string","description":"One-time plaintext publisher token. Stored server-side only as a hash."},"warning":{"type":"string"}},"additionalProperties":true},"next":{"type":"object","additionalProperties":true},"policy":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"PublisherApiKeyRevocation":{"type":"object","required":["schemaVersion","generatedAt","apiKey","actions"],"properties":{"schemaVersion":{"const":"hugging-bay.publisher-api-key-revocation.v1"},"generatedAt":{"type":"string"},"apiKey":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/PublisherApiKey"},"actions":{"type":"object","additionalProperties":true}},"additionalProperties":true},"ReaderApiKey":{"type":"object","required":["id","principalId","role","status","tokenPrefix","createdAt"],"properties":{"id":{"type":"string"},"principalId":{"type":"string"},"role":{"type":"string","enum":["reader"]},"displayName":{"type":"string"},"allowedOwners":{"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["active","revoked"]},"tokenPrefix":{"type":"string"},"createdAt":{"type":"string"},"revokedAt":{"type":"string"},"purpose":{"type":"string"}},"additionalProperties":true},"ReaderApiKeysResponse":{"type":"object","required":["schemaVersion","generatedAt","principal","rows","stats","actions"],"properties":{"schemaVersion":{"const":"hugging-bay.reader-api-keys.v1"},"generatedAt":{"type":"string"},"principal":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/Principal"},"rows":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ReaderApiKey"}},"stats":{"type":"object","additionalProperties":true},"actions":{"type":"object","additionalProperties":true},"policy":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"ReaderRecoveryKit":{"type":"object","required":["schemaVersion","generatedAt","principal","summary","recoverySteps","endpoints","copyPaste","policy"],"properties":{"schemaVersion":{"const":"hugging-bay.reader-recovery-kit.v1"},"generatedAt":{"type":"string"},"principal":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/Principal"},"summary":{"type":"object","required":["savedArtifacts","savedSearches","readerTokens","activeReaderTokens"],"additionalProperties":true},"recoverySteps":{"type":"array","items":{"type":"string"}},"endpoints":{"type":"object","additionalProperties":{"type":"string"}},"copyPaste":{"type":"object","additionalProperties":{"type":"string"}},"browserExtension":{"type":"object","additionalProperties":true},"policy":{"type":"object","additionalProperties":true}},"additionalProperties":true},"ReaderApiKeyRevocation":{"type":"object","required":["schemaVersion","generatedAt","apiKey","actions"],"properties":{"schemaVersion":{"const":"hugging-bay.reader-api-key-revocation.v1"},"generatedAt":{"type":"string"},"apiKey":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ReaderApiKey"},"actions":{"type":"object","additionalProperties":true}},"additionalProperties":true},"PublisherApplicationStatus":{"type":"object","required":["schemaVersion","generatedAt","case","namespace","status","claimStatus","tokenIssued","next"],"properties":{"schemaVersion":{"const":"hugging-bay.publisher-application-status.v1"},"generatedAt":{"type":"string"},"case":{"type":"object","additionalProperties":true},"namespace":{"type":"string"},"status":{"type":"string"},"claimStatus":{"type":"string"},"tokenIssued":{"type":"boolean"},"next":{"type":"object","additionalProperties":true}},"additionalProperties":true},"PublisherWorkflow":{"type":"object","required":["schemaVersion","generatedAt","baseUrl","access","apiFlow","cliFlow","mcpTools","draftRequirements","safety"],"properties":{"schemaVersion":{"const":"hugging-bay.publisher-workflow.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"access":{"type":"object","additionalProperties":true},"apiFlow":{"type":"array","items":{"type":"object","additionalProperties":true}},"cliFlow":{"type":"array","items":{"type":"string"}},"mcpTools":{"type":"array","items":{"type":"string"}},"draftRequirements":{"type":"array","items":{"type":"string"}},"safety":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"PublisherLaunchKit":{"type":"object","required":["schemaVersion","generatedAt","baseUrl","title","description","humanUrl","apiUrl","requiredFlow","manifestRequirements","reviewedFallbackPolicy"],"properties":{"schemaVersion":{"const":"hugging-bay.publisher-launch-kit.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"humanUrl":{"type":"string"},"apiUrl":{"type":"string"},"workflowUrl":{"type":"string"},"releaseTemplateUrl":{"type":"string"},"releaseTemplateApi":{"type":"string"},"launchThesis":{"type":"string"},"requiredFlow":{"type":"array","items":{"type":"object","additionalProperties":true}},"manifestRequirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"crossSourceProvenance":{"type":"array","items":{"type":"object","additionalProperties":true}},"reputationBadges":{"type":"array","items":{"type":"object","additionalProperties":true}},"sameAsUpstreamChecks":{"type":"array","items":{"type":"string"}},"reviewedFallbackPolicy":{"type":"object","additionalProperties":true},"launchPageContract":{"type":"object","additionalProperties":true},"priorityReleaseTargets":{"type":"array","items":{"type":"string"}},"cliFlow":{"type":"array","items":{"type":"string"}},"citationTargets":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"PublisherReleaseTemplate":{"type":"object","required":["schemaVersion","generatedAt","baseUrl","kind","title","description","humanUrl","apiUrl","draft","validationChecklist","commands"],"properties":{"schemaVersion":{"const":"hugging-bay.publisher-release-template.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"kind":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"humanUrl":{"type":"string"},"apiUrl":{"type":"string"},"launchKitUrl":{"type":"string"},"workflowUrl":{"type":"string"},"draft":{"type":"object","additionalProperties":true},"largeUploadSessionBody":{"type":"object","additionalProperties":true},"validationChecklist":{"type":"array","items":{"type":"string"}},"commands":{"type":"object","additionalProperties":{"type":"string"}},"labValue":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"UploadSessionFile":{"type":"object","required":["path","sizeBytes","sha256"],"properties":{"path":{"type":"string"},"sizeBytes":{"type":"number"},"sha256":{"type":"string"},"contentType":{"type":"string"},"storageKey":{"type":"string"},"status":{"type":"string","enum":["waiting","uploaded","missing","mismatch","verified"]},"storageSizeBytes":{"type":"number"},"observedAt":{"type":"string"},"verifiedAt":{"type":"string"},"upload":{"type":"object","additionalProperties":true},"uploaded":{"type":"boolean"}},"additionalProperties":true},"UploadSession":{"type":"object","required":["schemaVersion","id","owner","name","status","files","draftPatch"],"properties":{"schemaVersion":{"const":"hugging-bay.upload-session.v1"},"id":{"type":"string"},"owner":{"type":"string"},"name":{"type":"string"},"status":{"type":"string","enum":["created","pending","completed","canceled","expired"]},"storageProvider":{"type":"string"},"createdAt":{"type":"string"},"expiresAt":{"type":"string"},"completedAt":{"type":["string","null"]},"files":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/UploadSessionFile"}},"progress":{"type":"object","required":["filesTotal","filesUploaded","bytesTotal","bytesUploaded","percent","readyToComplete","missingFiles","mismatchFiles"],"properties":{"filesTotal":{"type":"number"},"filesUploaded":{"type":"number"},"bytesTotal":{"type":"number"},"bytesUploaded":{"type":"number"},"percent":{"type":"number"},"readyToComplete":{"type":"boolean"},"missingFiles":{"type":"array","items":{"type":"string"}},"mismatchFiles":{"type":"array","items":{"type":"object","additionalProperties":true}},"expiresAt":{"type":["string","null"]},"expired":{"type":"boolean"}},"additionalProperties":true},"draftPatch":{"type":"object","additionalProperties":true},"links":{"type":"object","additionalProperties":true},"urls":{"type":"object","additionalProperties":true}},"additionalProperties":true},"PublisherDashboard":{"type":"object","required":["schemaVersion","generatedAt","principal","stats","artifacts","uploadSessions","releaseBlockers","actions"],"properties":{"schemaVersion":{"const":"hugging-bay.publisher-dashboard.v1"},"generatedAt":{"type":"string"},"principal":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/Principal"},"stats":{"type":"object","required":["artifacts","publicArtifacts","draftArtifacts","hostedFiles","uploadSessions","openUploadSessions","releaseBlockers"],"properties":{"artifacts":{"type":"number"},"publicArtifacts":{"type":"number"},"draftArtifacts":{"type":"number"},"privateArtifacts":{"type":"number"},"gatedArtifacts":{"type":"number"},"hostedFiles":{"type":"number"},"uploadSessions":{"type":"number"},"openUploadSessions":{"type":"number"},"releaseBlockers":{"type":"number"},"downloads":{"type":"number"},"stars":{"type":"number"},"mirrorRequests":{"type":"number"},"reviewedArtifacts":{"type":"number"},"hostedArtifacts":{"type":"number"},"averageCardCompleteness":{"type":"number"}},"additionalProperties":true},"audience":{"type":"object","properties":{"totals":{"type":"object","additionalProperties":true},"topReleases":{"type":"array","items":{"type":"object","additionalProperties":true}},"attentionRows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"additionalProperties":true},"artifacts":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ArtifactSummary"}},"uploadSessions":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/UploadSession"}},"releaseBlockers":{"type":"array","items":{"type":"object","required":["id","repo","visibility","scanStatus","verificationStatus"],"properties":{"id":{"type":"string"},"repo":{"type":"string"},"visibility":{"type":"string"},"scanStatus":{"type":"string"},"verificationStatus":{"type":"string"},"hostedFileCount":{"type":"number"}},"additionalProperties":true}},"actions":{"type":"object","properties":{"submit":{"type":"string"},"createArtifact":{"type":"string"},"createUploadSession":{"type":"string"},"publisherWorkflow":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true},"PublisherArtifactsResponse":{"type":"object","required":["schemaVersion","rows"],"properties":{"schemaVersion":{"const":"hugging-bay.publisher-artifacts.v1"},"rows":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ArtifactSummary"}}},"additionalProperties":true},"PublisherSummary":{"type":"object","required":["namespace","displayName","claimStatus","stats","links"],"properties":{"namespace":{"type":"string"},"displayName":{"type":"string"},"claimed":{"type":"boolean"},"claimStatus":{"type":"string","enum":["verified","pending-review","unclaimed","rejected","revoked"]},"applicationStatus":{"type":["string","null"]},"stats":{"type":"object","required":["artifacts","hostedFiles","downloads"],"properties":{"artifacts":{"type":"number"},"publicArtifacts":{"type":"number"},"gatedArtifacts":{"type":"number"},"hostedArtifacts":{"type":"number"},"hostedFiles":{"type":"number"},"externalFiles":{"type":"number"},"totalFiles":{"type":"number"},"downloads":{"type":"number"},"stars":{"type":"number"},"updatedAt":{"type":"string"}},"additionalProperties":true},"topArtifact":{"anyOf":[{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ArtifactSummary"},{"type":"null"}]},"topTypes":{"type":"array","items":{"type":"object","additionalProperties":true}},"topLicenses":{"type":"array","items":{"type":"object","additionalProperties":true}},"sourceCounts":{"type":"array","items":{"type":"object","additionalProperties":true}},"worksWith":{"type":"array","items":{"type":"string"}},"reputation":{"type":"object","properties":{"score":{"type":"number"},"level":{"type":"string"},"label":{"type":"string"},"badges":{"type":"array","items":{"type":"object","additionalProperties":true}},"nextBestActions":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"links":{"type":"object","additionalProperties":true}},"additionalProperties":true},"PublisherIndex":{"type":"object","required":["schemaVersion","generatedAt","total","rows"],"properties":{"schemaVersion":{"const":"hugging-bay.publisher-index.v1"},"generatedAt":{"type":"string"},"total":{"type":"number"},"rows":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/PublisherSummary"}},"links":{"type":"object","additionalProperties":true},"degraded":{"type":"boolean","description":"True only when the response uses the curated public seed fallback rather than current PostgreSQL publisher authority."},"note":{"type":"string"}},"additionalProperties":true},"PublisherProfile":{"allOf":[{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/PublisherSummary"},{"type":"object","required":["schemaVersion","generatedAt","artifacts","guidance"],"properties":{"schemaVersion":{"const":"hugging-bay.publisher-profile.v1"},"generatedAt":{"type":"string"},"artifacts":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ArtifactSummary"}},"guidance":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}]},"UploadSessionListResponse":{"type":"object","required":["schemaVersion","rows"],"properties":{"schemaVersion":{"const":"hugging-bay.upload-sessions.v1"},"rows":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/UploadSession"}}},"additionalProperties":true},"TrafficSummary":{"type":"object","required":["schemaVersion","generatedAt","available","windows"],"properties":{"schemaVersion":{"const":"hugging-bay.traffic-summary.v1"},"generatedAt":{"type":"string"},"persistence":{"type":"string"},"available":{"type":"boolean"},"reason":{"type":"string"},"instrumentation":{"type":"object","additionalProperties":true},"windows":{"type":"array","description":"Each window's downloads block reports downloadsInitiated (initiation events; the truthful primary download metric), bytesSent as app-streamed bytes only, and bytesAuthorized as signed-URL object bytes with bytesAuthorizedStatus=authorized-not-confirmed. Authorization does not prove transfer, completion, or GCS egress; repeated and range redirects can authorize the same object more than once. Per-artifact topDownloads rows carry the same provenance fields.","items":{"type":"object","additionalProperties":true}}},"additionalProperties":true},"AiSearchGuidance":{"type":"object","required":["schemaVersion","generatedAt","name","canonicalUrl","apiUrl","wellKnownUrl","positioning","whenToCite","claimBoundaries","assistantEntrypoints","apiRecipes"],"properties":{"schemaVersion":{"const":"hugging-bay.ai-search.v1"},"generatedAt":{"type":"string"},"name":{"type":"string"},"canonicalUrl":{"type":"string"},"apiUrl":{"type":"string"},"wellKnownUrl":{"type":"string"},"positioning":{"type":"object","additionalProperties":true},"targetAssistants":{"type":"array","items":{"type":"string"}},"whenToCite":{"type":"array","items":{"type":"string"}},"claimBoundaries":{"type":"array","items":{"type":"string"}},"assistantEntrypoints":{"type":"object","additionalProperties":true},"answerTargets":{"type":"array","items":{"type":"object","additionalProperties":true}},"apiRecipes":{"type":"array","items":{"type":"object","additionalProperties":true}},"highIntentQueries":{"type":"array","items":{"type":"string"}},"structuredData":{"type":"object","additionalProperties":true},"recommendedCrawlOrder":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"AgentRecommendationKit":{"type":"object","required":["schemaVersion","generatedAt","name","canonicalUrl","apiUrl","purpose","containment","claimBoundaries","integrationSnippets","crawlChecklist","highLeverageEntrypoints"],"properties":{"schemaVersion":{"const":"hugging-bay.agent-recommendation-kit.v1"},"generatedAt":{"type":"string"},"name":{"type":"string"},"canonicalUrl":{"type":"string"},"apiUrl":{"type":"string"},"purpose":{"type":"string"},"containment":{"type":"object","additionalProperties":true},"claimBoundaries":{"type":"array","items":{"type":"string"}},"integrationSnippets":{"type":"array","items":{"type":"object","additionalProperties":true}},"crawlChecklist":{"type":"array","items":{"type":"string"}},"highLeverageEntrypoints":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":false},"PublicTraffic":{"type":"object","required":["schemaVersion","generatedAt","available","totals","windows","privacy"],"properties":{"schemaVersion":{"const":"hugging-bay.public-traffic.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"webUrl":{"type":"string"},"apiUrl":{"type":"string"},"available":{"type":"boolean"},"degraded":{"type":"boolean"},"source":{"type":"string","enum":["first-party-rollup","fallback"]},"reason":{"type":"string"},"persistence":{"type":"string"},"instrumentation":{"type":"object","additionalProperties":true},"totals":{"type":"object","required":["window","pageviews","uniqueVisitors","downloads","mirrorRequests","productActions","agentOrCrawler"],"additionalProperties":true},"windows":{"type":"array","items":{"type":"object","additionalProperties":true}},"links":{"type":"object","additionalProperties":{"type":"string"}},"privacy":{"type":"object","required":["rawIpsExposed","rawVisitorKeysExposed","rawUserAgentsExposed","rawReferrersExposed"],"properties":{"rawIpsExposed":{"const":false},"rawVisitorKeysExposed":{"const":false},"rawUserAgentsExposed":{"const":false},"rawReferrersExposed":{"const":false},"referrersSuppressed":{"const":true}},"additionalProperties":true},"agentUse":{"type":"object","additionalProperties":true}},"additionalProperties":true},"PublicTrending":{"type":"object","required":["schemaVersion","generatedAt","available","window","totals","rows"],"properties":{"schemaVersion":{"const":"hugging-bay.public-trending.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"webUrl":{"type":"string"},"apiUrl":{"type":"string"},"available":{"type":"boolean"},"reason":{"type":"string"},"window":{"type":"object","properties":{"label":{"type":"string","enum":["24h","7d","30d","all"]},"hours":{"type":["number","null"]}},"additionalProperties":true},"totals":{"type":"object","additionalProperties":true},"rows":{"type":"array","items":{"allOf":[{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ArtifactSummary"},{"type":"object","required":["trendingScore","trendingReasons","signals","urls"],"properties":{"trendingScore":{"type":"number"},"trendingReasons":{"type":"array","items":{"type":"string"}},"signals":{"type":"object","additionalProperties":true},"urls":{"type":"object","additionalProperties":true}},"additionalProperties":true}]}},"topPages":{"type":"array","items":{"type":"object","additionalProperties":true}},"topDownloads":{"type":"array","items":{"type":"object","additionalProperties":true}},"topMirrorRequests":{"type":"array","items":{"type":"object","additionalProperties":true}},"topActions":{"type":"array","items":{"type":"object","additionalProperties":true}},"guidance":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"HfDetailExpansion":{"type":"object","required":["schemaVersion","generatedAt","dryRun","targetCount","rows"],"properties":{"schemaVersion":{"const":"hugging-bay.hf-detail-expansion.v1"},"generatedAt":{"type":"string"},"startedAt":{"type":"string"},"completedAt":{"type":"string"},"dryRun":{"type":"boolean"},"requested":{"type":"number"},"selected":{"type":"number"},"targetCount":{"type":"number"},"fetched":{"type":"number"},"processed":{"type":"number"},"deferred":{"type":"number"},"timedOut":{"type":"boolean"},"maxRuntimeMs":{"type":"number"},"timeoutMs":{"type":"number"},"retries":{"type":"number"},"errors":{"type":"array","items":{"type":"object","additionalProperties":true}},"summary":{"type":"object","additionalProperties":true},"imported":{"type":"number"},"created":{"type":"number"},"updated":{"type":"number"},"blocked":{"type":"number"},"touched":{"type":"array","items":{"type":"string"}},"targets":{"type":"array","items":{"type":"object","additionalProperties":true}},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"additionalProperties":true},"ArtifactAgentBundle":{"type":"object","required":["schemaVersion","generatedAt","id","repo","metadata","card","trustBundle","mirrorReadiness"],"properties":{"schemaVersion":{"const":"hugging-bay.agent-artifact-bundle.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"id":{"type":"string"},"repo":{"type":"string"},"metadata":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ArtifactMetadata"},"card":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ArtifactCard"},"distribution":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ArtifactDistribution"},"trustBundle":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/TrustBundle"},"mirrorReadiness":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/MirrorReadiness"},"downloadableFiles":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/DownloadableFileRow"}},"recommendedNextActions":{"type":"array","items":{"type":"string"}},"urls":{"type":"object","additionalProperties":true}},"additionalProperties":true},"ArtifactInsights":{"type":"object","required":["schemaVersion","generatedAt","artifact","bestFor","decision","quickStart","trust","mirror"],"properties":{"schemaVersion":{"const":"hugging-bay.artifact-insights.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"artifact":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ArtifactSummary"},"bestFor":{"type":"array","items":{"type":"object","additionalProperties":true}},"worksWith":{"type":"array","items":{"type":"object","additionalProperties":true}},"decision":{"type":"object","additionalProperties":true},"quickStart":{"type":"object","additionalProperties":true},"hardware":{"type":"object","additionalProperties":true},"trust":{"type":"object","additionalProperties":true},"benchmarkSummary":{"type":"object","additionalProperties":true},"mirror":{"type":"object","additionalProperties":true},"hostedFiles":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/DownloadableFileRow"}},"similarCuratedPages":{"type":"array","items":{"type":"object","additionalProperties":true}},"urls":{"type":"object","additionalProperties":true},"agentUse":{"type":"object","additionalProperties":true}},"additionalProperties":true},"Topic":{"type":"object","required":["slug","label","artifactCount"],"properties":{"slug":{"type":"string"},"label":{"type":"string"},"kind":{"type":"string"},"artifactCount":{"type":"number"},"hfImports":{"type":"number"},"hostedFiles":{"type":"number"},"downloads":{"type":"number"},"stars":{"type":"number"}},"additionalProperties":true},"TopicPage":{"type":"object","required":["schemaVersion","rows","total","limit","cursor","nextCursor"],"properties":{"schemaVersion":{"const":"hugging-bay.topics-page.v1"},"rows":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/Topic"}},"total":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"maximum":100},"cursor":{"type":"string","pattern":"^[0-9]+$"},"nextCursor":{"type":["string","null"],"pattern":"^[0-9]+$"}},"additionalProperties":false},"RecommendationSummary":{"type":"object","required":["generatedAt","thesis","totals","packs"],"properties":{"generatedAt":{"type":"string"},"thesis":{"type":"string"},"totals":{"type":"object","additionalProperties":true},"packs":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/MirrorPackSummary"}},"mirrorSignals":{"type":"object","additionalProperties":true},"topMirrorCandidates":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/MirrorDemandRow"}}},"additionalProperties":true},"Ranking":{"type":"object","required":["schemaVersion","generatedAt","slug","title","description","webUrl","rows"],"properties":{"schemaVersion":{"const":"hugging-bay.ranking.v1"},"generatedAt":{"type":"string"},"slug":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"webUrl":{"type":"string"},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"additionalProperties":true},"StackIndex":{"type":"object","required":["schemaVersion","generatedAt","webUrl","stacks"],"properties":{"schemaVersion":{"const":"hugging-bay.stack-index.v1"},"generatedAt":{"type":"string"},"webUrl":{"type":"string"},"stacks":{"type":"array","items":{"type":"object","additionalProperties":true}}},"additionalProperties":true},"StackPack":{"type":"object","required":["schemaVersion","generatedAt","slug","title","audience","description","webUrl","apiUrl","searchUrl","rows"],"properties":{"schemaVersion":{"const":"hugging-bay.stack-pack.v1"},"generatedAt":{"type":"string"},"slug":{"type":"string"},"title":{"type":"string"},"audience":{"type":"string"},"description":{"type":"string"},"webUrl":{"type":"string"},"apiUrl":{"type":"string"},"searchUrl":{"type":"string"},"rankingUrl":{"type":"string"},"steps":{"type":"array","items":{"type":"string"}},"rows":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ArtifactSummary"}}},"additionalProperties":true},"OpenSourceRadar":{"type":"object","required":["schemaVersion","generatedAt","webUrl","apiUrl","totals","sourceBreakdown","sections","policy"],"properties":{"schemaVersion":{"const":"hugging-bay.open-source-radar.v1"},"generatedAt":{"type":"string"},"webUrl":{"type":"string"},"apiUrl":{"type":"string"},"totals":{"type":"object","additionalProperties":true},"sourceBreakdown":{"type":"array","items":{"type":"object","additionalProperties":true}},"sections":{"type":"array","items":{"type":"object","required":["id","title","description","searchUrl","rows"],"properties":{"id":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"searchUrl":{"type":"string"},"rows":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ArtifactSummary"}}},"additionalProperties":true}},"policy":{"type":"object","additionalProperties":true}},"additionalProperties":true},"ManifestSigningKey":{"type":"object","required":["algorithm","keyId"],"additionalProperties":true},"TrustBundle":{"type":"object","required":["bundle_version","artifact","trust","files","generated_at"],"additionalProperties":true},"ReleaseReadiness":{"type":"object","required":["schemaVersion","generatedAt","artifactId","repo","canonicalUrl","apiUrl","score","maxScore","level","label","checks","launchGateSummary","machineReadableUrls"],"properties":{"schemaVersion":{"const":"hugging-bay.release-readiness.v1"},"generatedAt":{"type":"string"},"artifactId":{"type":"string"},"repo":{"type":"string"},"canonicalUrl":{"type":"string"},"apiUrl":{"type":"string"},"score":{"type":"number","minimum":0,"maximum":100},"maxScore":{"type":"number"},"level":{"type":"string","enum":["launch-ready","trust-ready","publishable","needs-review","blocked"]},"label":{"type":"string"},"checks":{"type":"array","items":{"type":"object","required":["id","label","status","maxScore","score","detail","action","url"],"properties":{"id":{"type":"string"},"label":{"type":"string"},"status":{"type":"string","enum":["pass","review","pending","optional","block"]},"maxScore":{"type":"number"},"score":{"type":"number"},"detail":{"type":"string"},"action":{"type":"string"},"url":{"type":"string"}},"additionalProperties":true}},"nextBestActions":{"type":"array","items":{"type":"string"}},"launchGateSummary":{"type":"object","additionalProperties":true},"recommendedForLabs":{"type":"array","items":{"type":"string"}},"machineReadableUrls":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":true},"ReleaseBundle":{"type":"object","required":["schemaVersion","generatedAt","canonicalUrl","artifact","publisher","verification","localUse","hostedDownloads","distribution","trustBundle","urls","recommendedActions"],"properties":{"schemaVersion":{"const":"hugging-bay.release-bundle.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"canonicalUrl":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"positioning":{"type":"string"},"artifact":{"type":"object","additionalProperties":true},"publisher":{"type":"object","additionalProperties":true},"verification":{"type":"object","additionalProperties":true},"localUse":{"type":"object","additionalProperties":true},"hostedDownloads":{"type":"object","additionalProperties":true},"distribution":{"type":"object","additionalProperties":true},"trustBundle":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/TrustBundle"},"releaseReadiness":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/ReleaseReadiness"},"card":{"type":"object","additionalProperties":true},"structuredData":{"type":"object","additionalProperties":true},"urls":{"type":"object","additionalProperties":{"type":["string","null"]}},"recommendedCitations":{"type":"array","items":{"type":"string"}},"recommendedActions":{"type":"array","items":{"type":"string"}},"policy":{"type":"object","additionalProperties":true}},"additionalProperties":true},"AgentBriefing":{"type":"object","required":["schemaVersion","generatedAt","product","scale","entrypoints","safeWorkflow"],"properties":{"schemaVersion":{"const":"hugging-bay.agent-briefing.v1"},"generatedAt":{"type":"string"},"product":{"type":"object","additionalProperties":true},"scale":{"type":"object","additionalProperties":true},"entrypoints":{"type":"object","additionalProperties":{"type":"string"}},"safeWorkflow":{"type":"array","items":{"type":"string"}},"highValueQueries":{"type":"array","items":{"type":"object","additionalProperties":true}},"packs":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/MirrorPackSummary"}},"topTopics":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/Topic"}},"mirrorCandidates":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/MirrorDemandRow"}},"hostedDownloads":{"type":"object","additionalProperties":true},"trafficGuidance":{"type":"object","additionalProperties":true}},"additionalProperties":true},"AgentTasks":{"type":"object","required":["schemaVersion","generatedAt","baseUrl","tasks","guidance"],"properties":{"schemaVersion":{"const":"hugging-bay.agent-tasks.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"tasks":{"type":"array","items":{"type":"object","required":["id","label","description","webUrl","apiUrl","nextSteps"],"properties":{"id":{"type":"string"},"label":{"type":"string"},"description":{"type":"string"},"webUrl":{"type":"string"},"apiUrl":{"type":"string"},"searchUrl":{"type":"string"},"actions":{"type":"array","items":{"type":"object","required":["id","method","url"],"properties":{"id":{"type":"string"},"method":{"type":"string"},"url":{"type":"string"},"mcpTool":{"type":"string"},"arguments":{"type":"object","additionalProperties":true}},"additionalProperties":true}},"nextSteps":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}},"guidance":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"CatalogSource":{"type":"object","required":["id","name","status","ingestMode","metadataUse","mirrorPolicy"],"additionalProperties":true},"CatalogSources":{"type":"object","required":["schemaVersion","rows"],"properties":{"schemaVersion":{"const":"hugging-bay.catalog-sources.v1"},"rows":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/CatalogSource"}}},"additionalProperties":true},"EasternSourceCoverage":{"type":"object","required":["schemaVersion","generatedAt","baseUrl","pack","providers","agentGuidance","safetyBoundaries"],"properties":{"schemaVersion":{"const":"hugging-bay.eastern-source-coverage.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"webUrl":{"type":"string"},"apiUrl":{"type":"string"},"purpose":{"type":"string"},"pack":{"type":"object","additionalProperties":true},"priorityFamilies":{"type":"array","items":{"type":"string"}},"publicDiscovery":{"type":"object","additionalProperties":true},"providers":{"type":"array","items":{"type":"object","additionalProperties":true}},"metadataPlanPreview":{"type":"object","additionalProperties":true},"agentGuidance":{"type":"array","items":{"type":"string"}},"safetyBoundaries":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"SourceCoverage":{"type":"object","required":["schemaVersion","generatedAt","source","sourceId","counts","rollups","topArtifacts","policy"],"properties":{"schemaVersion":{"const":"hugging-bay.source-coverage.v1"},"generatedAt":{"type":"string"},"source":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/CatalogSource"},"sourceId":{"type":"string"},"webUrl":{"type":"string"},"apiUrl":{"type":"string"},"counts":{"type":"object","additionalProperties":true},"rollups":{"type":"object","additionalProperties":true},"topArtifacts":{"type":"array","items":{"type":"object","additionalProperties":true}},"policy":{"type":"object","additionalProperties":true}},"additionalProperties":true},"IndexingUrl":{"type":"object","required":["kind","id","url"],"properties":{"kind":{"type":"string","enum":["static","publisher","ranking","stack","intent","answer","citation-pack","source","topic","artifact","artifact-section","artifact-evidence","downloadable","agent-doc"]},"id":{"type":"string"},"url":{"type":"string"},"apiUrl":{"type":"string"},"source":{"type":"string"},"type":{"type":"string"},"license":{"type":"string"},"hosting":{"type":"string"},"artifactId":{"type":"string"},"repo":{"type":"string"},"evidenceType":{"type":"string"},"label":{"type":"string"},"purpose":{"type":"string"},"contentType":{"type":"string"},"sourceUrl":{"type":["string","null"]},"artifactUrl":{"type":"string"},"metadataUrl":{"type":"string"},"cardUrl":{"type":"string"},"cardMarkdownUrl":{"type":"string"},"bundleUrl":{"type":"string"},"agentBundleUrl":{"type":"string"},"releaseUrl":{"type":"string"},"releaseBundleUrl":{"type":"string"},"releaseReadinessUrl":{"type":"string"},"trustUrl":{"type":"string"},"trustBundleUrl":{"type":"string"},"hostedDownloadUrl":{"type":"string"},"hostedDownloadsUrl":{"type":"string"},"downloadableFilesUrl":{"type":"string"},"reviewSummaryUrl":{"type":"string"},"reviewsUrl":{"type":"string"},"filesUrl":{"type":"string"},"insightsUrl":{"type":"string"},"localKitUrl":{"type":"string"},"manifestUrl":{"type":"string"},"compareUrl":{"type":"string"},"citationUrl":{"type":"string"},"aiSearchUrl":{"type":"string"},"extractionUrls":{"type":"object","additionalProperties":{"type":["string","null"]}},"citationTargets":{"type":"object","additionalProperties":{"type":["string","null"]}},"agentActions":{"type":"object","additionalProperties":{"type":["string","null","object"]}},"status":{"type":"string"},"ingestMode":{"type":"string"},"metadataUse":{"type":"string"},"mirrorPolicy":{"type":"string"},"lastmod":{"type":["string","null"]}},"additionalProperties":true},"AnswerPackIndex":{"type":"object","required":["schemaVersion","generatedAt","title","description","webUrl","rows"],"properties":{"schemaVersion":{"const":"hugging-bay.answer-pack-index.v1"},"generatedAt":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"webUrl":{"type":"string"},"rows":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"question":{"type":"string"},"description":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"url":{"type":"string"},"apiUrl":{"type":"string"}},"additionalProperties":true}},"guidance":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"AnswerPack":{"type":"object","required":["schemaVersion","generatedAt","slug","title","question","description","shortAnswer","webUrl","apiUrl","rows"],"properties":{"schemaVersion":{"const":"hugging-bay.answer-pack.v1"},"generatedAt":{"type":"string"},"slug":{"type":"string"},"title":{"type":"string"},"question":{"type":"string"},"description":{"type":"string"},"answerLead":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"shortAnswer":{"type":"string"},"webUrl":{"type":"string"},"apiUrl":{"type":"string"},"sourceApiUrl":{"type":"string"},"rankingUrl":{"type":["string","null"]},"recommenderUrl":{"type":"string"},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}},"citationTargets":{"type":"array","items":{"type":"string"}},"extractionApis":{"type":"array","items":{"type":"string"}},"guidance":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"CitationPack":{"type":"object","required":["schemaVersion","generatedAt","canonicalFacts","query","selectedAnswerPack","answer","citeFirst","rows","extractionWorkflow","assistantFit","links"],"properties":{"schemaVersion":{"const":"hugging-bay.citation-pack.v1"},"generatedAt":{"type":"string"},"canonicalFacts":{"type":"object","required":["schemaVersion","generatedAt","facts"],"properties":{"schemaVersion":{"const":"hugging-bay.facts.v1"},"generatedAt":{"type":"string"},"facts":{"type":"array","items":{"type":"object","additionalProperties":true}}},"additionalProperties":true},"query":{"type":"string"},"selectedAnswerPack":{"type":"object","additionalProperties":true},"answer":{"type":"object","properties":{"short":{"type":"string"},"safeOneLine":{"type":"string"},"supportedClaims":{"type":"array","items":{"type":"string"}},"avoidClaims":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"proof":{"type":"object","additionalProperties":true},"citeFirst":{"type":"array","items":{"type":"object","additionalProperties":true}},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}},"extractionWorkflow":{"type":"array","items":{"type":"string"}},"assistantFit":{"type":"object","additionalProperties":true},"links":{"type":"object","additionalProperties":true}},"additionalProperties":true},"AiVisibility":{"type":"object","required":["schemaVersion","generatedAt","baseUrl","status","positioning","publicBoundaries","crawlerFamilies","probes","machineEntrypoints","indexing","recommendedCrawlerOrder"],"properties":{"schemaVersion":{"const":"hugging-bay.ai-visibility.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"status":{"type":"string"},"positioning":{"type":"string"},"publicBoundaries":{"type":"object","additionalProperties":true},"crawlerFamilies":{"type":"array","items":{"type":"string"}},"probes":{"type":"array","items":{"type":"object","required":["id","url","expected"],"properties":{"id":{"type":"string"},"url":{"type":"string"},"expected":{"type":"string"}},"additionalProperties":true}},"machineEntrypoints":{"type":"object","additionalProperties":{"type":"string"}},"indexing":{"type":"object","additionalProperties":true},"traffic":{"type":["object","null"],"additionalProperties":true},"recommendedCrawlerOrder":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"AgentDiscovery":{"type":"object","required":["schemaVersion","generatedAt","name","canonicalUrl","apiUrl","purpose","positioning","claimBoundaries","safeMention","startHere","recommendedFetchOrder","assistantEntrypoints","agentRecipes","citationTargets","indexing","crawlerPolicy"],"properties":{"schemaVersion":{"const":"hugging-bay.agent-discovery.v1"},"generatedAt":{"type":"string"},"name":{"type":"string"},"canonicalUrl":{"type":"string"},"apiUrl":{"type":"string"},"aliases":{"type":"array","items":{"type":"string"}},"routeRecovery":{"type":"object","additionalProperties":true},"purpose":{"type":"string"},"positioning":{"type":"object","additionalProperties":true},"whoShouldUseThis":{"type":"array","items":{"type":"string"}},"claimBoundaries":{"type":"array","items":{"type":"string"}},"safeMention":{"type":"object","additionalProperties":true},"startHere":{"type":"array","items":{"type":"object","additionalProperties":true}},"recommendedFetchOrder":{"type":"array","items":{"type":"string"}},"assistantEntrypoints":{"type":"object","additionalProperties":{"type":"string"}},"agentRecipes":{"type":"array","items":{"type":"object","additionalProperties":true}},"endpoints":{"type":"object","additionalProperties":true},"citationTargets":{"type":"object","additionalProperties":true},"indexing":{"type":"object","additionalProperties":{"type":"string"}},"crawlerPolicy":{"type":"object","additionalProperties":true},"monitoring":{"type":"object","additionalProperties":{"type":"string"}},"publisherAndLabs":{"type":"object","additionalProperties":{"type":"string"}},"localTooling":{"type":"object","additionalProperties":{"type":"string"}},"freshness":{"type":"object","additionalProperties":true}},"additionalProperties":true},"AiMentionResult":{"type":"object","required":["id","provider","promptId","status","mentioned"],"properties":{"id":{"type":"string"},"provider":{"type":"string"},"promptId":{"type":"string"},"status":{"type":"string","enum":["mentioned","missing","wrong-claim","uncited","blocked","observed"]},"mentioned":{"type":"boolean"},"citationUrl":{"type":"string"},"citationRank":{"type":["number","null"]},"answerUrl":{"type":"string"},"query":{"type":"string"},"checkedAt":{"type":["string","null"]},"checkedBy":{"type":"string"},"source":{"type":"string"},"answerExcerpt":{"type":"string"},"notes":{"type":"string"},"expectedCitationMatched":{"type":"boolean"},"wrongClaim":{"type":"string"}},"additionalProperties":true},"AiMentionSummary":{"type":"object","required":["checks","mentions","missing","wrongClaims","citations","mentionRate","citationRate","providerCoverage","promptCoverage","byProvider","byPrompt"],"properties":{"checks":{"type":"number"},"mentions":{"type":"number"},"missing":{"type":"number"},"wrongClaims":{"type":"number"},"citations":{"type":"number"},"mentionRate":{"type":"number"},"citationRate":{"type":"number"},"providerCoverage":{"type":"number"},"promptCoverage":{"type":"number"},"byProvider":{"type":"array","items":{"type":"object","additionalProperties":true}},"byPrompt":{"type":"array","items":{"type":"object","additionalProperties":true}}},"additionalProperties":true},"AiMentionResults":{"type":"object","required":["schemaVersion","generatedAt","baseUrl","summary","rows","recordEndpoint","privacy"],"properties":{"schemaVersion":{"const":"hugging-bay.ai-mention-results.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"summary":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/AiMentionSummary"},"rows":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/AiMentionResult"}},"recordEndpoint":{"type":"string"},"privacy":{"type":"object","additionalProperties":true}},"additionalProperties":true},"AiMentionMonitor":{"type":"object","required":["schemaVersion","generatedAt","baseUrl","canonicalUrl","apiUrl","status","objective","positioning","readiness","providerTargets","promptTargets","observedResults","expectedCitationOrder","machineEntrypoints","manualCheckWorkflow","publishableProof","privacy"],"properties":{"schemaVersion":{"const":"hugging-bay.ai-mention-monitor.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"canonicalUrl":{"type":"string"},"apiUrl":{"type":"string"},"status":{"type":"string"},"objective":{"type":"string"},"positioning":{"type":"object","additionalProperties":true},"readiness":{"type":"object","additionalProperties":true},"providerTargets":{"type":"array","items":{"type":"object","additionalProperties":true}},"promptTargets":{"type":"array","items":{"type":"object","additionalProperties":true}},"prompts":{"type":"array","items":{"type":"object","additionalProperties":true}},"observedResults":{"type":"object","required":["schemaVersion","apiUrl","summary","rows","privacy"],"properties":{"schemaVersion":{"const":"hugging-bay.ai-mention-results.v1"},"apiUrl":{"type":"string"},"adminRecordUrl":{"type":"string"},"summary":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/AiMentionSummary"},"rows":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/AiMentionResult"}},"privacy":{"type":"string"}},"additionalProperties":true},"expectedCitationOrder":{"type":"array","items":{"type":"string"}},"machineEntrypoints":{"type":"object","additionalProperties":{"type":"string"}},"manualCheckWorkflow":{"type":"array","items":{"type":"string"}},"publishableProof":{"type":"object","additionalProperties":true},"traffic":{"type":["object","null"],"additionalProperties":true},"indexing":{"type":["object","null"],"additionalProperties":true},"privacy":{"type":"object","additionalProperties":true}},"additionalProperties":true},"PublicDataManifest":{"type":"object","required":["schemaVersion","generatedAt","baseUrl","license","privacy","boundaries","counts","dumps","feeds","checksums","schemas"],"properties":{"schemaVersion":{"const":"hugging-bay.public-data-manifest.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"license":{"type":"string"},"privacy":{"type":"string"},"boundaries":{"type":"object","additionalProperties":true},"counts":{"type":"object","additionalProperties":true},"dumps":{"type":"object","additionalProperties":{"type":"string"}},"feeds":{"type":"object","additionalProperties":{"type":"string"}},"badges":{"type":"object","additionalProperties":{"type":"string"}},"checksums":{"type":"object","additionalProperties":true},"schemas":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":true},"RobotsJson":{"type":"object","required":["schemaVersion","generatedAt","baseUrl","textRobotsUrl","status","publicPolicy","discovery","userAgents","providerGroups","preferredCrawlEntrypoints","preferredCitationTargets","expectedHeaders","rateGuidance"],"properties":{"schemaVersion":{"const":"hugging-bay.robots-json.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"textRobotsUrl":{"type":"string"},"status":{"type":"string"},"publicPolicy":{"type":"object","additionalProperties":true},"discovery":{"type":"object","additionalProperties":{"type":"string"}},"userAgents":{"type":"array","items":{"type":"object","additionalProperties":true}},"providerGroups":{"type":"array","items":{"type":"object","additionalProperties":true}},"allowPublicPaths":{"type":"array","items":{"type":"string"}},"protectPrivatePaths":{"type":"array","items":{"type":"string"}},"preferredCrawlEntrypoints":{"type":"array","items":{"type":"string"}},"preferredCitationTargets":{"type":"array","items":{"type":"string"}},"expectedHeaders":{"type":"object","additionalProperties":true},"rateGuidance":{"type":"object","additionalProperties":true}},"additionalProperties":true},"AiCrawlerPolicy":{"type":"object","required":["schemaVersion","generatedAt","baseUrl","robotsUrl","answerEngineManifestUrl","botAllowlistUrl","llmsTxtUrl","llmsFullTxtUrl","policy","preferredCrawlEntrypoints","preferredCitationTargets","userAgents","rateGuidance"],"properties":{"schemaVersion":{"const":"hugging-bay.ai-crawler-policy.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"robotsUrl":{"type":"string"},"answerEngineManifestUrl":{"type":"string"},"botAllowlistUrl":{"type":"string"},"llmsTxtUrl":{"type":"string"},"llmsFullTxtUrl":{"type":"string"},"policy":{"type":"object","additionalProperties":true},"preferredCrawlEntrypoints":{"type":"array","items":{"type":"string"}},"preferredCitationTargets":{"type":"array","items":{"type":"string"}},"userAgents":{"type":"array","items":{"type":"object","additionalProperties":true}},"rateGuidance":{"type":"object","additionalProperties":true}},"additionalProperties":true},"AiBotAllowlist":{"type":"object","required":["schemaVersion","generatedAt","baseUrl","status","policySummary","discovery","wafGuidance","providers","preferredCrawlEntrypoints","preferredCitationTargets","noBypassPolicy"],"properties":{"schemaVersion":{"const":"hugging-bay.ai-bot-allowlist.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"status":{"type":"string"},"policySummary":{"type":"string"},"discovery":{"type":"object","additionalProperties":{"type":"string"}},"wafGuidance":{"type":"object","additionalProperties":true},"providers":{"type":"array","items":{"type":"object","additionalProperties":true}},"preferredCrawlEntrypoints":{"type":"array","items":{"type":"string"}},"preferredCitationTargets":{"type":"array","items":{"type":"string"}},"noBypassPolicy":{"type":"object","additionalProperties":true}},"additionalProperties":true},"AnswerEngineManifest":{"type":"object","required":["schemaVersion","generatedAt","name","description","homepage","robots","crawlerPolicy","botAllowlist","llms","manifests","answerPacks","answerableIntents","boundedApis","citationGuidance","structuredData"],"properties":{"schemaVersion":{"const":"hugging-bay.answer-engine.v1"},"generatedAt":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"homepage":{"type":"string"},"robots":{"type":"string"},"crawlerPolicy":{"type":"string"},"botAllowlist":{"type":"string"},"llms":{"type":"object","additionalProperties":true},"manifests":{"type":"object","additionalProperties":{"type":"string"}},"answerPacks":{"type":"object","additionalProperties":true},"answerableIntents":{"type":"array","items":{"type":"object","additionalProperties":true}},"boundedApis":{"type":"object","additionalProperties":{"type":"string"}},"citationGuidance":{"type":"array","items":{"type":"string"}},"structuredData":{"type":"object","additionalProperties":true}},"additionalProperties":true},"ContainedIntegrationSnippets":{"type":"object","required":["schemaVersion","artifactId","repo","status","executionState","commandsAvailable","reason","canonicalState","snippets","guidance","filesUrl"],"properties":{"schemaVersion":{"const":"hugging-bay.integration-snippets.v2"},"artifactId":{"type":"string"},"repo":{"type":"string"},"status":{"const":"contained"},"executionState":{"const":"contained"},"commandsAvailable":{"const":false},"reason":{"const":"canonical_authorization_unavailable"},"canonicalState":{"type":"object","additionalProperties":true},"snippets":{"type":"array","maxItems":0,"items":{"type":"object","additionalProperties":true}},"guidance":{"type":"string"},"filesUrl":{"type":"string"}},"additionalProperties":false},"McpToolSummary":{"type":"object","required":["name","description"],"properties":{"name":{"type":"string"},"description":{"type":"string"},"inputSchema":{"type":"object","additionalProperties":true}},"additionalProperties":true},"McpDiscovery":{"type":"object","required":["schemaVersion","name","description","apiBase","transports","package","docs","publicRemoteTools","publicRemoteToolCount","authenticatedStdioTools","authenticatedStdioToolCount","tools","toolCount"],"properties":{"schemaVersion":{"const":"hugging-bay.mcp-discovery.v1"},"name":{"type":"string"},"description":{"type":"string"},"apiBase":{"type":"string"},"transports":{"type":"array","items":{"type":"object","additionalProperties":true}},"package":{"type":"object","additionalProperties":true},"docs":{"type":"object","additionalProperties":{"type":"string"}},"publicRemoteTools":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/McpToolSummary"}},"publicRemoteToolCount":{"type":"number"},"authenticatedStdioTools":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/McpToolSummary"}},"authenticatedStdioToolCount":{"type":"number"},"tools":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/McpToolSummary"}},"toolCount":{"type":"number"}},"additionalProperties":true},"RemoteMcpDiscovery":{"type":"object","required":["schemaVersion","generatedAt","name","version","endpoint","alias","protocol","supportedProtocolVersions","auth","methods","toolNames","tools","examples","discovery"],"properties":{"schemaVersion":{"const":"hugging-bay.remote-mcp.v1"},"generatedAt":{"type":"string"},"name":{"type":"string"},"version":{"type":"string"},"endpoint":{"type":"string"},"alias":{"type":"string"},"protocol":{"type":"string"},"supportedProtocolVersions":{"type":"array","minItems":1,"items":{"type":"string"}},"auth":{"type":"object","additionalProperties":true},"methods":{"type":"array","items":{"type":"string"}},"toolNames":{"type":"array","items":{"type":"string"}},"tools":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/McpToolSummary"}},"examples":{"type":"object","additionalProperties":true},"discovery":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":true},"McpServerCard":{"type":"object","required":["schemaVersion","generatedAt","name","version","description","website","serverCardUrl","mcpManifestUrl","remoteMcp","restApi","crawlability","safety"],"properties":{"schemaVersion":{"const":"hugging-bay.mcp-server-card.v1"},"generatedAt":{"type":"string"},"name":{"type":"string"},"version":{"type":"string"},"description":{"type":"string"},"website":{"type":"string"},"serverCardUrl":{"type":"string"},"mcpManifestUrl":{"type":"string"},"remoteMcp":{"type":"object","additionalProperties":true},"restApi":{"type":"object","additionalProperties":true},"crawlability":{"type":"object","additionalProperties":true},"safety":{"type":"object","additionalProperties":true}},"additionalProperties":true},"RunCardIssueRequest":{"type":"object","required":["preflightId"],"properties":{"preflightId":{"type":"string","pattern":"^hbap_[a-f0-9]{64}$"}},"additionalProperties":false},"RunCardUnavailable":{"type":"object","required":["error"],"properties":{"error":{"type":"string","enum":["run_card_not_found","run_card_unavailable","method_not_allowed","run_card_surface_format_unsupported","run_card_public_state_binding_invalid","run_card_surface_revoked","run_card_surface_unavailable","run_card_surface_payload_too_large"]}},"additionalProperties":false},"RunCard":{"type":"object","required":["schema","contractVersion","id","decisionId","agentHandoffId","signingKeyId","task","constraints","rig","representation","runtime","fit","smoke","recovery","policy","evidenceCutoff","executableState","authority","authorization","use","runCardDigest","signature"],"properties":{"schema":{"const":"hugging-bay.run-card.v1"},"contractVersion":{"const":"1.1.0"},"id":{"type":"string","pattern":"^hbrc_[a-f0-9]{32}([a-f0-9]{32})?$"},"decisionId":{"type":"string","pattern":"^hbd_[a-f0-9]{32}([a-f0-9]{32})?$"},"agentHandoffId":{"type":"string","pattern":"^hbah_[a-f0-9]{32}([a-f0-9]{32})?$"},"publisherReferralId":{"type":"string","maxLength":160},"signingKeyId":{"type":"string","pattern":"^ed25519:[a-f0-9]{24}$"},"task":{"type":"string","minLength":1,"maxLength":120},"constraints":{"type":"object","maxProperties":8,"properties":{"contextTokens":{"type":"integer","minimum":0,"maximum":4194304},"maxDownloadBytes":{"type":"integer","minimum":0,"maximum":10995116277760},"maxDiskBytes":{"type":"integer","minimum":0,"maximum":10995116277760},"commercialSafe":{"type":"boolean"},"privacy":{"type":"string","minLength":1,"maxLength":120},"bandwidthClass":{"type":"string","minLength":1,"maxLength":120},"qualityFloor":{"type":"string","minLength":1,"maxLength":120},"language":{"type":"string","minLength":1,"maxLength":120}},"additionalProperties":false},"rig":{"type":"object","required":["id","profileDigest"],"properties":{"id":{"type":"string","minLength":1,"maxLength":120},"profileDigest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"}},"additionalProperties":false},"representation":{"type":"object","required":["artifactId","representationId","source","selectedFilesDigest","representationDigest","evidenceSnapshotDigest","files"],"properties":{"artifactId":{"type":"string","minLength":1,"maxLength":200},"representationId":{"type":"string","minLength":1,"maxLength":200},"source":{"type":"object","required":["provider","identity","revision"],"properties":{"provider":{"type":"string","minLength":1,"maxLength":40},"identity":{"type":"string","minLength":1,"maxLength":240},"revision":{"type":"string","pattern":"^[a-f0-9]{40}([a-f0-9]{24})?$"}},"additionalProperties":false},"selectedFilesDigest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},"representationDigest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},"evidenceSnapshotDigest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},"files":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"object","required":["path","role","sizeBytes","sha256"],"properties":{"path":{"type":"string","minLength":1,"maxLength":500},"role":{"type":"string","minLength":1,"maxLength":40},"sizeBytes":{"type":"integer","minimum":1},"sha256":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"}},"additionalProperties":false}}},"additionalProperties":false},"runtime":{"type":"object","required":["adapterId","engineVersion","adapterVersion","adapterAbiVersion","executable","contractDigest","commandEvidenceDigest","argv"],"properties":{"adapterId":{"type":"string","enum":["llama.cpp","sentence-transformers","transformers"]},"engineVersion":{"type":"string","minLength":1,"maxLength":80},"adapterVersion":{"type":"string","minLength":1,"maxLength":80},"adapterAbiVersion":{"type":"string","minLength":1,"maxLength":80},"executable":{"const":"hbay-runtime"},"contractDigest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},"commandEvidenceDigest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},"argv":{"type":"array","minItems":1,"maxItems":64,"items":{"type":"string","minLength":1,"maxLength":512}}},"additionalProperties":false},"fit":{"type":"object","required":["verdict","evidenceLevel","requiredBytes","headroomBytes","evidenceDigest"],"additionalProperties":false,"properties":{"verdict":{"const":"fits"},"evidenceLevel":{"type":"string","enum":["measured","conservative-estimate"]},"requiredBytes":{"type":"integer","minimum":1},"headroomBytes":{"type":"integer","minimum":0},"evidenceDigest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"}}},"smoke":{"type":"object","required":["suiteId","expectedBoundary","passed","passedAt","evidenceDigest"],"additionalProperties":false,"properties":{"suiteId":{"type":"string"},"expectedBoundary":{"type":"string"},"passed":{"const":true},"passedAt":{"type":"string","format":"date-time"},"evidenceDigest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"}}},"recovery":{"type":"object","required":["code","path"],"additionalProperties":false,"properties":{"code":{"type":"string"},"path":{"type":"string","pattern":"^/[^/].*"}}},"policy":{"type":"object","required":["decision","policyDigest","reasonCodes","expiresAt"],"additionalProperties":false,"properties":{"decision":{"const":"allow"},"policyDigest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},"reasonCodes":{"type":"array","maxItems":64,"items":{"type":"string"}},"expiresAt":{"type":"string","format":"date-time"}}},"evidenceCutoff":{"type":"string","format":"date-time"},"executableState":{"type":"string","enum":["complete-runnable","complete-verified"]},"authority":{"type":"object","required":["automationPreflightId","decisionDigest","policyEvidenceId","policyEvidenceDigest"],"additionalProperties":false,"properties":{"automationPreflightId":{"type":"string","pattern":"^hbap_[a-f0-9]{64}$"},"decisionDigest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},"policyEvidenceId":{"type":"string","minLength":1,"maxLength":200},"policyEvidenceDigest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"}}},"authorization":{"type":"object","required":["principalId","owner"],"additionalProperties":false,"properties":{"principalId":{"type":"string","minLength":1,"maxLength":200},"owner":{"type":"string","minLength":1,"maxLength":200}}},"use":{"type":"object","required":["argv"],"additionalProperties":false,"properties":{"argv":{"type":"array","minItems":3,"maxItems":3,"prefixItems":[{"const":"hbay"},{"const":"use"},{"type":"string","pattern":"^hbrc_[a-f0-9]{32}([a-f0-9]{32})?$"}]}}},"runCardDigest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},"signature":{"type":"object","required":["algorithm","keyId","canonicalDigest","value"],"additionalProperties":false,"properties":{"algorithm":{"const":"Ed25519"},"keyId":{"type":"string","pattern":"^ed25519:[a-f0-9]{24}$"},"canonicalDigest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},"value":{"type":"string","minLength":1}}}},"additionalProperties":false},"RunCardDiscovery":{"type":"object","required":["schemaVersion","artifactId","state","matchClaim","note","cards"],"additionalProperties":false,"properties":{"schemaVersion":{"const":"hugging-bay.run-card-discovery.v1"},"artifactId":{"type":"string","minLength":1,"maxLength":240},"state":{"type":"string","enum":["available","unavailable"]},"matchClaim":{"const":"artifact-only"},"note":{"type":"string"},"cards":{"type":"array","maxItems":10,"items":{"type":"object","required":["id","decisionId","task","taskMode","rig","runtime","fit","smoke","representation","evidenceCutoff","expiresAt","links"],"additionalProperties":false,"properties":{"id":{"type":"string","pattern":"^hbrc_[a-f0-9]{32}([a-f0-9]{32})?$"},"decisionId":{"type":"string","pattern":"^hbd_[a-f0-9]{32}([a-f0-9]{32})?$"},"task":{"type":"string"},"taskMode":{"type":["string","null"]},"rig":{"type":"object","additionalProperties":false,"required":["id","profileDigest"],"properties":{"id":{"type":["string","null"]},"profileDigest":{"type":["string","null"]}}},"runtime":{"type":"object","additionalProperties":false,"required":["adapterId","engineVersion","adapterVersion"],"properties":{"adapterId":{"type":["string","null"]},"engineVersion":{"type":["string","null"]},"adapterVersion":{"type":["string","null"]}}},"fit":{"type":"object","additionalProperties":false,"required":["verdict","evidenceLevel","requiredBytes","headroomBytes"],"properties":{"verdict":{"type":["string","null"]},"evidenceLevel":{"type":["string","null"]},"requiredBytes":{"type":["integer","null"]},"headroomBytes":{"type":["integer","null"]}}},"smoke":{"type":"object","additionalProperties":false,"required":["passed","passedAt","suiteId"],"properties":{"passed":{"type":"boolean"},"passedAt":{"type":["string","null"]},"suiteId":{"type":["string","null"]}}},"representation":{"type":"object","additionalProperties":false,"required":["artifactId","representationId","revision","selectedFilesDigest"],"properties":{"artifactId":{"type":["string","null"]},"representationId":{"type":["string","null"]},"revision":{"type":["string","null"]},"selectedFilesDigest":{"type":["string","null"]}}},"evidenceCutoff":{"type":"string","format":"date-time"},"expiresAt":{"type":"string","format":"date-time"},"links":{"type":"object","additionalProperties":false,"required":["html","json"],"properties":{"html":{"type":"string"},"json":{"type":"string"}}}}}}}},"IndexingStatus":{"type":"object","required":["schemaVersion","generatedAt","baseUrl","sitemapIndexUrl","totals","sitemaps","urlKinds"],"properties":{"schemaVersion":{"const":"hugging-bay.indexing-status.v1"},"generatedAt":{"type":"string"},"baseUrl":{"type":"string"},"robotsUrl":{"type":"string"},"sitemapIndexUrl":{"type":"string"},"llmsTxtUrl":{"type":"string"},"openapiUrl":{"type":"string"},"agentManifestUrl":{"type":"string"},"urlBatchEndpoint":{"type":"string"},"totals":{"type":"object","additionalProperties":true},"sitemaps":{"type":"array","items":{"type":"object","additionalProperties":true}},"urlKinds":{"type":"array","items":{"type":"string"}},"guidance":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"IndexingUrlBatch":{"type":"object","required":["schemaVersion","generatedAt","kind","rows","total","limit","cursor","nextCursor"],"properties":{"schemaVersion":{"const":"hugging-bay.indexing-url-batch.v1"},"generatedAt":{"type":"string"},"kind":{"type":"string"},"rows":{"type":"array","items":{"$ref":"https://huggingbay.xyz/api/schemas#/$defs/IndexingUrl"}},"filters":{"type":"object","additionalProperties":true},"total":{"type":"number"},"limit":{"type":"number"},"cursor":{"type":"string"},"nextCursor":{"type":["string","null"]}},"additionalProperties":true},"IndexingUrlOnlyBatch":{"type":"object","required":["schemaVersion","projection","kind","rows","total","limit","cursor","nextCursor"],"properties":{"schemaVersion":{"const":"hugging-bay.indexing-url-batch.url-only.v1"},"projection":{"const":"url-only"},"kind":{"type":"string"},"rows":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"}},"additionalProperties":false}},"filters":{"type":"object","additionalProperties":true},"total":{"type":"number"},"limit":{"type":"number"},"cursor":{"type":"string"},"nextCursor":{"type":["string","null"]},"estimatedTotal":{"type":"boolean"}},"additionalProperties":true}},"containment":{"state":"unavailable","canonicalState":"unknown","verificationState":"unknown","executable":false,"downloadReady":false,"summary":"Canonical artifact completeness, verification, execution readiness, and download readiness are unavailable during containment."}}