@qvac/sdk 0.9.2 → 0.10.0

package/dist/schemas/load-model.js

@@ -25,7 +25,7 @@ const loadModelRequestCommonFields = {
     logger: z.unknown().optional(),
     withProgress: z.boolean().optional(),
 };
-export const loadModelOptionsBaseSchema = z.union([
+export const loadBuiltinModelOptionsBaseSchema = z.union([
     z
         .object({
         ...loadModelCommonFields,
@@ -82,14 +82,18 @@ export const loadModelOptionsBaseSchema = z.union([
         modelConfig: sdcppConfigSchema.strict().optional(),
     })
         .strict(),
-    // Custom plugin catch-all: accepts any modelType string EXCEPT built-ins
-    z.object({
-        ...loadModelCommonFields,
-        modelType: z.string().refine((val) => !builtInModelTypes.has(val), {
-            message: "Built-in model types must use their specific schema",
-        }),
-        modelConfig: z.record(z.string(), z.unknown()).optional(),
+]);
+// Custom plugin catch-all: any modelType string EXCEPT built-ins.
+export const loadCustomPluginModelOptionsBaseSchema = z.object({
+    ...loadModelCommonFields,
+    modelType: z.string().refine((val) => !builtInModelTypes.has(val), {
+        message: "Built-in model types must use their specific schema",
     }),
+    modelConfig: z.record(z.string(), z.unknown()).optional(),
+});
+export const loadModelOptionsBaseSchema = z.union([
+    loadBuiltinModelOptionsBaseSchema,
+    loadCustomPluginModelOptionsBaseSchema,
 ]);
 export const loadModelOptionsSchema = loadModelOptionsBaseSchema.transform((data) => ({
     ...data,
@@ -176,13 +180,15 @@ const loadModelOptionsToRequestBaseSchema = z.union([
         modelType: ModelType.nmtcppTranslation,
         modelSrc: modelInputToSrcSchema.parse(data.modelSrc),
         modelName: modelInputToNameSchema.parse(data.modelSrc),
-        modelConfig: (data.modelConfig.engine === "Bergamot" && data.modelConfig.pivotModel) ? {
-            ...data.modelConfig,
-            pivotModel: {
-                ...data.modelConfig.pivotModel,
-                modelSrc: modelInputToSrcSchema.parse(data.modelConfig.pivotModel.modelSrc),
-            },
-        } : data.modelConfig,
+        modelConfig: data.modelConfig.engine === "Bergamot" && data.modelConfig.pivotModel
+            ? {
+                ...data.modelConfig,
+                pivotModel: {
+                    ...data.modelConfig.pivotModel,
+                    modelSrc: modelInputToSrcSchema.parse(data.modelConfig.pivotModel.modelSrc),
+                },
+            }
+            : data.modelConfig,
         seed: data.seed ?? false,
         withProgress: data.withProgress ?? !!data.onProgress,
         delegate: data.delegate,
@@ -368,8 +374,9 @@ export const modelProgressUpdateSchema = z.object({
         overallPercentage: z.number(),
     })
         .optional(),
-    onnxInfo: z
+    fileSetInfo: z
         .object({
+        setKey: z.string(),
         currentFile: z.string(),
         fileIndex: z.number(),
         totalFiles: z.number(),

package/dist/schemas/model-src-utils.d.ts

@@ -11,6 +11,7 @@ export declare const modelDescriptorSchema: z.ZodObject<{
     expectedSize: z.ZodOptional<z.ZodNumber>;
     sha256Checksum: z.ZodOptional<z.ZodString>;
     addon: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        embeddings: "embeddings";
         "llamacpp-completion": "llamacpp-completion";
         "whispercpp-transcription": "whispercpp-transcription";
         "llamacpp-embedding": "llamacpp-embedding";
@@ -21,7 +22,6 @@ export declare const modelDescriptorSchema: z.ZodObject<{
         "sdcpp-generation": "sdcpp-generation";
         llm: "llm";
         whisper: "whisper";
-        embeddings: "embeddings";
         nmt: "nmt";
         parakeet: "parakeet";
         tts: "tts";
@@ -41,6 +41,7 @@ export declare const modelSrcInputSchema: z.ZodUnion<readonly [z.ZodString, z.Zo
     expectedSize: z.ZodOptional<z.ZodNumber>;
     sha256Checksum: z.ZodOptional<z.ZodString>;
     addon: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        embeddings: "embeddings";
         "llamacpp-completion": "llamacpp-completion";
         "whispercpp-transcription": "whispercpp-transcription";
         "llamacpp-embedding": "llamacpp-embedding";
@@ -51,7 +52,6 @@ export declare const modelSrcInputSchema: z.ZodUnion<readonly [z.ZodString, z.Zo
         "sdcpp-generation": "sdcpp-generation";
         llm: "llm";
         whisper: "whisper";
-        embeddings: "embeddings";
         nmt: "nmt";
         parakeet: "parakeet";
         tts: "tts";
@@ -77,6 +77,7 @@ export declare const modelInputToSrcSchema: z.ZodPipe<z.ZodUnion<readonly [z.Zod
     expectedSize: z.ZodOptional<z.ZodNumber>;
     sha256Checksum: z.ZodOptional<z.ZodString>;
     addon: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        embeddings: "embeddings";
         "llamacpp-completion": "llamacpp-completion";
         "whispercpp-transcription": "whispercpp-transcription";
         "llamacpp-embedding": "llamacpp-embedding";
@@ -87,7 +88,6 @@ export declare const modelInputToSrcSchema: z.ZodPipe<z.ZodUnion<readonly [z.Zod
         "sdcpp-generation": "sdcpp-generation";
         llm: "llm";
         whisper: "whisper";
-        embeddings: "embeddings";
         nmt: "nmt";
         parakeet: "parakeet";
         tts: "tts";
@@ -105,7 +105,7 @@ export declare const modelInputToSrcSchema: z.ZodPipe<z.ZodUnion<readonly [z.Zod
     engine?: string | undefined;
     expectedSize?: number | undefined;
     sha256Checksum?: string | undefined;
-    addon?: "llamacpp-completion" | "whispercpp-transcription" | "llamacpp-embedding" | "nmtcpp-translation" | "onnx-tts" | "parakeet-transcription" | "onnx-ocr" | "sdcpp-generation" | "llm" | "whisper" | "embeddings" | "nmt" | "parakeet" | "tts" | "ocr" | "diffusion" | "vad" | undefined;
+    addon?: "embeddings" | "llamacpp-completion" | "whispercpp-transcription" | "llamacpp-embedding" | "nmtcpp-translation" | "onnx-tts" | "parakeet-transcription" | "onnx-ocr" | "sdcpp-generation" | "llm" | "whisper" | "nmt" | "parakeet" | "tts" | "ocr" | "diffusion" | "vad" | undefined;
 }>>;
 /**
  * Schema that transforms ModelSrc to its optional name
@@ -123,6 +123,7 @@ export declare const modelInputToNameSchema: z.ZodPipe<z.ZodUnion<readonly [z.Zo
     expectedSize: z.ZodOptional<z.ZodNumber>;
     sha256Checksum: z.ZodOptional<z.ZodString>;
     addon: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        embeddings: "embeddings";
         "llamacpp-completion": "llamacpp-completion";
         "whispercpp-transcription": "whispercpp-transcription";
         "llamacpp-embedding": "llamacpp-embedding";
@@ -133,7 +134,6 @@ export declare const modelInputToNameSchema: z.ZodPipe<z.ZodUnion<readonly [z.Zo
         "sdcpp-generation": "sdcpp-generation";
         llm: "llm";
         whisper: "whisper";
-        embeddings: "embeddings";
         nmt: "nmt";
         parakeet: "parakeet";
         tts: "tts";
@@ -151,6 +151,7 @@ export declare const modelInputToNameSchema: z.ZodPipe<z.ZodUnion<readonly [z.Zo
     engine?: string | undefined;
     expectedSize?: number | undefined;
     sha256Checksum?: string | undefined;
-    addon?: "llamacpp-completion" | "whispercpp-transcription" | "llamacpp-embedding" | "nmtcpp-translation" | "onnx-tts" | "parakeet-transcription" | "onnx-ocr" | "sdcpp-generation" | "llm" | "whisper" | "embeddings" | "nmt" | "parakeet" | "tts" | "ocr" | "diffusion" | "vad" | undefined;
+    addon?: "embeddings" | "llamacpp-completion" | "whispercpp-transcription" | "llamacpp-embedding" | "nmtcpp-translation" | "onnx-tts" | "parakeet-transcription" | "onnx-ocr" | "sdcpp-generation" | "llm" | "whisper" | "nmt" | "parakeet" | "tts" | "ocr" | "diffusion" | "vad" | undefined;
 }>>;
+export declare function inferModelTypeFromModelSrc(modelSrc: unknown): string | undefined;
 //# sourceMappingURL=model-src-utils.d.ts.map

package/dist/schemas/model-src-utils.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
-import { modelTypeInputSchema } from "./model-types.js";
+import { modelTypeInputSchema, normalizeModelType, isCanonicalModelType, isModelTypeAlias, } from "./model-types.js";
+import { resolveCanonicalEngine } from "./engine-addon-map.js";
 // Addon field accepts model type inputs plus "vad"
 const addonSchema = z.union([modelTypeInputSchema, z.literal("vad")]);
 export const modelDescriptorSchema = z.object({
@@ -33,3 +34,28 @@ export const modelInputToNameSchema = modelSrcInputSchema.transform((modelSrc) =
     }
     return undefined;
 });
+export function inferModelTypeFromModelSrc(modelSrc) {
+    if (typeof modelSrc !== "object" || modelSrc === null) {
+        return undefined;
+    }
+    const descriptor = modelSrc;
+    const engine = descriptor["engine"];
+    if (typeof engine === "string" && engine.length > 0) {
+        const canonical = resolveCanonicalEngine(engine);
+        if (canonical)
+            return canonical;
+        if (isCanonicalModelType(engine) || isModelTypeAlias(engine)) {
+            return normalizeModelType(engine);
+        }
+    }
+    const addon = descriptor["addon"];
+    if (typeof addon === "string" && addon.length > 0) {
+        const canonical = resolveCanonicalEngine(addon);
+        if (canonical)
+            return canonical;
+        if (isCanonicalModelType(addon) || isModelTypeAlias(addon)) {
+            return normalizeModelType(addon);
+        }
+    }
+    return undefined;
+}

package/dist/schemas/model-types.d.ts

@@ -67,6 +67,7 @@ export declare const PUBLIC_MODEL_TYPES: {
 };
 /** Schema accepting both canonical and alias model type inputs */
 export declare const modelTypeInputSchema: z.ZodEnum<{
+    embeddings: "embeddings";
     "llamacpp-completion": "llamacpp-completion";
     "whispercpp-transcription": "whispercpp-transcription";
     "llamacpp-embedding": "llamacpp-embedding";
@@ -77,7 +78,6 @@ export declare const modelTypeInputSchema: z.ZodEnum<{
     "sdcpp-generation": "sdcpp-generation";
     llm: "llm";
     whisper: "whisper";
-    embeddings: "embeddings";
     nmt: "nmt";
     parakeet: "parakeet";
     tts: "tts";
@@ -86,6 +86,7 @@ export declare const modelTypeInputSchema: z.ZodEnum<{
 }>;
 /** Schema that transforms input to canonical model type */
 export declare const modelTypeSchema: z.ZodPipe<z.ZodEnum<{
+    embeddings: "embeddings";
     "llamacpp-completion": "llamacpp-completion";
     "whispercpp-transcription": "whispercpp-transcription";
     "llamacpp-embedding": "llamacpp-embedding";
@@ -96,13 +97,12 @@ export declare const modelTypeSchema: z.ZodPipe<z.ZodEnum<{
     "sdcpp-generation": "sdcpp-generation";
     llm: "llm";
     whisper: "whisper";
-    embeddings: "embeddings";
     nmt: "nmt";
     parakeet: "parakeet";
     tts: "tts";
     ocr: "ocr";
     diffusion: "diffusion";
-}>, z.ZodTransform<"llamacpp-completion" | "whispercpp-transcription" | "llamacpp-embedding" | "nmtcpp-translation" | "onnx-tts" | "parakeet-transcription" | "onnx-ocr" | "sdcpp-generation", "llamacpp-completion" | "whispercpp-transcription" | "llamacpp-embedding" | "nmtcpp-translation" | "onnx-tts" | "parakeet-transcription" | "onnx-ocr" | "sdcpp-generation" | "llm" | "whisper" | "embeddings" | "nmt" | "parakeet" | "tts" | "ocr" | "diffusion">>;
+}>, z.ZodTransform<"llamacpp-completion" | "whispercpp-transcription" | "llamacpp-embedding" | "nmtcpp-translation" | "onnx-tts" | "parakeet-transcription" | "onnx-ocr" | "sdcpp-generation", "embeddings" | "llamacpp-completion" | "whispercpp-transcription" | "llamacpp-embedding" | "nmtcpp-translation" | "onnx-tts" | "parakeet-transcription" | "onnx-ocr" | "sdcpp-generation" | "llm" | "whisper" | "nmt" | "parakeet" | "tts" | "ocr" | "diffusion">>;
 /**
  * Normalize model type input to canonical form.
  * Custom plugin types (not in built-ins) are returned as-is.
@@ -154,8 +154,8 @@ export type ParakeetModelTypeInput = z.infer<typeof parakeetModelTypeSchema>;
  * - Canonical: `"llamacpp-embedding"`
  */
 export declare const embeddingsModelTypeSchema: z.ZodEnum<{
-    "llamacpp-embedding": "llamacpp-embedding";
     embeddings: "embeddings";
+    "llamacpp-embedding": "llamacpp-embedding";
 }>;
 export type EmbeddingsModelTypeInput = z.infer<typeof embeddingsModelTypeSchema>;
 /**

package/dist/schemas/ocr.d.ts

@@ -29,6 +29,7 @@ export declare const ocrConfigSchema: z.ZodObject<{
         expectedSize: z.ZodOptional<z.ZodNumber>;
         sha256Checksum: z.ZodOptional<z.ZodString>;
         addon: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+            embeddings: "embeddings";
             "llamacpp-completion": "llamacpp-completion";
             "whispercpp-transcription": "whispercpp-transcription";
             "llamacpp-embedding": "llamacpp-embedding";
@@ -39,7 +40,6 @@ export declare const ocrConfigSchema: z.ZodObject<{
             "sdcpp-generation": "sdcpp-generation";
             llm: "llm";
             whisper: "whisper";
-            embeddings: "embeddings";
             nmt: "nmt";
             parakeet: "parakeet";
             tts: "tts";

package/dist/schemas/plugin.d.ts

@@ -58,7 +58,6 @@ export interface PluginModel {
 }
 export interface PluginModelResult {
     model: PluginModel;
-    loader: unknown;
 }
 export interface PluginLogging {
     module: unknown;
@@ -131,14 +130,39 @@ export type PluginInvokeStreamRequest = z.infer<typeof pluginInvokeStreamRequest
 export type PluginInvokeStreamResponse = z.infer<typeof pluginInvokeStreamResponseSchema>;
 /**
  * Helper function to define a plugin with full type inference.
- * This is an identity function that provides type checking.
+ *
+ * Identity function whose only role is to constrain `plugin` to the
+ * `QvacPlugin` shape so consumers get accurate autocompletion and type
+ * errors for plugin manifests without having to write an explicit type
+ * annotation.
+ *
+ * @param plugin - The plugin manifest to register.
+ * @returns The same `plugin` value, typed as the caller's `T`.
  */
 export declare function definePlugin<T extends QvacPlugin>(plugin: T): T;
 /**
  * Helper function to define a handler with full type inference.
- * This is an identity function that provides type checking.
+ *
+ * Identity function whose only role is to constrain `definition` to a
+ * `PluginHandlerDefinition<TRequest, TResponse>` so the Zod request /
+ * response schemas flow through to the handler body without an explicit
+ * type annotation on the caller side.
+ *
+ * @param definition - The plugin handler definition (request/response schemas and handler function).
+ * @returns The same `definition` value, typed as `PluginHandlerDefinition<TRequest, TResponse>`.
  */
 export declare function defineHandler<TRequest extends z.ZodType, TResponse extends z.ZodType>(definition: PluginHandlerDefinition<TRequest, TResponse>): PluginHandlerDefinition<TRequest, TResponse>;
+/**
+ * Helper function to define a duplex (bidirectional streaming) handler with full type inference.
+ *
+ * Identity function whose only role is to constrain `definition` to a
+ * `DuplexPluginHandlerDefinition` and cast it to the unified
+ * `PluginHandlerDefinition` shape. This bridges TS function-parameter
+ * contravariance so duplex handlers can be registered alongside unary ones.
+ *
+ * @param definition - The duplex plugin handler definition (request/response schemas and streaming handler function).
+ * @returns The same `definition` value, typed as `PluginHandlerDefinition<TRequest, TResponse>`.
+ */
 export declare function defineDuplexHandler<TRequest extends z.ZodType, TResponse extends z.ZodType>(definition: DuplexPluginHandlerDefinition<TRequest, TResponse>): PluginHandlerDefinition<TRequest, TResponse>;
 export declare const pluginHandlerDefinitionRuntimeSchema: z.ZodObject<{
     requestSchema: z.ZodObject<{

package/dist/schemas/plugin.js

@@ -27,18 +27,43 @@ export const pluginInvokeStreamResponseSchema = z.object({
 // ============================================
 /**
  * Helper function to define a plugin with full type inference.
- * This is an identity function that provides type checking.
+ *
+ * Identity function whose only role is to constrain `plugin` to the
+ * `QvacPlugin` shape so consumers get accurate autocompletion and type
+ * errors for plugin manifests without having to write an explicit type
+ * annotation.
+ *
+ * @param plugin - The plugin manifest to register.
+ * @returns The same `plugin` value, typed as the caller's `T`.
  */
 export function definePlugin(plugin) {
     return plugin;
 }
 /**
  * Helper function to define a handler with full type inference.
- * This is an identity function that provides type checking.
+ *
+ * Identity function whose only role is to constrain `definition` to a
+ * `PluginHandlerDefinition<TRequest, TResponse>` so the Zod request /
+ * response schemas flow through to the handler body without an explicit
+ * type annotation on the caller side.
+ *
+ * @param definition - The plugin handler definition (request/response schemas and handler function).
+ * @returns The same `definition` value, typed as `PluginHandlerDefinition<TRequest, TResponse>`.
  */
 export function defineHandler(definition) {
     return definition;
 }
+/**
+ * Helper function to define a duplex (bidirectional streaming) handler with full type inference.
+ *
+ * Identity function whose only role is to constrain `definition` to a
+ * `DuplexPluginHandlerDefinition` and cast it to the unified
+ * `PluginHandlerDefinition` shape. This bridges TS function-parameter
+ * contravariance so duplex handlers can be registered alongside unary ones.
+ *
+ * @param definition - The duplex plugin handler definition (request/response schemas and streaming handler function).
+ * @returns The same `definition` value, typed as `PluginHandlerDefinition<TRequest, TResponse>`.
+ */
 export function defineDuplexHandler(definition) {
     // The duplex flag guarantees inputStream is always
     // provided at call time; the cast bridges TS function-param contravariance.

package/dist/schemas/profiling.js

@@ -64,7 +64,15 @@ export const profilingResponseMetaSchema = z.object({
     operation: operationEventSchema.optional(),
 });
 export const perCallProfilingSchema = z.object({
-    enabled: z.boolean().optional(),
-    includeServerBreakdown: z.boolean().optional(),
-    mode: profilerModeSchema.optional(),
+    enabled: z
+        .boolean()
+        .optional()
+        .describe("Enable profiling for this call only; when omitted, the SDK-level profiler configuration applies."),
+    includeServerBreakdown: z
+        .boolean()
+        .optional()
+        .describe("Include server-side timing breakdown in the profiling payload."),
+    mode: profilerModeSchema
+        .optional()
+        .describe('Profiling detail level: `"summary"` aggregates only, `"verbose"` retains recent events.'),
 });

package/dist/schemas/provide.d.ts

@@ -7,7 +7,6 @@ export declare const firewallConfigSchema: z.ZodObject<{
     publicKeys: z.ZodDefault<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export declare const provideParamsSchema: z.ZodObject<{
-    topic: z.ZodString;
     firewall: z.ZodOptional<z.ZodObject<{
         mode: z.ZodDefault<z.ZodEnum<{
             allow: "allow";
@@ -17,8 +16,6 @@ export declare const provideParamsSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strict>;
 export declare const provideRequestSchema: z.ZodObject<{
-    type: z.ZodLiteral<"provide">;
-    topic: z.ZodString;
     firewall: z.ZodOptional<z.ZodObject<{
         mode: z.ZodDefault<z.ZodEnum<{
             allow: "allow";
@@ -26,6 +23,7 @@ export declare const provideRequestSchema: z.ZodObject<{
         }>>;
         publicKeys: z.ZodDefault<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>;
+    type: z.ZodLiteral<"provide">;
 }, z.core.$strict>;
 export declare const provideResponseSchema: z.ZodObject<{
     type: z.ZodLiteral<"provide">;

package/dist/schemas/provide.js

@@ -5,14 +5,11 @@ export const firewallConfigSchema = z.object({
 });
 export const provideParamsSchema = z
     .object({
-    topic: z.string(),
     firewall: firewallConfigSchema.optional(),
 })
     .strict();
 export const provideRequestSchema = provideParamsSchema.extend({
     type: z.literal("provide"),
-    topic: z.string(),
-    firewall: firewallConfigSchema.optional(),
 });
 export const provideResponseSchema = z.object({
     type: z.literal("provide"),

package/dist/schemas/rag.d.ts

@@ -13,9 +13,9 @@ export declare const ragIngestParamsSchema: z.ZodObject<{
             character: "character";
         }>>;
         splitStrategy: z.ZodOptional<z.ZodEnum<{
-            token: "token";
             character: "character";
             word: "word";
+            token: "token";
             sentence: "sentence";
             line: "line";
         }>>;
@@ -34,9 +34,9 @@ export declare const ragChunkParamsSchema: z.ZodObject<{
             character: "character";
         }>>;
         splitStrategy: z.ZodOptional<z.ZodEnum<{
-            token: "token";
             character: "character";
             word: "word";
+            token: "token";
             sentence: "sentence";
             line: "line";
         }>>;
@@ -91,9 +91,9 @@ export declare const ragRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             character: "character";
         }>>;
         splitStrategy: z.ZodOptional<z.ZodEnum<{
-            token: "token";
             character: "character";
             word: "word";
+            token: "token";
             sentence: "sentence";
             line: "line";
         }>>;
@@ -113,9 +113,9 @@ export declare const ragRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             character: "character";
         }>>;
         splitStrategy: z.ZodOptional<z.ZodEnum<{
-            token: "token";
             character: "character";
             word: "word";
+            token: "token";
             sentence: "sentence";
             line: "line";
         }>>;

package/dist/schemas/registry.d.ts

@@ -1,8 +1,8 @@
 import { z } from "zod";
 declare const modelRegistryEntryAddonSchema: z.ZodEnum<{
+    embeddings: "embeddings";
     llm: "llm";
     whisper: "whisper";
-    embeddings: "embeddings";
     nmt: "nmt";
     parakeet: "parakeet";
     tts: "tts";
@@ -32,9 +32,9 @@ export declare const modelRegistryEntrySchema: z.ZodObject<{
     blobByteOffset: z.ZodNumber;
     modelId: z.ZodString;
     addon: z.ZodEnum<{
+        embeddings: "embeddings";
         llm: "llm";
         whisper: "whisper";
-        embeddings: "embeddings";
         nmt: "nmt";
         parakeet: "parakeet";
         tts: "tts";
@@ -78,9 +78,9 @@ export declare const modelRegistryListResponseSchema: z.ZodObject<{
         blobByteOffset: z.ZodNumber;
         modelId: z.ZodString;
         addon: z.ZodEnum<{
+            embeddings: "embeddings";
             llm: "llm";
             whisper: "whisper";
-            embeddings: "embeddings";
             nmt: "nmt";
             parakeet: "parakeet";
             tts: "tts";
@@ -115,9 +115,9 @@ export declare const modelRegistrySearchRequestSchema: z.ZodObject<{
     engine: z.ZodOptional<z.ZodString>;
     quantization: z.ZodOptional<z.ZodString>;
     addon: z.ZodOptional<z.ZodEnum<{
+        embeddings: "embeddings";
         llm: "llm";
         whisper: "whisper";
-        embeddings: "embeddings";
         nmt: "nmt";
         parakeet: "parakeet";
         tts: "tts";
@@ -140,9 +140,9 @@ export declare const modelRegistrySearchResponseSchema: z.ZodObject<{
         blobByteOffset: z.ZodNumber;
         modelId: z.ZodString;
         addon: z.ZodEnum<{
+            embeddings: "embeddings";
             llm: "llm";
             whisper: "whisper";
-            embeddings: "embeddings";
             nmt: "nmt";
             parakeet: "parakeet";
             tts: "tts";
@@ -189,9 +189,9 @@ export declare const modelRegistryGetModelResponseSchema: z.ZodObject<{
         blobByteOffset: z.ZodNumber;
         modelId: z.ZodString;
         addon: z.ZodEnum<{
+            embeddings: "embeddings";
             llm: "llm";
             whisper: "whisper";
-            embeddings: "embeddings";
             nmt: "nmt";
             parakeet: "parakeet";
             tts: "tts";
@@ -228,9 +228,9 @@ export declare const modelRegistryRequestSchema: z.ZodUnion<readonly [z.ZodObjec
     engine: z.ZodOptional<z.ZodString>;
     quantization: z.ZodOptional<z.ZodString>;
     addon: z.ZodOptional<z.ZodEnum<{
+        embeddings: "embeddings";
         llm: "llm";
         whisper: "whisper";
-        embeddings: "embeddings";
         nmt: "nmt";
         parakeet: "parakeet";
         tts: "tts";
@@ -257,9 +257,9 @@ export declare const modelRegistryResponseSchema: z.ZodDiscriminatedUnion<[z.Zod
         blobByteOffset: z.ZodNumber;
         modelId: z.ZodString;
         addon: z.ZodEnum<{
+            embeddings: "embeddings";
             llm: "llm";
             whisper: "whisper";
-            embeddings: "embeddings";
             nmt: "nmt";
             parakeet: "parakeet";
             tts: "tts";
@@ -298,9 +298,9 @@ export declare const modelRegistryResponseSchema: z.ZodDiscriminatedUnion<[z.Zod
         blobByteOffset: z.ZodNumber;
         modelId: z.ZodString;
         addon: z.ZodEnum<{
+            embeddings: "embeddings";
             llm: "llm";
             whisper: "whisper";
-            embeddings: "embeddings";
             nmt: "nmt";
             parakeet: "parakeet";
             tts: "tts";
@@ -339,9 +339,9 @@ export declare const modelRegistryResponseSchema: z.ZodDiscriminatedUnion<[z.Zod
         blobByteOffset: z.ZodNumber;
         modelId: z.ZodString;
         addon: z.ZodEnum<{
+            embeddings: "embeddings";
             llm: "llm";
             whisper: "whisper";
-            embeddings: "embeddings";
             nmt: "nmt";
             parakeet: "parakeet";
             tts: "tts";

package/dist/schemas/registry.js

@@ -30,20 +30,42 @@ export const modelRegistryEngineSchema = z.enum([
     "onnx-vad",
 ]);
 export const modelRegistryEntrySchema = z.object({
-    name: z.string(),
-    registryPath: z.string(),
-    registrySource: z.string(),
-    blobCoreKey: z.string(),
-    blobBlockOffset: z.number(),
-    blobBlockLength: z.number(),
-    blobByteOffset: z.number(),
-    modelId: z.string(),
-    addon: modelRegistryEntryAddonSchema,
-    expectedSize: z.number(),
-    sha256Checksum: z.string(),
-    engine: modelRegistryEngineSchema,
-    quantization: z.string(),
-    params: z.string(),
+    name: z.string().describe("Catalog name of the model entry."),
+    registryPath: z
+        .string()
+        .describe("Registry-relative path to the model."),
+    registrySource: z
+        .string()
+        .describe("Registry source identifier, e.g. `huggingface`."),
+    blobCoreKey: z
+        .string()
+        .describe("Hyperdrive blob core key for the model file."),
+    blobBlockOffset: z
+        .number()
+        .describe("Starting block offset of the model file in the blob."),
+    blobBlockLength: z
+        .number()
+        .describe("Number of blocks occupied by the model file."),
+    blobByteOffset: z
+        .number()
+        .describe("Starting byte offset of the model file within its block."),
+    modelId: z
+        .string()
+        .describe("Unique identifier used to reference the model in SDK calls."),
+    addon: modelRegistryEntryAddonSchema.describe("Inference addon / capability category this model belongs to."),
+    expectedSize: z
+        .number()
+        .describe("Expected total size of the model file in bytes."),
+    sha256Checksum: z
+        .string()
+        .describe("Expected SHA-256 checksum of the model file."),
+    engine: modelRegistryEngineSchema.describe("Canonical inference engine identifier."),
+    quantization: z
+        .string()
+        .describe("Quantization identifier, e.g. `Q4_K_M`."),
+    params: z
+        .string()
+        .describe("Parameter-count label for the model, e.g. `7B`."),
 });
 // QVAC Model Registry list request/response
 export const modelRegistryListRequestSchema = z.object({