@functional-systems/lambdadb 0.6.0 → 0.7.0

package/dist/esm/models/rerank.d.ts

@@ -0,0 +1,37 @@
+/** Managed reranking DTOs, maintained manually following docs/OPENAPI_UPDATE.md. */
+import * as z from "zod/v3";
+/** Per-query fixed managed model; credentials are managed by the server. */
+export type RerankConfig = {
+    provider: "typesafe";
+    model: "jev-1.13.0";
+    /** Nonblank text, at most 8 KiB UTF-8; sent unchanged. */
+    queryText: string;
+    /** 1–8 unique stored scalar text paths, in model input order. */
+    fields: string[];
+    /** Defaults on the server to max(50, size); does not change knn.k. */
+    candidateSize?: number | null | undefined;
+    /** Server default: error. Only eligible provider failures can returnOriginal. */
+    onFailure?: "error" | "returnOriginal" | null | undefined;
+    /** 2–10 distinct nonblank descriptions, lowest to highest relevance; null uses defaults. */
+    criteria?: string[] | null | undefined;
+};
+export type RerankResponse = {
+    status: "applied" | "skipped" | "fallback";
+    provider: string;
+    model: string;
+    resolvedModel?: string | undefined;
+    candidateCount: number;
+    scoredCount: number;
+    /** Rerank stage duration in milliseconds. */
+    took: number;
+    /** Only applied results report this marker; custom is not a content identity. */
+    criteriaVersion?: "default-relevance-v1" | "custom" | undefined;
+    reason?: string | undefined;
+};
+/** @internal */
+export declare const RerankConfig$outboundSchema: z.ZodType<RerankConfig>;
+/** @internal */
+export declare const RerankResponse$inboundSchema: z.ZodType<RerankResponse, z.ZodTypeDef, unknown>;
+/** @internal: mirrors ManagedRerankService.hasScoringQuery for the existing wire DSL. */
+export declare function hasRerankScoringQuery(query: unknown): boolean;
+//# sourceMappingURL=rerank.d.ts.map

package/dist/esm/models/rerank.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rerank.d.ts","sourceRoot":"","sources":["../../../src/models/rerank.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,4EAA4E;AAC5E,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,EAAE,UAAU,CAAC;IACrB,KAAK,EAAE,YAAY,CAAC;IACpB,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC1C,iFAAiF;IACjF,SAAS,CAAC,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI,GAAG,SAAS,CAAC;IAC1D,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,eAAe,CAAC,EAAE,sBAAsB,GAAG,QAAQ,GAAG,SAAS,CAAC;IAChE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B,CAAC;AAQF,gBAAgB;AAChB,eAAO,MAAM,2BAA2B,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAiBrD,CAAC;AAEZ,gBAAgB;AAChB,eAAO,MAAM,4BAA4B,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,UAAU,EAAE,OAAO,CAUxF,CAAC;AAEH,yFAAyF;AACzF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAc7D"}

package/dist/esm/models/rerank.js

@@ -0,0 +1,49 @@
+/** Managed reranking DTOs, maintained manually following docs/OPENAPI_UPDATE.md. */
+import * as z from "zod/v3";
+import { nullToUndefined } from "../lib/schemas.js";
+// Match Java String.isBlank; do not trim or normalize caller text.
+// eslint-disable-next-line no-control-regex -- Java whitespace includes these control characters.
+const blank = /^[\u0009-\u000d\u001c-\u0020\u1680\u2000-\u2006\u2008-\u200a\u2028\u2029\u205f\u3000]*$/u;
+const nonblank = z.string().refine((text) => !blank.test(text), "Must be nonblank");
+const bytes = (text) => new TextEncoder().encode(text).length;
+/** @internal */
+export const RerankConfig$outboundSchema = z.object({
+    provider: z.literal("typesafe"),
+    model: z.literal("jev-1.13.0"),
+    queryText: nonblank.refine((text) => bytes(text) <= 8192, "queryText exceeds 8 KiB UTF-8"),
+    fields: z.array(nonblank.refine((path) => path.split(".").every((part) => !blank.test(part)), "Invalid field path")).min(1).max(8).refine((paths) => new Set(paths).size === paths.length, "Fields must be unique"),
+    candidateSize: z.number().int().min(1).max(100).nullable().optional(),
+    onFailure: z.enum(["error", "returnOriginal"]).nullable().optional(),
+    criteria: z.array(nonblank.refine((text) => bytes(text) <= 2048, "Criterion exceeds 2 KiB UTF-8")).min(2).max(10).refine((texts) => new Set(texts).size === texts.length, "Criteria must be distinct").refine((texts) => texts.reduce((total, text) => total + bytes(text), 0) <= 8192, "Criteria exceed 8 KiB total UTF-8").nullable().optional(),
+}).strict();
+/** @internal */
+export const RerankResponse$inboundSchema = z.object({
+    status: z.enum(["applied", "skipped", "fallback"]),
+    provider: z.string(),
+    model: z.string(),
+    resolvedModel: nullToUndefined(z.string().optional()),
+    candidateCount: z.number().int().nonnegative(),
+    scoredCount: z.number().int().nonnegative(),
+    took: z.number().int().nonnegative(),
+    criteriaVersion: nullToUndefined(z.enum(["default-relevance-v1", "custom"]).optional()),
+    reason: nullToUndefined(z.string().optional()),
+});
+/** @internal: mirrors ManagedRerankService.hasScoringQuery for the existing wire DSL. */
+export function hasRerankScoringQuery(query) {
+    if (query == null || typeof query !== "object" || Array.isArray(query))
+        return false;
+    const node = query;
+    const occur = typeof node["occur"] === "string" ? node["occur"].toUpperCase() : undefined;
+    if (occur === "FILTER" || occur === "MUST_NOT")
+        return false;
+    // Follow backend parser precedence for composite queries.
+    for (const key of ["bool", "rrf", "mm", "l2"]) {
+        // Undefined members are omitted by JSON serialization.
+        if (node[key] !== undefined) {
+            const children = node[key];
+            return Array.isArray(children) && children.some(hasRerankScoringQuery);
+        }
+    }
+    return ["queryString", "sparseVector", "knn"].some((key) => node[key] != null);
+}
+//# sourceMappingURL=rerank.js.map

package/dist/esm/models/rerank.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rerank.js","sourceRoot":"","sources":["../../../src/models/rerank.ts"],"names":[],"mappings":"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"}

package/dist/esm/types/public.d.ts

@@ -153,4 +153,5 @@ export declare function tagDetailsWithDates(details: TagDetailsModel): TagDetail
 /** @internal */
 export declare function aliasDetailsWithDate(details: AliasDetailsModel): AliasDetails;
 export type { FacetRequest, FacetBucket, FacetResult } from "../models/operations/querycollection.js";
+export type { RerankConfig, RerankResponse } from "../models/rerank.js";
 //# sourceMappingURL=public.d.ts.map

package/dist/esm/types/public.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../../src/types/public.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../../src/types/public.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EAAE,uBAAuB,IAAI,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AACjH,YAAY,EAAE,2BAA2B,IAAI,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AACrH,YAAY,EAAE,qBAAqB,IAAI,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACnG,YAAY,EAAE,qBAAqB,IAAI,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACnG,YAAY,EAAE,qBAAqB,IAAI,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACnG,YAAY,EAAE,yBAAyB,IAAI,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAE3G,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAC1F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,KAAK,EACV,YAAY,IAAI,iBAAiB,EACjC,QAAQ,EACR,SAAS,EACT,OAAO,EACP,aAAa,IAAI,kBAAkB,EACnC,eAAe,IAAI,oBAAoB,EACvC,UAAU,IAAI,eAAe,EAC7B,MAAM,EACP,MAAM,yBAAyB,CAAC;AAEjC,KAAK,oBAAoB,GACrB;IAAE,GAAG,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAAE,GACrE;IAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAC;IAAC,cAAc,CAAC,EAAE,KAAK,GAAG,SAAS,CAAA;CAAE,CAAC;AAEnE,0EAA0E;AAC1E,MAAM,MAAM,oBAAoB,GAAG,IAAI,CACrC,0BAA0B,EAC1B,KAAK,GAAG,gBAAgB,CACzB,GAAG,oBAAoB,CAAC;AAEzB,0EAA0E;AAC1E,MAAM,MAAM,cAAc,GAAG,IAAI,CAC/B,oBAAoB,EACpB,KAAK,GAAG,gBAAgB,CACzB,GAAG,oBAAoB,CAAC;AAEzB,yEAAyE;AACzE,MAAM,MAAM,aAAa,GAAG,IAAI,CAC9B,eAAe,EACf,MAAM,GAAG,WAAW,GAAG,gBAAgB,CACxC,GAAG;IACF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC7C,eAAe,CAAC,EAAE,OAAO,oBAAoB,EAAE,eAAe,GAAG,SAAS,CAAC;IAC3E,MAAM,CAAC,EAAE,OAAO,oBAAoB,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACtE,gDAAgD;IAChD,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC3B,CAAC;AAEF,4DAA4D;AAC5D,MAAM,MAAM,oBAAoB,GAAG,IAAI,CACrC,sBAAsB,EACtB,MAAM,GAAG,WAAW,CACrB,CAAC;AAGF,YAAY,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AACvF,YAAY,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACzF,YAAY,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AACnF,YAAY,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACzF,YAAY,EACV,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,yCAAyC,CAAC;AACjD,YAAY,EACV,gBAAgB,EAChB,WAAW,GACZ,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACzF,YAAY,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AAE3F,YAAY,EACV,QAAQ,EACR,WAAW,EACX,SAAS,EACT,YAAY,EACZ,mBAAmB,EACnB,OAAO,EACP,SAAS,EACT,MAAM,EACN,SAAS,GACV,MAAM,yBAAyB,CAAC;AAEjC,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,oBAAoB,EAAE,qBAAqB,CAAC,GAAG;IAChF,mBAAmB,EAAE,IAAI,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,kBAAkB,EAAE,WAAW,GAAG,cAAc,GAAG,gBAAgB,CAAC,GAAG;IACtG,YAAY,EAAE,eAAe,GAAG,IAAI,CAAC;IACrC,cAAc,EAAE,eAAe,GAAG,IAAI,CAAC;IACvC,SAAS,EAAE,IAAI,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,EAAE,WAAW,GAAG,qBAAqB,CAAC,GAAG;IACpF,mBAAmB,EAAE,IAAI,CAAC;IAC1B,SAAS,EAAE,IAAI,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,iBAAiB,EAAE,WAAW,CAAC,GAAG;IAChE,SAAS,EAAE,IAAI,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,MAAM,CAAC,EAAE,OAAO,yBAAyB,EAAE,YAAY,GAAG,SAAS,CAAC;CACrE,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE,CAAC;AAC7D,MAAM,MAAM,oBAAoB,GAAG;IAAE,QAAQ,EAAE,aAAa,EAAE,CAAA;CAAE,CAAC;AAEjE,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,yBAAyB,EAAE,SAAS,GAAG,SAAS,CAAC;CAClE,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAAE,GAAG,EAAE,UAAU,CAAA;CAAE,CAAC;AACpD,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC;AAEtD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,yBAAyB,EAAE,WAAW,CAAC;CACvD,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,OAAO,yBAAyB,EAAE,WAAW,CAAC;CACvD,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAAE,KAAK,EAAE,YAAY,CAAA;CAAE,CAAC;AACpD,MAAM,MAAM,mBAAmB,GAAG;IAAE,OAAO,EAAE,YAAY,EAAE,CAAA;CAAE,CAAC;AAC9D,MAAM,MAAM,kBAAkB,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAGjE,YAAY,EACV,iBAAiB,EACjB,kCAAkC,EAClC,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,KAAK,EAAE,kBAAkB,IAAI,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AACxF,OAAO,KAAK,EACV,wBAAwB,IAAI,6BAA6B,EAC1D,MAAM,0CAA0C,CAAC;AAElD;;;GAGG;AACH,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAC5C,uBAAuB,EACvB,WAAW,GAAG,WAAW,GAAG,eAAe,CAC5C,GAAG;IACF,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,aAAa,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;CAClC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gCAAgC,GAAG;IAC7C,WAAW,EAAE,2BAA2B,EAAE,CAAC;IAC3C,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,CAAC,EAAE,uBAAuB,GACzB,2BAA2B,CAU7B;AAED,yEAAyE;AACzE,wBAAgB,gCAAgC,CAAC,GAAG,EAAE;IACpD,WAAW,EAAE,uBAAuB,EAAE,CAAC;IACvC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,GAAG,gCAAgC,CAMnC;AAED,6DAA6D;AAC7D,MAAM,MAAM,8BAA8B,GAAG;IAC3C,UAAU,EAAE,2BAA2B,CAAC;CACzC,CAAC;AAEF,uEAAuE;AACvE,wBAAgB,8BAA8B,CAAC,GAAG,EAAE;IAClD,UAAU,EAAE,uBAAuB,CAAC;CACrC,GAAG,8BAA8B,CAEjC;AAED,+DAA+D;AAC/D,MAAM,MAAM,iCAAiC,GAAG,8BAA8B,CAAC;AAE/E,wBAAgB,iCAAiC,CAAC,GAAG,EAAE;IACrD,UAAU,EAAE,uBAAuB,CAAC;CACrC,GAAG,iCAAiC,CAEpC;AAED,6EAA6E;AAC7E,MAAM,MAAM,iCAAiC,GAAG;IAC9C,UAAU,EAAE,IAAI,CAAC,6BAA6B,CAAC,YAAY,CAAC,EAAE,WAAW,CAAC,GAAG;QAC3E,SAAS,EAAE,IAAI,CAAC;KACjB,CAAC;CACH,CAAC;AAEF,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,6BAA6B,GACtC,iCAAiC,CAOnC;AAED,gBAAgB;AAChB,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,oBAAoB,GAAG,eAAe,CAEtF;AAED,gBAAgB;AAChB,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,kBAAkB,GAAG,aAAa,CAOjF;AAED,gBAAgB;AAChB,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,UAAU,CAMxE;AAED,gBAAgB;AAChB,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,GAAG,YAAY,CAE7E;AAED,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAEtG,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/jsr.json

@@ -2,7 +2,7 @@
 
 {
   "name": "@functional-systems/lambdadb",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "exports": {
     ".": "./src/index.ts",    
     "./models/errors": "./src/models/errors/index.ts",    

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@functional-systems/lambdadb",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "author": "Functional Systems, Inc.",
   "homepage": "https://github.com/lambdadb/lambdadb-typescript-client#readme",
   "license": "Apache-2.0",

package/src/compat/qdrant/conversions.ts

@@ -328,6 +328,12 @@ function payloadSchemaType(rawSchema: unknown): string {
   if (typeof rawSchema === "string") {
     rawType = rawSchema;
   } else if (isObject(rawSchema) && "type" in rawSchema) {
+    const unsupportedOptions = Object.keys(rawSchema).filter((key) => key !== "type");
+    if (unsupportedOptions.length > 0) {
+      throw new UnsupportedQdrantFeatureError(
+        `Unsupported Qdrant payload schema options: ${unsupportedOptions.join(", ")}. Use the native SDK for LambdaDB analyzer presets.`,
+      );
+    }
     rawType = String(rawSchema["type"]);
   } else {
     throw new QdrantCompatValidationError(

package/src/lib/config.ts

@@ -73,8 +73,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "1.1.1",
-  sdkVersion: "0.6.0",
+  sdkVersion: "0.7.0",
   genVersion: "2.798.0",
   userAgent:
-    "speakeasy-sdk/typescript 0.6.0 2.798.0 1.1.1 @functional-systems/lambdadb",
+    "speakeasy-sdk/typescript 0.7.0 2.798.0 1.1.1 @functional-systems/lambdadb",
 } as const;

package/src/models/index.ts

@@ -11,3 +11,4 @@ export * from "./partitionfilter.js";
 export * from "./security.js";
 export * from "./status.js";
 export * from "./versioning.js";
+export * from "./rerank.js";

package/src/models/indexconfigsunion.ts

@@ -119,6 +119,39 @@ export const Analyzer = {
   Russian: "russian",
   Spanish: "spanish",
   Turkish: "turkish",
+  Armenian: "armenian",
+  Basque: "basque",
+  Bengali: "bengali",
+  Brazilian: "brazilian",
+  Bulgarian: "bulgarian",
+  Catalan: "catalan",
+  Czech: "czech",
+  Danish: "danish",
+  Dutch: "dutch",
+  Estonian: "estonian",
+  Finnish: "finnish",
+  Galician: "galician",
+  Greek: "greek",
+  Hungarian: "hungarian",
+  Irish: "irish",
+  Latvian: "latvian",
+  Lithuanian: "lithuanian",
+  Norwegian: "norwegian",
+  Persian: "persian",
+  Romanian: "romanian",
+  Serbian: "serbian",
+  Sorani: "sorani",
+  Swedish: "swedish",
+  Thai: "thai",
+  Simple: "simple",
+  Whitespace: "whitespace",
+  Stop: "stop",
+  Keyword: "keyword",
+  Pattern: "pattern",
+  Fingerprint: "fingerprint",
+  Nepali: "nepali",
+  Tamil: "tamil",
+  Telugu: "telugu",
 } as const;
 export type Analyzer = ClosedEnum<typeof Analyzer>;
 

package/src/models/operations/querycollection.ts

@@ -1,5 +1,5 @@
 /*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * Maintained manually following docs/OPENAPI_UPDATE.md.
  */
 
 import * as z from "zod/v3";
@@ -8,6 +8,7 @@ import { nullToUndefined, safeParse } from "../../lib/schemas.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 import * as models from "../index.js";
+import { hasRerankScoringQuery } from "../rerank.js";
 
 export type FacetRequest = {
   /** Maximum buckets to return (1–100). Omitted or null uses the server default of 10. */
@@ -26,6 +27,8 @@ export type QueryCollectionRequestBody = {
    */
   query?: { [k: string]: any } | undefined;
   facets?: Record<string, FacetRequest> | undefined;
+  /** Optional per-query managed reranking. Omitted or null preserves retrieval behavior. */
+  rerank?: models.RerankConfig | null | undefined;
   /**
    * Overlay eligible pending writes on a directly selected Branch. Tag and Alias reads reject true, pending bulk imports are excluded, and an oversized pending overlay can return HTTP 429.
    */
@@ -61,9 +64,11 @@ export type QueryCollectionDoc = {
    */
   collection: string;
   /**
-   * Document similarity score.
+   * Final ranking score: evaluation score in [0,1] when rerank is applied, otherwise retrieval score.
    */
   score?: number | undefined;
+  /** Original retrieval/fusion score, outside doc; present only when rerank is applied. */
+  retrievalScore?: number | undefined;
   doc: { [k: string]: any };
 };
 
@@ -71,13 +76,15 @@ export type QueryCollectionDoc = {
  * Documents selected by query.
  */
 export type QueryCollectionResponse = {
+  /** Present only for requests using reranking. */
+  rerank?: models.RerankResponse | undefined;
   facets?: Record<string, FacetResult> | undefined;
   /**
    * Elapsed time in milliseconds.
    */
   took: number;
   /**
-   * Maximum score.
+   * Maximum final returned score, including zero; omitted for empty rerank results.
    */
   maxScore?: number | undefined;
   /**
@@ -103,6 +110,8 @@ export type QueryCollectionRequestBody$Outbound = {
   size?: number | undefined;
   query?: { [k: string]: any } | undefined;
   facets?: Record<string, FacetRequest> | undefined;
+  /** Optional per-query managed reranking. Omitted or null preserves retrieval behavior. */
+  rerank?: models.RerankConfig | null | undefined;
   consistentRead: boolean;
   includeVectors: boolean;
   sort?: Array<{ [k: string]: any }> | undefined;
@@ -124,6 +133,7 @@ export const QueryCollectionRequestBody$outboundSchema: z.ZodType<
   }).strict()).refine((facets) => Object.keys(facets).length <= 5, {
     message: "At most five facet fields may be requested",
   }).optional(),
+  rerank: models.RerankConfig$outboundSchema.nullable().optional(),
   consistentRead: z.boolean().default(false),
   includeVectors: z.boolean().default(false),
   sort: z.array(z.record(z.any())).optional(),
@@ -131,6 +141,31 @@ export const QueryCollectionRequestBody$outboundSchema: z.ZodType<
   partitionFilter: models.PartitionFilter$outboundSchema.optional(),
   ref: models.ReadRef$schema.optional(),
 }).strict().superRefine((value, context) => {
+  if (value.rerank != null) {
+    const size = value.size ?? 10;
+    const candidateSize = value.rerank.candidateSize ?? Math.max(50, size);
+    if (size < 1 || size > 100 || candidateSize < size) {
+      context.addIssue({
+        code: z.ZodIssueCode.custom,
+        message: "rerank requires 1 <= size <= candidateSize <= 100",
+        path: ["rerank", "candidateSize"],
+      });
+    }
+    if (value.sort !== undefined) {
+      context.addIssue({
+        code: z.ZodIssueCode.custom,
+        message: "rerank cannot be combined with sort",
+        path: ["sort"],
+      });
+    }
+    if (!hasRerankScoringQuery(value.query)) {
+      context.addIssue({
+        code: z.ZodIssueCode.custom,
+        message: "rerank requires a scoring retrieval query",
+        path: ["query"],
+      });
+    }
+  }
   if (value.size === 0 && Object.keys(value.facets ?? {}).length === 0) {
     context.addIssue({
       code: z.ZodIssueCode.custom,
@@ -191,6 +226,7 @@ export const QueryCollectionDoc$inboundSchema: z.ZodType<
 > = z.object({
   collection: z.string(),
   score: nullToUndefined(z.number().optional()),
+  retrievalScore: nullToUndefined(z.number().optional()),
   doc: z.record(z.any()),
 });
 
@@ -210,6 +246,7 @@ export const QueryCollectionResponse$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
+  rerank: nullToUndefined(models.RerankResponse$inboundSchema.optional()),
   took: z.number().int(),
   maxScore: nullToUndefined(z.number().optional()),
   total: z.number().int(),

package/src/models/rerank.ts

@@ -0,0 +1,89 @@
+/** Managed reranking DTOs, maintained manually following docs/OPENAPI_UPDATE.md. */
+import * as z from "zod/v3";
+import { nullToUndefined } from "../lib/schemas.js";
+
+/** Per-query fixed managed model; credentials are managed by the server. */
+export type RerankConfig = {
+  provider: "typesafe";
+  model: "jev-1.13.0";
+  /** Nonblank text, at most 8 KiB UTF-8; sent unchanged. */
+  queryText: string;
+  /** 1–8 unique stored scalar text paths, in model input order. */
+  fields: string[];
+  /** Defaults on the server to max(50, size); does not change knn.k. */
+  candidateSize?: number | null | undefined;
+  /** Server default: error. Only eligible provider failures can returnOriginal. */
+  onFailure?: "error" | "returnOriginal" | null | undefined;
+  /** 2–10 distinct nonblank descriptions, lowest to highest relevance; null uses defaults. */
+  criteria?: string[] | null | undefined;
+};
+
+export type RerankResponse = {
+  status: "applied" | "skipped" | "fallback";
+  provider: string;
+  model: string;
+  resolvedModel?: string | undefined;
+  candidateCount: number;
+  scoredCount: number;
+  /** Rerank stage duration in milliseconds. */
+  took: number;
+  /** Only applied results report this marker; custom is not a content identity. */
+  criteriaVersion?: "default-relevance-v1" | "custom" | undefined;
+  reason?: string | undefined;
+};
+
+// Match Java String.isBlank; do not trim or normalize caller text.
+// eslint-disable-next-line no-control-regex -- Java whitespace includes these control characters.
+const blank = /^[\u0009-\u000d\u001c-\u0020\u1680\u2000-\u2006\u2008-\u200a\u2028\u2029\u205f\u3000]*$/u;
+const nonblank = z.string().refine((text) => !blank.test(text), "Must be nonblank");
+const bytes = (text: string) => new TextEncoder().encode(text).length;
+
+/** @internal */
+export const RerankConfig$outboundSchema: z.ZodType<RerankConfig> = z.object({
+  provider: z.literal("typesafe"),
+  model: z.literal("jev-1.13.0"),
+  queryText: nonblank.refine((text) => bytes(text) <= 8192, "queryText exceeds 8 KiB UTF-8"),
+  fields: z.array(nonblank.refine(
+    (path) => path.split(".").every((part) => !blank.test(part)), "Invalid field path",
+  )).min(1).max(8).refine((paths) => new Set(paths).size === paths.length, "Fields must be unique"),
+  candidateSize: z.number().int().min(1).max(100).nullable().optional(),
+  onFailure: z.enum(["error", "returnOriginal"]).nullable().optional(),
+  criteria: z.array(nonblank.refine(
+    (text) => bytes(text) <= 2048, "Criterion exceeds 2 KiB UTF-8",
+  )).min(2).max(10).refine(
+    (texts) => new Set(texts).size === texts.length, "Criteria must be distinct",
+  ).refine(
+    (texts) => texts.reduce((total, text) => total + bytes(text), 0) <= 8192,
+    "Criteria exceed 8 KiB total UTF-8",
+  ).nullable().optional(),
+}).strict();
+
+/** @internal */
+export const RerankResponse$inboundSchema: z.ZodType<RerankResponse, z.ZodTypeDef, unknown> = z.object({
+  status: z.enum(["applied", "skipped", "fallback"]),
+  provider: z.string(),
+  model: z.string(),
+  resolvedModel: nullToUndefined(z.string().optional()),
+  candidateCount: z.number().int().nonnegative(),
+  scoredCount: z.number().int().nonnegative(),
+  took: z.number().int().nonnegative(),
+  criteriaVersion: nullToUndefined(z.enum(["default-relevance-v1", "custom"]).optional()),
+  reason: nullToUndefined(z.string().optional()),
+});
+
+/** @internal: mirrors ManagedRerankService.hasScoringQuery for the existing wire DSL. */
+export function hasRerankScoringQuery(query: unknown): boolean {
+  if (query == null || typeof query !== "object" || Array.isArray(query)) return false;
+  const node = query as Record<string, unknown>;
+  const occur = typeof node["occur"] === "string" ? node["occur"].toUpperCase() : undefined;
+  if (occur === "FILTER" || occur === "MUST_NOT") return false;
+  // Follow backend parser precedence for composite queries.
+  for (const key of ["bool", "rrf", "mm", "l2"]) {
+    // Undefined members are omitted by JSON serialization.
+    if (node[key] !== undefined) {
+      const children = node[key];
+      return Array.isArray(children) && children.some(hasRerankScoringQuery);
+    }
+  }
+  return ["queryString", "sparseVector", "knn"].some((key) => node[key] != null);
+}

package/src/types/public.ts

@@ -275,3 +275,5 @@ export function aliasDetailsWithDate(details: AliasDetailsModel): AliasDetails {
 }
 
 export type { FacetRequest, FacetBucket, FacetResult } from "../models/operations/querycollection.js";
+
+export type { RerankConfig, RerankResponse } from "../models/rerank.js";