Resources

What's new

SDK releases, API changes, and notable improvements to Aether.

June 2026 — Search score contract and SDK-first docs

The search docs were aligned to the checked-in engine and SDK contract.

API

  • Search hits carry score (0-100, higher is better), passage when available, and optional inline content when requested.
  • GET /search, POST /search/embed, and POST /search/batch remain the REST contract underneath the SDKs.

SDKs

  • SearchResult exposes score, title, content_type, optional content, and optional passage.
  • retrieve() remains the recommended method for RAG because it returns content; search() remains the lighter metadata/passage primitive.

Migrating

  • Read result.score; higher is better.
  • Call retrieve() when you need document text.
  • Use SDK-level over-retrieval plus client-side score filtering unless you are deliberately working at the REST contract layer.

June 2026 — Server-side max_distance filter

API

  • /search, /search/batch, and /search/embed accept an optional max_distance parameter for advanced distance-threshold filtering before scored results are returned. The default behavior is unchanged — omit the parameter to keep returning the top-k. See Filtering weak matches.

All SDKs

  • SDK convenience methods do not expose max_distance consistently in this checkout. Prefer SDK-level filtering by score; use REST max_distance only when intentionally working at the HTTP contract layer.

June 2026 — Retrieval polish

Docs

  • New Tuning retrieval guide covering k selection, score interpretation, client-side filtering, reranking, and when to reach for search() vs retrieve().
  • 5-minute RAG quickstart rewritten to use retrieve() end-to-end across all four SDKs — no more double search or include_content flag.

.NET SDK (Aether.Sdk)

  • RetrieveAsync and RetrievalResult are available. The earlier "not yet implemented" notice in the docs was stale — the method has been shipped and is the recommended way to do RAG in C#.

April 2026 — Beta release

API

  • Public beta of the Aether hosted API. Stable endpoint versioning guaranteed from this release forward.
  • Async document ingestion now supports PDF, DOCX, PPTX, and XLSX (previously text-only for async jobs).
  • The REST delete endpoint accepts ?hard=true for permanent, irreversible removal. The SDK delete() helpers are unchanged — they remain reversible tombstones, with no hard-delete flag yet.

Python SDK (aether-ai)

  • retrieve() now returns RetrievalResult objects with a .content field — no separate download() call required for RAG pipelines.
  • insert_async() now accepts file paths directly in addition to file handles.

TypeScript SDK (@aether-ai/sdk)

  • Full ESM and CommonJS builds. No more require() interop hacks for Next.js projects.
  • retrieve() added — equivalent to Python SDK.
  • All methods now accept an AbortSignal for request cancellation.

Go SDK (github.com/quintessence-group/aether-sdk-go)

  • Retrieve() added — combines Search and Download in a single round trip.
  • Context propagation hardened: all methods respect cancellation from ctx.Done().

.NET SDK (Aether.Sdk)

  • Initial beta of the .NET SDK with insert, list, get, delete, restore, search, and status.

March 2026 — Developer preview

  • Initial developer preview of all four SDKs (Python, TypeScript, Go, C#).
  • Hosted API available to invited beta testers.
  • Semantic Kernel, LangChain, LlamaIndex, and CrewAI integrations documented.

This changelog covers the Aether API and official SDKs.