UAPI Embedding Storage Contracts v0
Embedding jobs, Cortex boundary, storage capacity, and provider adapter contract baseline.
Promotion Metadata
- Source feedback id:
89 - Source feedback ids:
89 - Promotion request id:
23 - Feedback category:
beneficial - Feedback source:
ai-lane - Feedback created at:
2026-06-22T16:36:03.886596+00:00 - Target slug:
[REDACTED:high-entropy] - Review state:
review - Reviewer note: AI lane auto-promoted redacted feedback into internal catalog context.
Source Feedback Body
Feedback 89
- Product:
uapi - Category:
beneficial - Related slug:
[REDACTED:high-entropy] - Source:
ai-lane - Created at:
2026-06-22T16:36:03.886596+00:00
title: UAPI Embedding Storage Contracts v0 project: uapi kind: runbook state: draft tags: [docs, runbook, uapi, embeddings, storage]
UAPI Embedding Storage Contracts v0
Goal: UAPI owns embedding job placement and storage-serving contracts while Cortex stays bounded to memory, knowledge, and product intelligence.
EmbeddingJob fields: - embedding_job_id, created_by, source_product, source_context_ref. - source_type: Explorer context, document, code, event, artifact. - data_class and retention_policy. - chunk_policy: splitter, max tokens, overlap, metadata fields. - model_policy: model, dimension, route preference, fallback. - placement_decision_id and run_record_id. - destination: Cortex memory, Explorer search, product index, temporary cache. - refresh_policy and invalidation_refs.
CortexHandoff fields: - handoff_id, embedding_job_id, memory_namespace, allowed_products. - summary, provenance_refs, access_policy, expiry, recall_limits. - do_not_expand_boundary: true unless explicitly approved.
StorageCapacity fields: - capacity_id, friendly_name, storage_class, owner_product. - verified_device_or_pool, capacity_bytes, free_bytes, performance_notes. - serving_mode: archive, cache, model_store, artifact_store, vector_store. - retention_policy, encryption_state, backup_state, health_state. - verification_source and observed_at.
ProviderAdapter fields: - adapter_id, provider_type, route_name, auth_mode, supported_jobs. - health_check, dry_run_check, input_schema, output_schema. - timeout_policy, retry_policy, rate_limit, fallback_policy. - no_secret_log_policy and audit_event_policy.
Required checks: SN850X cannot be assigned until Grok verifies current status; embedding routes must record PlacementDecision; storage serving must reject unknown capacity ids; adapter logs must scan clean for secrets.