@qvac/sdk 0.14.1 → 0.16.0

package/dist/client/api/finetune.js

@@ -1,24 +1,22 @@
-import { send, stream as streamRpc } from "../rpc/rpc-client.js";
-import { finetuneRunParamsSchema, finetuneRunRequestSchema, finetuneStopRequestSchema, finetuneGetStateParamsSchema, finetuneGetStateRequestSchema, finetuneProgressResponseSchema, finetuneResponseSchema, } from "../../schemas/index.js";
-import { InvalidResponseError, StreamEndedError, } from "../../utils/errors-client.js";
-import { parseClientInput } from "../parse-input.js";
+import { send, stream as streamRpc } from '../rpc/rpc-client.js';
+import { finetuneRunParamsSchema, finetuneRunRequestSchema, finetuneStopRequestSchema, finetuneGetStateParamsSchema, finetuneGetStateRequestSchema, finetuneProgressResponseSchema, finetuneResponseSchema } from '../../schemas/index.js';
+import { InvalidResponseError, StreamEndedError } from '../../utils/errors-client.js';
+import { parseClientInput } from '../parse-input.js';
 function isFinetuneReplyParams(params) {
-    return (params.operation === "pause" ||
-        params.operation === "cancel" ||
-        params.operation === "getState");
+    return (params.operation === 'pause' || params.operation === 'cancel' || params.operation === 'getState');
 }
 function createFinetuneReplyRequest(params) {
-    if (params.operation === "getState") {
+    if (params.operation === 'getState') {
         const getStateParams = parseClientInput(finetuneGetStateParamsSchema, params);
         return parseClientInput(finetuneGetStateRequestSchema, {
-            type: "finetune",
-            ...getStateParams,
+            type: 'finetune',
+            ...getStateParams
         });
     }
     return parseClientInput(finetuneStopRequestSchema, {
-        type: "finetune",
+        type: 'finetune',
         modelId: params.modelId,
-        operation: params.operation,
+        operation: params.operation
     });
 }
 export function finetune(params, rpcOptions) {
@@ -27,10 +25,10 @@ export function finetune(params, rpcOptions) {
         const resultPromise = (async () => {
             const response = await send(request, rpcOptions);
             if (!response ||
-                typeof response !== "object" ||
-                !("type" in response) ||
-                response.type !== "finetune") {
-                throw new InvalidResponseError("finetune");
+                typeof response !== 'object' ||
+                !('type' in response) ||
+                response.type !== 'finetune') {
+                throw new InvalidResponseError('finetune');
             }
             return finetuneResponseSchema.parse(response);
         })();
@@ -53,16 +51,16 @@ export function finetune(params, rpcOptions) {
         try {
             let sawTerminalResponse = false;
             const request = parseClientInput(finetuneRunRequestSchema, {
-                type: "finetune",
+                type: 'finetune',
                 ...runParams,
-                withProgress: true,
+                withProgress: true
             });
             const responses = streamRpc(request, rpcOptions);
             for await (const response of responses) {
                 if (response &&
-                    typeof response === "object" &&
-                    "type" in response &&
-                    response.type === "finetune:progress") {
+                    typeof response === 'object' &&
+                    'type' in response &&
+                    response.type === 'finetune:progress') {
                     const progressResponse = finetuneProgressResponseSchema.parse(response);
                     progressQueue.push({
                         is_train: progressResponse.is_train,
@@ -75,7 +73,7 @@ export function finetune(params, rpcOptions) {
                         current_batch: progressResponse.current_batch,
                         total_batches: progressResponse.total_batches,
                         elapsed_ms: progressResponse.elapsed_ms,
-                        eta_ms: progressResponse.eta_ms,
+                        eta_ms: progressResponse.eta_ms
                     });
                     if (progressResolve) {
                         progressResolve();
@@ -84,9 +82,9 @@ export function finetune(params, rpcOptions) {
                     continue;
                 }
                 if (response &&
-                    typeof response === "object" &&
-                    "type" in response &&
-                    response.type === "finetune") {
+                    typeof response === 'object' &&
+                    'type' in response &&
+                    response.type === 'finetune') {
                     sawTerminalResponse = true;
                     const finetuneResponse = finetuneResponseSchema.parse(response);
                     resultResolver(finetuneResponse);
@@ -97,7 +95,7 @@ export function finetune(params, rpcOptions) {
                     }
                 }
                 else {
-                    throw new InvalidResponseError("finetune");
+                    throw new InvalidResponseError('finetune');
                 }
             }
             if (!sawTerminalResponse) {
@@ -135,6 +133,6 @@ export function finetune(params, rpcOptions) {
     })();
     return {
         progressStream,
-        result: resultPromise,
+        result: resultPromise
     };
 }

package/dist/client/api/get-loaded-model-info.d.ts

@@ -1,5 +1,5 @@
-import { type GetLoadedModelInfoParams, type LoadedModelInfo } from "../../schemas/index";
-import { type RPCOptions } from "../../schemas/common";
+import { type GetLoadedModelInfoParams, type LoadedModelInfo } from '../../schemas/index';
+import { type RPCOptions } from '../../schemas/common';
 /**
  * Returns introspection info for a loaded `modelId` (local or delegated).
  *

package/dist/client/api/get-loaded-model-info.js

@@ -1,7 +1,7 @@
-import {} from "../../schemas/index.js";
-import {} from "../../schemas/common.js";
-import { send } from "../rpc/rpc-client.js";
-import { InvalidResponseError } from "../../utils/errors-client.js";
+import {} from '../../schemas/index.js';
+import {} from '../../schemas/common.js';
+import { send } from '../rpc/rpc-client.js';
+import { InvalidResponseError } from '../../utils/errors-client.js';
 /**
  * Returns introspection info for a loaded `modelId` (local or delegated).
  *
@@ -25,12 +25,12 @@ import { InvalidResponseError } from "../../utils/errors-client.js";
  */
 export async function getLoadedModelInfo(params, rpcOptions) {
     const request = {
-        type: "getLoadedModelInfo",
-        modelId: params.modelId,
+        type: 'getLoadedModelInfo',
+        modelId: params.modelId
     };
     const response = await send(request, rpcOptions);
-    if (response.type !== "getLoadedModelInfo") {
-        throw new InvalidResponseError("getLoadedModelInfo");
+    if (response.type !== 'getLoadedModelInfo') {
+        throw new InvalidResponseError('getLoadedModelInfo');
     }
     return response.info;
 }

package/dist/client/api/get-model-info.d.ts

@@ -1,4 +1,4 @@
-import { type GetModelInfoParams } from "../../schemas/index";
+import { type GetModelInfoParams } from '../../schemas/index';
 /**
  * Returns status information for a catalog model, including cache state and loaded instances.
  *

package/dist/client/api/get-model-info.js

@@ -1,6 +1,6 @@
-import {} from "../../schemas/index.js";
-import { send } from "../rpc/rpc-client.js";
-import { InvalidResponseError } from "../../utils/errors-client.js";
+import {} from '../../schemas/index.js';
+import { send } from '../rpc/rpc-client.js';
+import { InvalidResponseError } from '../../utils/errors-client.js';
 /**
  * Returns status information for a catalog model, including cache state and loaded instances.
  *
@@ -11,12 +11,12 @@ import { InvalidResponseError } from "../../utils/errors-client.js";
  */
 export async function getModelInfo(params) {
     const request = {
-        type: "getModelInfo",
-        name: params.name,
+        type: 'getModelInfo',
+        name: params.name
     };
     const response = await send(request);
-    if (response.type !== "getModelInfo") {
-        throw new InvalidResponseError("getModelInfo");
+    if (response.type !== 'getModelInfo') {
+        throw new InvalidResponseError('getModelInfo');
     }
     return response.modelInfo;
 }

package/dist/client/api/heartbeat.d.ts

@@ -1,5 +1,5 @@
-import { type HeartbeatResponse } from "../../schemas/index";
-import type { DelegateBase } from "../../schemas/delegate";
+import { type HeartbeatResponse } from '../../schemas/index';
+import type { DelegateBase } from '../../schemas/delegate';
 /**
  * Checks if a delegated provider is online by sending a heartbeat round-trip.
  * Can also be used to check if the local SDK worker is responsive.

package/dist/client/api/heartbeat.js

@@ -1,6 +1,6 @@
-import {} from "../../schemas/index.js";
-import { send } from "../rpc/rpc-client.js";
-import { InvalidResponseError } from "../../utils/errors-client.js";
+import {} from '../../schemas/index.js';
+import { send } from '../rpc/rpc-client.js';
+import { InvalidResponseError } from '../../utils/errors-client.js';
 /**
  * Checks if a delegated provider is online by sending a heartbeat round-trip.
  * Can also be used to check if the local SDK worker is responsive.
@@ -27,12 +27,12 @@ import { InvalidResponseError } from "../../utils/errors-client.js";
  */
 export async function heartbeat(params) {
     const request = {
-        type: "heartbeat",
-        ...(params?.delegate && { delegate: params.delegate }),
+        type: 'heartbeat',
+        ...(params?.delegate && { delegate: params.delegate })
     };
     const response = await send(request);
-    if (response.type !== "heartbeat") {
-        throw new InvalidResponseError("heartbeat");
+    if (response.type !== 'heartbeat') {
+        throw new InvalidResponseError('heartbeat');
     }
     return response;
 }

package/dist/client/api/index.d.ts

@@ -1,33 +1,34 @@
-export { loadModel } from "./load-model";
-export { downloadAsset } from "./download-asset";
-export { completion } from "./completion-stream";
-export { deleteCache } from "./delete-cache";
-export { unloadModel } from "./unload-model";
-export { loggingStream } from "./logging-stream";
-export { subscribeServerLogs, type ServerLogHandler } from "./subscribe-logs";
-export { heartbeat } from "./heartbeat";
-export { transcribe, transcribeStream } from "./transcribe";
-export { bciTranscribe, bciTranscribeStream } from "./bci-transcribe";
-export { embed } from "./embed";
-export { finetune, type FinetuneHandle } from "./finetune";
-export { translate } from "./translate";
-export { cancel } from "./cancel";
-export { startQVACProvider } from "./provide";
-export { stopQVACProvider } from "./stop-provider";
-export { ragChunk, ragIngest, ragSaveEmbeddings, ragSearch, ragDeleteEmbeddings, ragReindex, ragListWorkspaces, ragCloseWorkspace, ragDeleteWorkspace, } from "./rag";
-export { textToSpeech, textToSpeechStream } from "./text-to-speech";
-export { getModelInfo } from "./get-model-info";
-export { getLoadedModelInfo } from "./get-loaded-model-info";
-export { ocr } from "./ocr";
-export { invokePlugin, invokePluginStream } from "./invoke-plugin";
-export { diffusion, type DiffusionProgressTick } from "./diffusion";
-export { classify } from "./classify";
-export { video, type VideoProgressTick } from "./video";
-export { upscale } from "./upscale";
-export { modelRegistryList, modelRegistrySearch, modelRegistryGetModel, type ModelRegistrySearchParams, } from "./registry";
-export { suspend } from "./suspend";
-export { resume } from "./resume";
-export { state } from "./state";
-export { vla, vlaHparams } from "./vla";
-export { vlaPreprocessImage, vlaPadState, VLA_DEFAULT_IMAGE_SIZE, } from "./vla-helpers";
+export { loadModel } from './load-model';
+export { downloadAsset } from './download-asset';
+export { batchCompletion } from './batch-completion';
+export { completion } from './completion-stream';
+export { deleteCache } from './delete-cache';
+export { unloadModel } from './unload-model';
+export { loggingStream } from './logging-stream';
+export { subscribeServerLogs, type ServerLogHandler } from './subscribe-logs';
+export { heartbeat } from './heartbeat';
+export { transcribe, transcribeStream } from './transcribe';
+export { bciTranscribe, bciTranscribeStream } from './bci-transcribe';
+export { embed } from './embed';
+export { finetune, type FinetuneHandle } from './finetune';
+export { translate } from './translate';
+export { cancel } from './cancel';
+export { startQVACProvider } from './provide';
+export { stopQVACProvider } from './stop-provider';
+export { ragChunk, ragIngest, ragSaveEmbeddings, ragSearch, ragDeleteEmbeddings, ragReindex, ragListWorkspaces, ragCloseWorkspace, ragDeleteWorkspace } from './rag';
+export { textToSpeech, textToSpeechStream } from './text-to-speech';
+export { getModelInfo } from './get-model-info';
+export { getLoadedModelInfo } from './get-loaded-model-info';
+export { ocr } from './ocr';
+export { invokePlugin, invokePluginStream } from './invoke-plugin';
+export { diffusion, type DiffusionProgressTick } from './diffusion';
+export { classify } from './classify';
+export { video, type VideoProgressTick } from './video';
+export { upscale } from './upscale';
+export { modelRegistryList, modelRegistrySearch, modelRegistryGetModel, type ModelRegistrySearchParams } from './registry';
+export { suspend } from './suspend';
+export { resume } from './resume';
+export { state } from './state';
+export { vla, vlaHparams } from './vla';
+export { vlaPreprocessImage, vlaPadState, VLA_DEFAULT_IMAGE_SIZE } from './vla-helpers';
 //# sourceMappingURL=index.d.ts.map

package/dist/client/api/index.js

@@ -1,32 +1,33 @@
-export { loadModel } from "./load-model.js";
-export { downloadAsset } from "./download-asset.js";
-export { completion } from "./completion-stream.js";
-export { deleteCache } from "./delete-cache.js";
-export { unloadModel } from "./unload-model.js";
-export { loggingStream } from "./logging-stream.js";
-export { subscribeServerLogs } from "./subscribe-logs.js";
-export { heartbeat } from "./heartbeat.js";
-export { transcribe, transcribeStream } from "./transcribe.js";
-export { bciTranscribe, bciTranscribeStream } from "./bci-transcribe.js";
-export { embed } from "./embed.js";
-export { finetune } from "./finetune.js";
-export { translate } from "./translate.js";
-export { cancel } from "./cancel.js";
-export { startQVACProvider } from "./provide.js";
-export { stopQVACProvider } from "./stop-provider.js";
-export { ragChunk, ragIngest, ragSaveEmbeddings, ragSearch, ragDeleteEmbeddings, ragReindex, ragListWorkspaces, ragCloseWorkspace, ragDeleteWorkspace, } from "./rag.js";
-export { textToSpeech, textToSpeechStream } from "./text-to-speech.js";
-export { getModelInfo } from "./get-model-info.js";
-export { getLoadedModelInfo } from "./get-loaded-model-info.js";
-export { ocr } from "./ocr.js";
-export { invokePlugin, invokePluginStream } from "./invoke-plugin.js";
-export { diffusion } from "./diffusion.js";
-export { classify } from "./classify.js";
-export { video } from "./video.js";
-export { upscale } from "./upscale.js";
-export { modelRegistryList, modelRegistrySearch, modelRegistryGetModel, } from "./registry.js";
-export { suspend } from "./suspend.js";
-export { resume } from "./resume.js";
-export { state } from "./state.js";
-export { vla, vlaHparams } from "./vla.js";
-export { vlaPreprocessImage, vlaPadState, VLA_DEFAULT_IMAGE_SIZE, } from "./vla-helpers.js";
+export { loadModel } from './load-model.js';
+export { downloadAsset } from './download-asset.js';
+export { batchCompletion } from './batch-completion.js';
+export { completion } from './completion-stream.js';
+export { deleteCache } from './delete-cache.js';
+export { unloadModel } from './unload-model.js';
+export { loggingStream } from './logging-stream.js';
+export { subscribeServerLogs } from './subscribe-logs.js';
+export { heartbeat } from './heartbeat.js';
+export { transcribe, transcribeStream } from './transcribe.js';
+export { bciTranscribe, bciTranscribeStream } from './bci-transcribe.js';
+export { embed } from './embed.js';
+export { finetune } from './finetune.js';
+export { translate } from './translate.js';
+export { cancel } from './cancel.js';
+export { startQVACProvider } from './provide.js';
+export { stopQVACProvider } from './stop-provider.js';
+export { ragChunk, ragIngest, ragSaveEmbeddings, ragSearch, ragDeleteEmbeddings, ragReindex, ragListWorkspaces, ragCloseWorkspace, ragDeleteWorkspace } from './rag.js';
+export { textToSpeech, textToSpeechStream } from './text-to-speech.js';
+export { getModelInfo } from './get-model-info.js';
+export { getLoadedModelInfo } from './get-loaded-model-info.js';
+export { ocr } from './ocr.js';
+export { invokePlugin, invokePluginStream } from './invoke-plugin.js';
+export { diffusion } from './diffusion.js';
+export { classify } from './classify.js';
+export { video } from './video.js';
+export { upscale } from './upscale.js';
+export { modelRegistryList, modelRegistrySearch, modelRegistryGetModel } from './registry.js';
+export { suspend } from './suspend.js';
+export { resume } from './resume.js';
+export { state } from './state.js';
+export { vla, vlaHparams } from './vla.js';
+export { vlaPreprocessImage, vlaPadState, VLA_DEFAULT_IMAGE_SIZE } from './vla-helpers.js';

package/dist/client/api/invoke-plugin.d.ts

@@ -1,4 +1,4 @@
-import type { RPCOptions } from "../../schemas/index";
+import type { RPCOptions } from '../../schemas/index';
 export interface InvokePluginOptions<TParams = unknown> {
     modelId: string;
     handler: string;

package/dist/client/api/invoke-plugin.js

@@ -1,5 +1,5 @@
-import { send, stream } from "../rpc/rpc-client.js";
-import { InvalidResponseError } from "../../utils/errors-client.js";
+import { send, stream } from '../rpc/rpc-client.js';
+import { InvalidResponseError } from '../../utils/errors-client.js';
 /**
  * Invoke a non-streaming plugin handler.
  *
@@ -13,14 +13,14 @@ import { InvalidResponseError } from "../../utils/errors-client.js";
  */
 export async function invokePlugin(options, rpcOptions) {
     const request = {
-        type: "pluginInvoke",
+        type: 'pluginInvoke',
         modelId: options.modelId,
         handler: options.handler,
-        params: options.params,
+        params: options.params
     };
     const response = await send(request, rpcOptions);
-    if (response.type !== "pluginInvoke") {
-        throw new InvalidResponseError("pluginInvoke");
+    if (response.type !== 'pluginInvoke') {
+        throw new InvalidResponseError('pluginInvoke');
     }
     return response.result;
 }
@@ -37,15 +37,15 @@ export async function invokePlugin(options, rpcOptions) {
  */
 export async function* invokePluginStream(options, rpcOptions) {
     const request = {
-        type: "pluginInvokeStream",
+        type: 'pluginInvokeStream',
         modelId: options.modelId,
         handler: options.handler,
-        params: options.params,
+        params: options.params
     };
     for await (const chunk of stream(request, rpcOptions)) {
         const response = chunk;
-        if (response.type !== "pluginInvokeStream") {
-            throw new InvalidResponseError("pluginInvokeStream");
+        if (response.type !== 'pluginInvokeStream') {
+            throw new InvalidResponseError('pluginInvokeStream');
         }
         if (!response.done) {
             yield response.result;

package/dist/client/api/load-model.d.ts

@@ -1,4 +1,4 @@
-import { type LoadModelOptions, type LoadCustomPluginModelOptions, type LoadModelDescriptorParam, type ReloadConfigOptions, type RPCOptions, type ModelDescriptor } from "../../schemas/index";
+import { type LoadModelOptions, type LoadCustomPluginModelOptions, type LoadModelDescriptorParam, type ReloadConfigOptions, type RPCOptions, type ModelDescriptor } from '../../schemas/index';
 /**
  * Loads a model from a descriptor; `modelType` is inferred from `modelSrc`.
  * `modelConfig` narrows per-engine when `modelSrc.engine` is a literal,

package/dist/client/api/load-model.js

@@ -1,16 +1,16 @@
-import { send, stream } from "../rpc/rpc-client.js";
-import { startLoggingStreamForModel } from "../logging-stream-registry.js";
-import { loadBuiltinToRequestSchema, loadCustomPluginToRequestSchema, reloadConfigOptionsToRequestSchema, isBuiltInModelType, isModelTypeAlias, normalizeModelType, inferModelTypeFromModelSrc, ModelType, } from "../../schemas/index.js";
-import { ModelLoadFailedError, ModelTypeRequiredError, StreamEndedError, InvalidResponseError, } from "../../utils/errors-client.js";
-import { assertModelSrcMatchesModelType } from "../../utils/load-model-validation.js";
-import { parseClientInput } from "../parse-input.js";
-import { getClientLogger } from "../../logging/index.js";
-import { decoratePromise } from "../../utils/decorate-promise.js";
-import { generateClientRequestId } from "./client-request-id.js";
+import { send, stream } from '../rpc/rpc-client.js';
+import { startLoggingStreamForModel } from '../logging-stream-registry.js';
+import { loadBuiltinToRequestSchema, loadCustomPluginToRequestSchema, reloadConfigOptionsToRequestSchema, isBuiltInModelType, isModelTypeAlias, normalizeModelType, inferModelTypeFromModelSrc, ModelType } from '../../schemas/index.js';
+import { ModelLoadFailedError, ModelTypeRequiredError, StreamEndedError, InvalidResponseError } from '../../utils/errors-client.js';
+import { assertModelSrcMatchesModelType } from '../../utils/load-model-validation.js';
+import { parseClientInput } from '../parse-input.js';
+import { getClientLogger } from '../../logging/index.js';
+import { decoratePromise } from '../../utils/decorate-promise.js';
+import { generateClientRequestId } from './client-request-id.js';
 const logger = getClientLogger();
 function isReactNativeRuntime() {
     const runtime = globalThis;
-    return runtime.navigator?.product === "ReactNative";
+    return runtime.navigator?.product === 'ReactNative';
 }
 let warnedLocalVideoModelLoad = false;
 export function loadModel(options, rpcOptions) {
@@ -30,40 +30,40 @@ export function loadModel(options, rpcOptions) {
     return decoratePromise(inner, { requestId });
 }
 async function runLoadModel(options, requestId, rpcOptions) {
-    const isReloadConfig = "modelId" in options && !("modelSrc" in options);
+    const isReloadConfig = 'modelId' in options && !('modelSrc' in options);
     // Infer `modelType` from `modelSrc` when omitted; the schema still validates
     // the resolved options below.
     let resolvedOptions = options;
     if (!isReloadConfig) {
-        let modelType = resolvedOptions["modelType"];
-        if (typeof modelType === "string") {
-            assertModelSrcMatchesModelType(resolvedOptions["modelSrc"], modelType);
+        let modelType = resolvedOptions['modelType'];
+        if (typeof modelType === 'string') {
+            assertModelSrcMatchesModelType(resolvedOptions['modelSrc'], modelType);
         }
         else if (modelType === undefined) {
-            const inferred = inferModelTypeFromModelSrc(resolvedOptions["modelSrc"]);
+            const inferred = inferModelTypeFromModelSrc(resolvedOptions['modelSrc']);
             if (!inferred) {
                 throw new ModelTypeRequiredError();
             }
             resolvedOptions = { ...resolvedOptions, modelType: inferred };
             modelType = inferred;
         }
-        if (typeof modelType === "string" && isModelTypeAlias(modelType)) {
+        if (typeof modelType === 'string' && isModelTypeAlias(modelType)) {
             const canonical = normalizeModelType(modelType);
             logger.warn(`Model type "${modelType}" is an alias and will be deprecated. Use "${canonical}" instead.`);
         }
-        const canonicalModelType = typeof modelType === "string" ? normalizeModelType(modelType) : modelType;
-        const modelConfig = resolvedOptions["modelConfig"];
+        const canonicalModelType = typeof modelType === 'string' ? normalizeModelType(modelType) : modelType;
+        const modelConfig = resolvedOptions['modelConfig'];
         if (isReactNativeRuntime() &&
             canonicalModelType === ModelType.sdcppGeneration &&
-            modelConfig?.mode === "video" &&
-            resolvedOptions["delegate"] === undefined &&
+            modelConfig?.mode === 'video' &&
+            resolvedOptions['delegate'] === undefined &&
             !warnedLocalVideoModelLoad) {
             warnedLocalVideoModelLoad = true;
-            const message = "QVAC video generation works on React Native, but loading the video " +
-                "model on-device will usually fail or take several minutes — the video " +
-                "diffusion models currently shipped by the SDK are too large to load " +
-                "on typical mobile devices. Pass a `delegate` to `loadModel(...)` to " +
-                "run generation on a desktop peer instead.";
+            const message = 'QVAC video generation works on React Native, but loading the video ' +
+                'model on-device will usually fail or take several minutes — the video ' +
+                'diffusion models currently shipped by the SDK are too large to load ' +
+                'on typical mobile devices. Pass a `delegate` to `loadModel(...)` to ' +
+                'run generation on a desktop peer instead.';
             logger.warn(message);
         }
     }
@@ -75,22 +75,22 @@ async function runLoadModel(options, requestId, rpcOptions) {
     resolvedOptions = { ...resolvedOptions, requestId };
     const request = isReloadConfig
         ? parseClientInput(reloadConfigOptionsToRequestSchema, resolvedOptions)
-        : isBuiltInModelType(resolvedOptions["modelType"])
+        : isBuiltInModelType(resolvedOptions['modelType'])
             ? parseClientInput(loadBuiltinToRequestSchema, resolvedOptions)
             : parseClientInput(loadCustomPluginToRequestSchema, resolvedOptions);
     const modelLogger = isReloadConfig
         ? undefined
-        : resolvedOptions["logger"];
+        : resolvedOptions['logger'];
     const onProgress = isReloadConfig
         ? undefined
-        : resolvedOptions["onProgress"];
+        : resolvedOptions['onProgress'];
     if (onProgress) {
         // Use streaming for progress updates
         for await (const response of stream(request, rpcOptions)) {
-            if (response.type === "modelProgress") {
+            if (response.type === 'modelProgress') {
                 onProgress(response);
             }
-            else if (response.type === "loadModel") {
+            else if (response.type === 'loadModel') {
                 if (!response.success) {
                     throw new ModelLoadFailedError(response.error);
                 }
@@ -111,8 +111,8 @@ async function runLoadModel(options, requestId, rpcOptions) {
     }
     // Use regular send for simple loading
     const response = await send(request, rpcOptions);
-    if (response.type !== "loadModel") {
-        throw new InvalidResponseError("loadModel");
+    if (response.type !== 'loadModel') {
+        throw new InvalidResponseError('loadModel');
     }
     if (!response.success) {
         throw new ModelLoadFailedError(response.error);

package/dist/client/api/logging-stream.d.ts

@@ -1,4 +1,4 @@
-import type { LoggingStreamResponse, LoggingParams } from "../../schemas/logging-stream";
+import type { LoggingStreamResponse, LoggingParams } from '../../schemas/logging-stream';
 /**
  * Opens a logging stream to receive real-time logs.
  *

package/dist/client/api/logging-stream.js

@@ -1,5 +1,5 @@
-import { stream } from "../rpc/rpc-client.js";
-import { InvalidResponseError } from "../../utils/errors-client.js";
+import { stream } from '../rpc/rpc-client.js';
+import { InvalidResponseError } from '../../utils/errors-client.js';
 /**
  * Opens a logging stream to receive real-time logs.
  *
@@ -23,13 +23,13 @@ import { InvalidResponseError } from "../../utils/errors-client.js";
  */
 export async function* loggingStream(params) {
     const request = {
-        type: "loggingStream",
-        ...params,
+        type: 'loggingStream',
+        ...params
     };
     const responseStream = stream(request);
     for await (const response of responseStream) {
-        if (response.type !== "loggingStream") {
-            throw new InvalidResponseError("loggingStream");
+        if (response.type !== 'loggingStream') {
+            throw new InvalidResponseError('loggingStream');
         }
         yield response;
     }

package/dist/client/api/ocr.d.ts

@@ -1,4 +1,4 @@
-import { type OCRClientParams, type OCRTextBlock, type OCRStats } from "../../schemas/index";
+import { type OCRClientParams, type OCRTextBlock, type OCRStats } from '../../schemas/index';
 /**
  * Performs Optical Character Recognition (OCR) on an image to extract text.
  *
@@ -10,6 +10,15 @@ import { type OCRClientParams, type OCRTextBlock, type OCRStats } from "../../sc
  * @returns Object with blockStream generator, blocks promise, and stats promise
  * @example
  * ```typescript
+ * // Load an OCR model first. Registry GGUF models resolve their pipeline
+ * // and detector automatically:
+ * //   EasyOCR (default): OCR_LATIN  (CRAFT detector auto-derived)
+ * //   DocTR:             OCR_DOCTR  (DBNet detector auto-derived)
+ * const modelId = await loadModel({
+ *   modelSrc: OCR_LATIN.src,
+ *   modelType: MODEL_TYPES.ggmlOcr,
+ * });
+ *
  * // Non-streaming mode (default) - get all blocks at once
  * const { blocks } = ocr({ modelId, image: "/path/to/image.png" });
  * for (const block of await blocks) {