@ingram-cloud/sdk 1.8.0 → 1.10.0

package/dist/zod/tenant.js

@@ -194,11 +194,14 @@ export const ModelsListOut = z
     providers: z.array(ModelProviderOut),
 })
     .meta({ id: "ModelsListOut" });
-/** A BYOK model key — the `api_key` is NEVER echoed, only its presence. */
+/** A BYOK model key — the `api_key` is NEVER echoed, only its presence.
+ *  `workspace_id` is Anthropic's `anthropic-workspace-id`: required by an
+ *  identity-linked (multi-workspace) key, implicit in a workspace-scoped one. */
 export const ModelKeyOut = z
     .object({
     provider: z.string(),
     base_url: z.string().nullable(),
+    workspace_id: z.string().nullable(),
     has_key: z.boolean(),
     updated_at: z.string().nullable(),
 })
@@ -206,18 +209,21 @@ export const ModelKeyOut = z
 export const ModelKeyListOut = z
     .object({ data: z.array(ModelKeyOut) })
     .meta({ id: "ModelKeyListOut" });
-/** The PUT ack — never echoes the key, only presence + the (non-secret) base_url. */
+/** The PUT ack — never echoes the key, only presence + the non-secret
+ *  `base_url` / `workspace_id`. */
 export const ModelKeyConfiguredOut = z
     .object({
     provider: z.string(),
     configured: z.boolean(),
     base_url: z.string().nullable(),
+    workspace_id: z.string().nullable(),
 })
     .meta({ id: "ModelKeyConfiguredOut" });
 export const ModelKeyIn = z
     .object({
     api_key: z.string(),
     base_url: z.string().nullish(),
+    workspace_id: z.string().nullish(),
 })
     .meta({ id: "ModelKeyIn" });
 // ── Providers (tenant OAuth client credentials) ──────────────────────────────

package/dist/zod/vector-stores.js

@@ -229,23 +229,37 @@ export const VectorStoreFileBatchOut = z
 })
     .meta({ id: "VectorStoreFileBatchOut" });
 // ── Search ───────────────────────────────────────────────────────────────────
+/** OpenAI's `ranking_options`. `hybrid_search` turns on reciprocal-rank fusion
+ *  of the embedding ranking with a full-text (keyword) ranking, weighted as
+ *  given; without it search is embedding-only. */
+export const VectorStoreRankingOptions = z
+    .object({
+    score_threshold: z.number().min(0).max(1).optional(),
+    hybrid_search: z
+        .object({
+        embedding_weight: z.number().min(0),
+        text_weight: z.number().min(0),
+    })
+        .refine((w) => w.embedding_weight > 0 || w.text_weight > 0, {
+        message: "at least one weight must be positive",
+    })
+        .optional(),
+})
+    .meta({ id: "VectorStoreRankingOptions" });
 export const VectorStoreSearchIn = z
     .object({
     query: z.union([z.string().min(1), z.array(z.string().min(1)).min(1)]),
     max_num_results: z.number().int().min(1).max(50).optional(),
     filters: VectorStoreFilter.nullish(),
-    ranking_options: z
-        .object({
-        score_threshold: z.number().min(0).max(1).optional(),
-    })
-        .optional(),
+    ranking_options: VectorStoreRankingOptions.optional(),
 })
     .meta({ id: "VectorStoreSearchIn" });
 export const VectorStoreSearchResult = z
     .object({
     file_id: z.string(),
     filename: z.string(),
-    /** Cosine similarity in [0, 1]. */
+    /** In [0, 1]: cosine similarity, or — with `hybrid_search` — the fused
+     *  reciprocal-rank score (1 = first in both rankings). */
     score: z.number(),
     attributes: VectorStoreAttributes.nullable(),
     content: z.array(z.object({ type: z.literal("text"), text: z.string() })),

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ingram-cloud/sdk",
-	"version": "1.8.0",
+	"version": "1.10.0",
 	"description": "Typed wire contract + management-plane client for the Ingram Cloud API: Zod schemas to validate request/response bodies, TypeScript types for the JSON you read back, SSE/webhook event types, and a typed REST client.",
 	"keywords": [
 		"api",

package/ts/zod/tenant.ts

@@ -226,11 +226,14 @@ export const ModelsListOut = z
 	})
 	.meta({ id: "ModelsListOut" });
 
-/** A BYOK model key — the `api_key` is NEVER echoed, only its presence. */
+/** A BYOK model key — the `api_key` is NEVER echoed, only its presence.
+ *  `workspace_id` is Anthropic's `anthropic-workspace-id`: required by an
+ *  identity-linked (multi-workspace) key, implicit in a workspace-scoped one. */
 export const ModelKeyOut = z
 	.object({
 		provider: z.string(),
 		base_url: z.string().nullable(),
+		workspace_id: z.string().nullable(),
 		has_key: z.boolean(),
 		updated_at: z.string().nullable(),
 	})
@@ -240,12 +243,14 @@ export const ModelKeyListOut = z
 	.object({ data: z.array(ModelKeyOut) })
 	.meta({ id: "ModelKeyListOut" });
 
-/** The PUT ack — never echoes the key, only presence + the (non-secret) base_url. */
+/** The PUT ack — never echoes the key, only presence + the non-secret
+ *  `base_url` / `workspace_id`. */
 export const ModelKeyConfiguredOut = z
 	.object({
 		provider: z.string(),
 		configured: z.boolean(),
 		base_url: z.string().nullable(),
+		workspace_id: z.string().nullable(),
 	})
 	.meta({ id: "ModelKeyConfiguredOut" });
 
@@ -253,6 +258,7 @@ export const ModelKeyIn = z
 	.object({
 		api_key: z.string(),
 		base_url: z.string().nullish(),
+		workspace_id: z.string().nullish(),
 	})
 	.meta({ id: "ModelKeyIn" });
 

package/ts/zod/vector-stores.ts

@@ -268,16 +268,30 @@ export const VectorStoreFileBatchOut = z
 
 // ── Search ───────────────────────────────────────────────────────────────────
 
+/** OpenAI's `ranking_options`. `hybrid_search` turns on reciprocal-rank fusion
+ *  of the embedding ranking with a full-text (keyword) ranking, weighted as
+ *  given; without it search is embedding-only. */
+export const VectorStoreRankingOptions = z
+	.object({
+		score_threshold: z.number().min(0).max(1).optional(),
+		hybrid_search: z
+			.object({
+				embedding_weight: z.number().min(0),
+				text_weight: z.number().min(0),
+			})
+			.refine((w) => w.embedding_weight > 0 || w.text_weight > 0, {
+				message: "at least one weight must be positive",
+			})
+			.optional(),
+	})
+	.meta({ id: "VectorStoreRankingOptions" });
+
 export const VectorStoreSearchIn = z
 	.object({
 		query: z.union([z.string().min(1), z.array(z.string().min(1)).min(1)]),
 		max_num_results: z.number().int().min(1).max(50).optional(),
 		filters: VectorStoreFilter.nullish(),
-		ranking_options: z
-			.object({
-				score_threshold: z.number().min(0).max(1).optional(),
-			})
-			.optional(),
+		ranking_options: VectorStoreRankingOptions.optional(),
 	})
 	.meta({ id: "VectorStoreSearchIn" });
 
@@ -285,7 +299,8 @@ export const VectorStoreSearchResult = z
 	.object({
 		file_id: z.string(),
 		filename: z.string(),
-		/** Cosine similarity in [0, 1]. */
+		/** In [0, 1]: cosine similarity, or — with `hybrid_search` — the fused
+		 *  reciprocal-rank score (1 = first in both rankings). */
 		score: z.number(),
 		attributes: VectorStoreAttributes.nullable(),
 		content: z.array(z.object({ type: z.literal("text"), text: z.string() })),