{"id":"vector-rank-by-cosine","version":"1.0.0","description":"Return the top matching candidate vectors by cosine score, with stable input-order ties.","supported_operations":["rank vectors by cosine similarity","find closest embeddings by cosine score","top matching vectors for a query embedding","sort candidate embeddings by angular similarity","score and rank vectors against one query","best cosine matches from supplied candidates"],"unsupported_operations":["create text embeddings","search a vector database","approximate nearest-neighbor indexing"],"semantics":["Query and candidate vectors must be non-empty, equal-length arrays of finite binary64 numbers.","Each score uses independent index-0-upward sums; higher scores rank first and equal scores retain input order.","top_k must not exceed the candidate count; omitted candidate ids are returned as null.","Any zero query or candidate vector produces not_computable.","Returned numbers are deterministic for this implementation but floating point, not exact decimals."],"limits":{"max_input_bytes":32768,"max_items":256,"max_candidates":128,"max_total_items":8192,"max_id_length":64,"max_iterations":32768,"max_output_bytes":24576},"pricing":{"status":"unpriced","charge_usd":null},"input_schema":{"type":"object","additionalProperties":false,"required":["query","candidates","top_k"],"properties":{"query":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"number"}},"candidates":{"type":"array","minItems":1,"maxItems":128,"items":{"type":"object","additionalProperties":false,"required":["vector"],"properties":{"id":{"type":"string","maxLength":64},"vector":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"number"}}}}},"top_k":{"type":"number","minimum":1,"maximum":128,"multipleOf":1}}},"output_schema":{"type":"object","additionalProperties":false,"required":["ranked","standard_version"],"properties":{"ranked":{"type":"array","minItems":1,"maxItems":128,"items":{"type":"object","additionalProperties":false,"required":["index","id","score"],"properties":{"index":{"type":"number","minimum":0,"maximum":127,"multipleOf":1},"id":{"type":["string","null"],"maxLength":64},"score":{"type":"number","minimum":-1,"maximum":1}}}},"standard_version":{"type":"string","const":"IEEE 754-2019 binary64; fixed left-to-right order"}}},"examples":[{"input":{"query":[1,0],"candidates":[{"id":"same","vector":[2,0]},{"id":"across","vector":[0,1]}],"top_k":1},"output":{"ranked":[{"index":0,"id":"same","score":1}],"standard_version":"IEEE 754-2019 binary64; fixed left-to-right order"}},{"input":{"query":[1,1],"candidates":[{"vector":[1,0]},{"id":"diag","vector":[2,2]}],"top_k":2},"output":{"ranked":[{"index":1,"id":"diag","score":0.9999999999999998},{"index":0,"id":null,"score":0.7071067811865475}],"standard_version":"IEEE 754-2019 binary64; fixed left-to-right order"}}],"execute_url":"/v1/tools/vector-rank-by-cosine/versions/1.0.0/execute"}