{"ok":true,"service":"discovery-provider-registry","mode":"provider-registry-readiness-layer","timestamp":"2026-06-26T15:03:02.538Z","discoveryFoundationDependency":{"foundationReady":true,"liveSearchEnabled":false,"vaultIngestionEnabled":false,"capsuleCompressionEnabled":false,"multimodalInterpretationEnabled":false},"summary":{"totalProviders":18,"totalCategories":7,"readyRules":5,"reviewRequired":3,"blocked":0,"registryReady":true,"liveProviderRetrievalEnabled":false,"providerCredentialsAttached":false,"vaultIngestionAllowed":false,"capsuleCompressionAllowed":false,"productionMutation":false,"reason":"Discovery Provider Registry is ready as a non-destructive provider map. Live retrieval, credentials, provider polling, Vault ingestion, and capsule compression remain disabled until provider terms, credentials, quotas, attribution, and governance gates are approved."},"categories":["general-web-search","encyclopedic-knowledge","academic-research","government-public-data","news-current-events","domain-specific-vault-feeds","multimodal-file-sources"],"providers":[{"providerId":"google-custom-search","providerName":"Google Custom Search","category":"general-web-search","status":"planned","accessMode":"official-api-required","liveEnabled":false,"vaultIngestionAllowed":false,"capsuleCompressionAllowed":false,"termsReviewRequired":true,"quotaReviewRequired":true,"attributionRequired":true,"purpose":"Retrieve broad web results through an official Google search interface when approved.","safeguard":"Do not scrape Google result pages. Use official access only."},{"providerId":"bing-web-search","providerName":"Bing Web Search","category":"general-web-search","status":"planned","accessMode":"official-api-required","liveEnabled":false,"vaultIngestionAllowed":false,"capsuleCompressionAllowed":false,"termsReviewRequired":true,"quotaReviewRequired":true,"attributionRequired":true,"purpose":"Retrieve broad web results through an official Bing-compatible API when approved.","safeguard":"Respect quotas, billing, attribution, and caching limits."},{"providerId":"brave-search","providerName":"Brave Search","category":"general-web-search","status":"planned","accessMode":"official-api-required","liveEnabled":false,"vaultIngestionAllowed":false,"capsuleCompressionAllowed":false,"termsReviewRequired":true,"quotaReviewRequired":true,"attributionRequired":true,"purpose":"Retrieve independent web search results through approved Brave Search access.","safeguard":"Use as a comparison provider, not a single truth source."},{"providerId":"wikipedia","providerName":"Wikipedia","category":"encyclopedic-knowledge","status":"planned","accessMode":"public-api-or-licensed-feed","liveEnabled":false,"vaultIngestionAllowed":false,"capsuleCompressionAllowed":false,"termsReviewRequired":true,"quotaReviewRequired":false,"attributionRequired":true,"purpose":"Provide entity context, definitions, and source trails for baseline understanding.","safeguard":"Treat as contextual knowledge and inspect citations for factual claims."},{"providerId":"wikidata","providerName":"Wikidata","category":"encyclopedic-knowledge","status":"planned","accessMode":"public-api-or-sparql","liveEnabled":false,"vaultIngestionAllowed":false,"capsuleCompressionAllowed":false,"termsReviewRequired":true,"quotaReviewRequired":true,"attributionRequired":true,"purpose":"Provide structured entity relationships for discovery, timelines, and knowledge graphs.","safeguard":"Validate important claims against primary or higher-authority sources."},{"providerId":"crossref","providerName":"Crossref","category":"academic-research","status":"planned","accessMode":"public-api","liveEnabled":false,"vaultIngestionAllowed":false,"capsuleCompressionAllowed":false,"termsReviewRequired":true,"quotaReviewRequired":true,"attributionRequired":true,"purpose":"Retrieve DOI metadata, scholarly publication trails, authors, journals, and citation context.","safeguard":"Metadata is not the same as full paper verification."},{"providerId":"openalex","providerName":"OpenAlex","category":"academic-research","status":"planned","accessMode":"public-api","liveEnabled":false,"vaultIngestionAllowed":false,"capsuleCompressionAllowed":false,"termsReviewRequired":true,"quotaReviewRequired":true,"attributionRequired":true,"purpose":"Retrieve academic works, institutions, authors, concepts, and citation relationships.","safeguard":"Separate scholarly metadata from claim-level truth."},{"providerId":"semantic-scholar","providerName":"Semantic Scholar","category":"academic-research","status":"planned","accessMode":"official-api-required","liveEnabled":false,"vaultIngestionAllowed":false,"capsuleCompressionAllowed":false,"termsReviewRequired":true,"quotaReviewRequired":true,"attributionRequired":true,"purpose":"Retrieve paper abstracts, citation contexts, authors, and research graph signals.","safeguard":"Do not over-trust abstracts without paper-level review."},{"providerId":"pubmed","providerName":"PubMed","category":"academic-research","status":"planned","accessMode":"public-api","liveEnabled":false,"vaultIngestionAllowed":false,"capsuleCompressionAllowed":false,"termsReviewRequired":true,"quotaReviewRequired":true,"attributionRequired":true,"purpose":"Retrieve biomedical and life-science publication records when relevant.","safeguard":"Medical or health-related outputs require careful uncertainty and source boundaries."},{"providerId":"data-gov","providerName":"Data.gov","category":"government-public-data","status":"planned","accessMode":"public-api-or-dataset","liveEnabled":false,"vaultIngestionAllowed":false,"capsuleCompressionAllowed":false,"termsReviewRequired":true,"quotaReviewRequired":false,"attributionRequired":true,"purpose":"Access US public datasets for evidence-backed civic, economic, climate, and infrastructure discovery.","safeguard":"Dataset freshness, schema, and provenance must be checked."},{"providerId":"noaa","providerName":"NOAA","category":"government-public-data","status":"planned","accessMode":"public-api-or-dataset","liveEnabled":false,"vaultIngestionAllowed":false,"capsuleCompressionAllowed":false,"termsReviewRequired":true,"quotaReviewRequired":true,"attributionRequired":true,"purpose":"Retrieve climate, oceanic, atmospheric, and weather-adjacent datasets.","safeguard":"Use dataset metadata and temporal resolution before drawing conclusions."},{"providerId":"nasa","providerName":"NASA","category":"government-public-data","status":"planned","accessMode":"public-api-or-dataset","liveEnabled":false,"vaultIngestionAllowed":false,"capsuleCompressionAllowed":false,"termsReviewRequired":true,"quotaReviewRequired":true,"attributionRequired":true,"purpose":"Retrieve space, earth observation, planetary, and scientific datasets.","safeguard":"Preserve mission, instrument, and dataset provenance."},{"providerId":"world-bank","providerName":"World Bank","category":"government-public-data","status":"planned","accessMode":"public-api-or-dataset","liveEnabled":false,"vaultIngestionAllowed":false,"capsuleCompressionAllowed":false,"termsReviewRequired":true,"quotaReviewRequired":true,"attributionRequired":true,"purpose":"Retrieve global development, economic, demographic, and regional indicators.","safeguard":"Indicators need date, country, methodology, and revision awareness."},{"providerId":"fao","providerName":"FAO","category":"government-public-data","status":"planned","accessMode":"public-api-or-dataset","liveEnabled":false,"vaultIngestionAllowed":false,"capsuleCompressionAllowed":false,"termsReviewRequired":true,"quotaReviewRequired":true,"attributionRequired":true,"purpose":"Retrieve agriculture, food, crop, and cacao-adjacent production context.","safeguard":"Agricultural statistics must preserve region, crop definitions, and reporting year."},{"providerId":"licensed-news-feeds","providerName":"Licensed News Feeds","category":"news-current-events","status":"review-required","accessMode":"licensed-feed-required","liveEnabled":false,"vaultIngestionAllowed":false,"capsuleCompressionAllowed":false,"termsReviewRequired":true,"quotaReviewRequired":true,"attributionRequired":true,"purpose":"Track current events across approved publishers and feeds.","safeguard":"Do not treat speed as accuracy. Do not store copyrighted news bodies without rights."},{"providerId":"publisher-rss-feeds","providerName":"Publisher RSS Feeds","category":"news-current-events","status":"planned","accessMode":"publisher-feed","liveEnabled":false,"vaultIngestionAllowed":false,"capsuleCompressionAllowed":false,"termsReviewRequired":true,"quotaReviewRequired":false,"attributionRequired":true,"purpose":"Monitor public publisher feeds for current developments and source comparison.","safeguard":"Store metadata, summaries, and links only unless rights allow more."},{"providerId":"cacao-domain-feeds","providerName":"Cacao Domain Feeds","category":"domain-specific-vault-feeds","status":"planned","accessMode":"curated-source-list","liveEnabled":false,"vaultIngestionAllowed":false,"capsuleCompressionAllowed":false,"termsReviewRequired":true,"quotaReviewRequired":false,"attributionRequired":true,"purpose":"Curate cacao research, agriculture, culture, ceremony, manufacturing, and sustainability sources.","safeguard":"Cacao cultural and scientific sources must be separated, attributed, and respectfully contextualized."},{"providerId":"multimodal-file-intake","providerName":"Multimodal File Intake","category":"multimodal-file-sources","status":"review-required","accessMode":"uploaded-file-or-approved-connector","liveEnabled":false,"vaultIngestionAllowed":false,"capsuleCompressionAllowed":false,"termsReviewRequired":true,"quotaReviewRequired":false,"attributionRequired":false,"purpose":"Prepare future ingestion for images, PDFs, CAD, schematics, architectural plans, maps, and datasets.","safeguard":"Do not process files automatically without type validation, rights awareness, redaction, and human-readable interpretation boundaries."}],"readinessRules":[{"rule":"Official Access Required","status":"ready","purpose":"Search and data providers must use approved APIs, feeds, datasets, or connectors.","safeguard":"No scraping provider result pages."},{"rule":"Terms And Licensing Review","status":"review-required","purpose":"Each provider needs terms, quota, caching, attribution, and storage review before live use.","safeguard":"Discovery cannot be built on illegal or brittle data access."},{"rule":"No Live Retrieval Yet","status":"ready","purpose":"The registry defines providers but does not query them.","safeguard":"Provider listing is not provider activation."},{"rule":"No Vault Ingestion Yet","status":"ready","purpose":"Provider results cannot be stored in the Vault until ingestion readiness is approved.","safeguard":"Do not store external content before redaction, retention, and licensing gates."},{"rule":"No Capsule Compression Yet","status":"ready","purpose":"Provider results cannot be compressed into Intelligence Capsules until capsule readiness exists.","safeguard":"Do not compress away uncertainty or source trail."},{"rule":"Attribution Required","status":"ready","purpose":"Source attribution must remain attached to all provider-derived records.","safeguard":"Discovery without attribution becomes black-box copying."},{"rule":"Provider Health Not Attached Yet","status":"review-required","purpose":"Discovery providers will eventually need health, quota, and latency monitoring.","safeguard":"Do not mix operational provider health with discovery provider activation yet."},{"rule":"Founder Approval Required For Activation","status":"review-required","purpose":"Turning on live retrieval for any provider must require founder-approved configuration.","safeguard":"No accidental live search, billing, quota burn, or rights violation."}],"allowedNow":["Render discovery provider registry.","Classify providers by category.","Show provider access mode and activation status.","Mark terms, quota, attribution, and licensing requirements.","Keep all providers disabled.","Keep Vault ingestion disabled.","Keep capsule compression disabled."],"notAllowedYet":["Query providers live.","Attach provider credentials.","Scrape search engines or websites.","Store provider results in the Vault.","Compress provider outputs into capsules.","Enable provider health polling for discovery providers.","Ignore provider terms, quotas, caching limits, or attribution requirements."],"futureProviderActivationShape":{"providerId":"stable provider id","enabled":"true/false","activationScope":"manual-test/beta/live","credentialRef":"secret reference only, never exposed","quotaPolicy":"daily/monthly/request-rate limits","cachePolicy":"allowed cache duration and storage scope","attributionPolicy":"required attribution string or link","vaultIngestionPolicy":"none/metadata-only/reference-card/full-if-licensed","capsuleCompressionPolicy":"disabled/review-only/enabled-if-approved","founderApprovalReceiptId":"linked founder approval receipt","productionMutation":"false until explicit activation"},"futureProviderHealthShape":{"providerId":"stable provider id","providerName":"human provider name","category":"provider category","healthStatus":"unknown/healthy/degraded/down/quota-limited/terms-review-required","latencyMs":"number","quotaRemaining":"number or unknown","checkedAt":"ISO timestamp","safeguard":"no credentials, tokens, private payloads, or raw provider secrets"},"safeguard":"Discovery Provider Registry Layer is read-only and non-destructive. It does not query providers, attach credentials, scrape sources, ingest Vault records, compress capsules, expose secrets, mutate production, or execute agent actions."}