v37

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-1170194628.0 KB
v1
Graph

Producer endpoint -- text -> phases + signals + embeddings

Vector-store agnostic producer.

Returns everything you'd want to index in any vector DB -- base embedding, 14-band extracted signals, per-band SBERT/Qwen embeddings, phases, and optional rot_v3 / concat reconstructions.

Uses the SAME extraction + embedding path as /v1/graph/rerank uses for queries, so artifacts produced here can be scored by /v1/graph/rerank without any drift.

post/v1/graph/transform

Request body

textstring required

Source text to transform.

embeddingnumber[] nullable

Optional caller-provided base embedding (Qwen 2560-d). If omitted, the server computes it.

domain_idstring nullable

Domain shortname or full schema id controlling which frequency bands and extraction rules are used. Built-in shortnames: "general" (default), "code", "cosqa", "codetrans", "codetransocean", "codetransocean_hybrid", "text2sql", "scifact", "nfcorpus", "fiqa", "legal", "medical", "ecommerce", "coffee_shops". You can also pass a full schema id (e.g. "code_search:cosqa:2.0.0") or a custom domain_id registered via POST /v1/graph/domains.

metadataobject nullable

Free-form user metadata to attach (optional, not used for scoring).

signal_embedder'sbert' | 'qwen'

Embedder for per-band signal vectors. 'sbert' (384d, default) is ~10x cheaper to store than 'qwen' (2560d, matched to base).

return_rot_v3boolean

If true, include the rot_v3 vector in the response.

return_concatboolean

If true, include the base + bands concatenation embedding.

Response

Successful Response

phasesnumber[] required

Per-frequency phase angles (14-dim).

embeddingnumber[] required

Base embedding (normalized Qwen 2560-d).

signalsobject

Signal band-name -> extracted text (e.g. {'docstring': '...', 'function_name': '...'}).

signal_embeddingsobject

Signal band-name -> embedding vector (384-d sbert or 2560-d qwen).

rot_v3number[] nullable

Rotation v3 vector (only when return_rot_v3=true).

concat_embeddingnumber[] nullable

Base + bands concatenation (only when return_concat=true).

idstring required

Request id for log correlation.

domain_idstring required

Domain used for extraction.

metaobject

Timing and stats.