@qvac/sdk 0.8.1 → 1.1.0

package/dist/server/worker-core.js

@@ -1,88 +0,0 @@
-import process from "bare-process";
-import { createBareKitRPCServer, createIPCClient, } from "./rpc/create-server.js";
-import { destroySwarm } from "./bare/hyperswarm.js";
-import { initEnv, getValidatedEnv } from "./env.js";
-import { closeAllRagInstances } from "./bare/rag-hyperdb/index.js";
-import { cleanupDownloads } from "./rpc/handlers/load-model/download-manager.js";
-import { unloadAllModels } from "./bare/registry/model-registry.js";
-import { closeRegistryClient } from "./bare/registry/registry-client.js";
-import { clearAllLoggingStreams, startLogBuffering, } from "./bare/registry/logging-stream-registry.js";
-import { clearAllAddonLoggers, getServerLogger, SDK_LOG_ID } from "../logging/index.js";
-import { clearPlugins } from "./plugins/index.js";
-let coreInitialized = false;
-let rpcInitialized = false;
-let isShuttingDown = false;
-const logger = getServerLogger();
-export function initializeWorkerCore() {
-    if (coreInitialized) {
-        const validatedEnv = getValidatedEnv();
-        return { hasRPCConfig: !!validatedEnv.QVAC_IPC_SOCKET_PATH };
-    }
-    startLogBuffering(SDK_LOG_ID);
-    const { hasRPCConfig } = initEnv();
-    setupShutdownHandlers();
-    coreInitialized = true;
-    logger.debug("Worker core initialized");
-    logger.debug("Arguments to worker:", process.argv);
-    return { hasRPCConfig };
-}
-export function ensureRPCSetup() {
-    if (rpcInitialized)
-        return;
-    if (!coreInitialized) {
-        initializeWorkerCore();
-    }
-    try {
-        const validatedEnv = getValidatedEnv();
-        const ipcSocketPath = validatedEnv.QVAC_IPC_SOCKET_PATH;
-        if (ipcSocketPath) {
-            logger.info(`Running in desktop mode, connecting to IPC socket: ${ipcSocketPath}`);
-            const rpc = createIPCClient(ipcSocketPath);
-            logger.debug("Desktop IPC client created?", !!rpc);
-        }
-        else {
-            logger.info("Running in BareKit IPC mode");
-            createBareKitRPCServer();
-        }
-        logger.info("Bare worker started and listening for RPC requests");
-        logger.debug("Working directory:", process.cwd());
-        rpcInitialized = true;
-    }
-    catch (error) {
-        logger.error("Worker error:", error);
-        process.exit(1);
-    }
-}
-export function isCoreInitialized() {
-    return coreInitialized;
-}
-function clearRegistries() {
-    clearAllLoggingStreams();
-    clearAllAddonLoggers();
-    clearPlugins();
-}
-function setupShutdownHandlers() {
-    const shutdownHandler = async () => {
-        if (isShuttingDown)
-            return;
-        isShuttingDown = true;
-        logger.info("🐻 Bare worker shutdown signal received, cleaning up...");
-        try {
-            clearRegistries();
-            await Promise.allSettled([
-                destroySwarm(),
-                closeAllRagInstances(),
-                cleanupDownloads(),
-                unloadAllModels(),
-                closeRegistryClient(),
-            ]);
-            logger.info("✅ Cleanup completed successfully");
-        }
-        catch (error) {
-            logger.error("❌ Error during shutdown cleanup:", error);
-        }
-        process.exit(0);
-    };
-    process.once("SIGTERM", () => void shutdownHandler());
-    process.once("SIGINT", () => void shutdownHandler());
-}

package/dist/utils/errors-base.d.ts

@@ -1,3 +0,0 @@
-import type { QvacErrorOptions } from "@qvac/error";
-export declare function createErrorOptions(code: number, adds?: string | (string | number)[], cause?: unknown): QvacErrorOptions;
-//# sourceMappingURL=errors-base.d.ts.map

package/dist/utils/errors-base.js

@@ -1,13 +0,0 @@
-export function createErrorOptions(code, adds, cause) {
-    const options = { code };
-    if (adds !== undefined) {
-        options.adds = adds;
-    }
-    if (cause !== undefined) {
-        options.cause =
-            cause instanceof Error
-                ? cause
-                : new Error(typeof cause === "string" ? cause : JSON.stringify(cause));
-    }
-    return options;
-}

package/dist/utils/errors-client.d.ts

@@ -1,137 +0,0 @@
-import { QvacErrorBase } from "@qvac/error";
-export declare class InvalidResponseError extends QvacErrorBase {
-    constructor(expected: string, cause?: unknown);
-}
-export declare class InvalidOperationError extends QvacErrorBase {
-    constructor(cause?: unknown);
-}
-export declare class StreamEndedError extends QvacErrorBase {
-    constructor(cause?: unknown);
-}
-export declare class InvalidAudioChunkError extends QvacErrorBase {
-    constructor(cause?: unknown);
-}
-export declare class InvalidToolsArrayError extends QvacErrorBase {
-    constructor(cause?: unknown);
-}
-export declare class InvalidToolSchemaError extends QvacErrorBase {
-    constructor(details: string, cause?: unknown);
-}
-export declare class OCRFailedError extends QvacErrorBase {
-    constructor(details?: string, cause?: unknown);
-}
-export declare class RPCNoHandlerError extends QvacErrorBase {
-    constructor(requestType: string, cause?: unknown);
-}
-export declare class RPCRequestNotSentError extends QvacErrorBase {
-    constructor(cause?: unknown);
-}
-export declare class RPCResponseStreamNotCreatedError extends QvacErrorBase {
-    constructor(cause?: unknown);
-}
-export declare class RPCConnectionFailedError extends QvacErrorBase {
-    constructor(details: string, cause?: unknown);
-}
-export declare class ProviderStartFailedError extends QvacErrorBase {
-    constructor(details?: string, cause?: unknown);
-}
-export declare class ProviderStopFailedError extends QvacErrorBase {
-    constructor(details?: string, cause?: unknown);
-}
-export declare class DelegateNoFinalResponseError extends QvacErrorBase {
-    constructor(cause?: unknown);
-}
-export declare class DelegateProviderError extends QvacErrorBase {
-    constructor(details: string, cause?: unknown);
-}
-export declare class DelegateConnectionFailedError extends QvacErrorBase {
-    constructor(details: string, cause?: unknown);
-}
-export declare class SDKNotFoundInNodeModulesError extends QvacErrorBase {
-    constructor(cause?: unknown);
-}
-export declare class MultipleSDKInstallationsError extends QvacErrorBase {
-    constructor(packages: string, cause?: unknown);
-}
-export declare class WorkerFileNotFoundError extends QvacErrorBase {
-    constructor(workerPath: string, cause?: unknown);
-}
-export declare class PearWorkerEntryRequiredError extends QvacErrorBase {
-    constructor(workerEntry: string, cause?: unknown);
-}
-export declare class ConfigFileNotFoundError extends QvacErrorBase {
-    constructor(searchPaths: string, cause?: unknown);
-}
-export declare class ConfigFileInvalidError extends QvacErrorBase {
-    constructor(filePath: string, reason: string, cause?: unknown);
-}
-export declare class ConfigFileParseFailedError extends QvacErrorBase {
-    constructor(filePath: string, error: string, cause?: unknown);
-}
-export declare class ConfigValidationFailedError extends QvacErrorBase {
-    constructor(errors: string, cause?: unknown);
-}
-export declare class ModelUnloadFailedError extends QvacErrorBase {
-    constructor(modelId?: string, cause?: unknown);
-}
-export declare class EmbedFailedError extends QvacErrorBase {
-    constructor(details?: string, cause?: unknown);
-}
-export declare class TranscriptionFailedError extends QvacErrorBase {
-    constructor(details?: string, cause?: unknown);
-}
-export declare class TranslationFailedError extends QvacErrorBase {
-    constructor(details?: string, cause?: unknown);
-}
-export declare class CancelFailedError extends QvacErrorBase {
-    constructor(details?: string, cause?: unknown);
-}
-export declare class RAGChunkFailedError extends QvacErrorBase {
-    constructor(details?: string, cause?: unknown);
-}
-export declare class RAGSaveFailedError extends QvacErrorBase {
-    constructor(details?: string, cause?: unknown);
-}
-export declare class RAGSearchFailedError extends QvacErrorBase {
-    constructor(details?: string, cause?: unknown);
-}
-export declare class RAGDeleteFailedError extends QvacErrorBase {
-    constructor(details?: string, cause?: unknown);
-}
-export declare class RAGCloseWorkspaceFailedError extends QvacErrorBase {
-    constructor(details?: string, cause?: unknown);
-}
-export declare class RAGListWorkspacesFailedError extends QvacErrorBase {
-    constructor(details?: string, cause?: unknown);
-}
-export declare class DownloadAssetFailedError extends QvacErrorBase {
-    constructor(details?: string, cause?: unknown);
-}
-export declare class DownloadCancelledError extends QvacErrorBase {
-    constructor(cause?: unknown);
-}
-export declare class ChecksumValidationFailedError extends QvacErrorBase {
-    constructor(fileName: string, cause?: unknown);
-}
-export declare class HTTPError extends QvacErrorBase {
-    constructor(status: number, statusText: string, cause?: unknown);
-}
-export declare class ModelLoadFailedError extends QvacErrorBase {
-    constructor(details?: string, cause?: unknown);
-}
-export declare class DeleteCacheFailedError extends QvacErrorBase {
-    constructor(details?: string, cause?: unknown);
-}
-export declare class InvalidDeleteCacheParamsError extends QvacErrorBase {
-    constructor(cause?: unknown);
-}
-export declare class SetConfigFailedError extends QvacErrorBase {
-    constructor(details?: string, cause?: unknown);
-}
-export declare class ModelRegistryQueryFailedError extends QvacErrorBase {
-    constructor(details?: string, cause?: unknown);
-}
-export declare class ProfilerInvalidCapacityError extends QvacErrorBase {
-    constructor(minCapacity: number, cause?: unknown);
-}
-//# sourceMappingURL=errors-client.d.ts.map

package/dist/utils/errors-client.js

@@ -1,240 +0,0 @@
-import { QvacErrorBase } from "@qvac/error";
-import { SDK_CLIENT_ERROR_CODES } from "../schemas/sdk-errors-client.js";
-import { SDK_SERVER_ERROR_CODES } from "../schemas/sdk-errors-server.js";
-import { createErrorOptions } from "./errors-base.js";
-// ============== Response Validation Errors ==============
-export class InvalidResponseError extends QvacErrorBase {
-    constructor(expected, cause) {
-        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.INVALID_RESPONSE_TYPE, [expected], cause));
-    }
-}
-export class InvalidOperationError extends QvacErrorBase {
-    constructor(cause) {
-        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.INVALID_OPERATION_IN_RESPONSE, undefined, cause));
-    }
-}
-export class StreamEndedError extends QvacErrorBase {
-    constructor(cause) {
-        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.STREAM_ENDED_WITHOUT_RESPONSE, undefined, cause));
-    }
-}
-export class InvalidAudioChunkError extends QvacErrorBase {
-    constructor(cause) {
-        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.INVALID_AUDIO_CHUNK_TYPE, undefined, cause));
-    }
-}
-export class InvalidToolsArrayError extends QvacErrorBase {
-    constructor(cause) {
-        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.INVALID_TOOLS_ARRAY, undefined, cause));
-    }
-}
-export class InvalidToolSchemaError extends QvacErrorBase {
-    constructor(details, cause) {
-        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.INVALID_TOOL_SCHEMA, [details], cause));
-    }
-}
-export class OCRFailedError extends QvacErrorBase {
-    constructor(details, cause) {
-        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.OCR_FAILED, details ? [details] : undefined, cause));
-    }
-}
-// ============== RPC Communication Errors ==============
-export class RPCNoHandlerError extends QvacErrorBase {
-    constructor(requestType, cause) {
-        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.RPC_NO_HANDLER, [requestType], cause));
-    }
-}
-export class RPCRequestNotSentError extends QvacErrorBase {
-    constructor(cause) {
-        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.RPC_REQUEST_NOT_SENT, undefined, cause));
-    }
-}
-export class RPCResponseStreamNotCreatedError extends QvacErrorBase {
-    constructor(cause) {
-        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.RPC_RESPONSE_STREAM_NOT_CREATED, undefined, cause));
-    }
-}
-export class RPCConnectionFailedError extends QvacErrorBase {
-    constructor(details, cause) {
-        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.RPC_CONNECTION_FAILED, [details], cause));
-    }
-}
-// ============== Provider/Delegation Errors ==============
-export class ProviderStartFailedError extends QvacErrorBase {
-    constructor(details, cause) {
-        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.PROVIDER_START_FAILED, details ? [details] : undefined, cause));
-    }
-}
-export class ProviderStopFailedError extends QvacErrorBase {
-    constructor(details, cause) {
-        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.PROVIDER_STOP_FAILED, details ? [details] : undefined, cause));
-    }
-}
-export class DelegateNoFinalResponseError extends QvacErrorBase {
-    constructor(cause) {
-        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.DELEGATE_NO_FINAL_RESPONSE, undefined, cause));
-    }
-}
-export class DelegateProviderError extends QvacErrorBase {
-    constructor(details, cause) {
-        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.DELEGATE_PROVIDER_ERROR, [details], cause));
-    }
-}
-export class DelegateConnectionFailedError extends QvacErrorBase {
-    constructor(details, cause) {
-        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.DELEGATE_CONNECTION_FAILED, [details], cause));
-    }
-}
-// ============== Build/Bundle Errors ==============
-export class SDKNotFoundInNodeModulesError extends QvacErrorBase {
-    constructor(cause) {
-        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.SDK_NOT_FOUND_IN_NODE_MODULES, undefined, cause));
-    }
-}
-export class MultipleSDKInstallationsError extends QvacErrorBase {
-    constructor(packages, cause) {
-        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.MULTIPLE_SDK_INSTALLATIONS, [packages], cause));
-    }
-}
-export class WorkerFileNotFoundError extends QvacErrorBase {
-    constructor(workerPath, cause) {
-        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.WORKER_FILE_NOT_FOUND, [workerPath], cause));
-    }
-}
-export class PearWorkerEntryRequiredError extends QvacErrorBase {
-    constructor(workerEntry, cause) {
-        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.PEAR_WORKER_ENTRY_REQUIRED, [workerEntry], cause));
-    }
-}
-export class ConfigFileNotFoundError extends QvacErrorBase {
-    constructor(searchPaths, cause) {
-        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.CONFIG_FILE_NOT_FOUND, [searchPaths], cause));
-    }
-}
-export class ConfigFileInvalidError extends QvacErrorBase {
-    constructor(filePath, reason, cause) {
-        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.CONFIG_FILE_INVALID, [filePath, reason], cause));
-    }
-}
-export class ConfigFileParseFailedError extends QvacErrorBase {
-    constructor(filePath, error, cause) {
-        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.CONFIG_FILE_PARSE_FAILED, [filePath, error], cause));
-    }
-}
-export class ConfigValidationFailedError extends QvacErrorBase {
-    constructor(errors, cause) {
-        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.CONFIG_VALIDATION_FAILED, [errors], cause));
-    }
-}
-// ============== Operation Errors (Client-side wrappers for server operations) ==============
-// These are used by client API to throw errors based on server responses
-// They reference server error codes but are thrown on client side
-export class ModelUnloadFailedError extends QvacErrorBase {
-    constructor(modelId, cause) {
-        super(createErrorOptions(SDK_SERVER_ERROR_CODES.MODEL_UNLOAD_FAILED, modelId ? [modelId] : undefined, cause));
-    }
-}
-export class EmbedFailedError extends QvacErrorBase {
-    constructor(details, cause) {
-        super(createErrorOptions(SDK_SERVER_ERROR_CODES.EMBED_FAILED, details ? [details] : undefined, cause));
-    }
-}
-export class TranscriptionFailedError extends QvacErrorBase {
-    constructor(details, cause) {
-        super(createErrorOptions(SDK_SERVER_ERROR_CODES.TRANSCRIPTION_FAILED, details ? [details] : undefined, cause));
-    }
-}
-export class TranslationFailedError extends QvacErrorBase {
-    constructor(details, cause) {
-        super(createErrorOptions(SDK_SERVER_ERROR_CODES.TRANSLATION_FAILED, details ? [details] : undefined, cause));
-    }
-}
-export class CancelFailedError extends QvacErrorBase {
-    constructor(details, cause) {
-        super(createErrorOptions(SDK_SERVER_ERROR_CODES.CANCEL_FAILED, details ? [details] : undefined, cause));
-    }
-}
-export class RAGChunkFailedError extends QvacErrorBase {
-    constructor(details, cause) {
-        super(createErrorOptions(SDK_SERVER_ERROR_CODES.RAG_CHUNK_FAILED, details ? [details] : undefined, cause));
-    }
-}
-export class RAGSaveFailedError extends QvacErrorBase {
-    constructor(details, cause) {
-        super(createErrorOptions(SDK_SERVER_ERROR_CODES.RAG_SAVE_FAILED, details ? [details] : undefined, cause));
-    }
-}
-export class RAGSearchFailedError extends QvacErrorBase {
-    constructor(details, cause) {
-        super(createErrorOptions(SDK_SERVER_ERROR_CODES.RAG_SEARCH_FAILED, details ? [details] : undefined, cause));
-    }
-}
-export class RAGDeleteFailedError extends QvacErrorBase {
-    constructor(details, cause) {
-        super(createErrorOptions(SDK_SERVER_ERROR_CODES.RAG_DELETE_FAILED, details ? [details] : undefined, cause));
-    }
-}
-export class RAGCloseWorkspaceFailedError extends QvacErrorBase {
-    constructor(details, cause) {
-        super(createErrorOptions(SDK_SERVER_ERROR_CODES.RAG_WORKSPACE_CLOSE_FAILED, details ? [details] : undefined, cause));
-    }
-}
-export class RAGListWorkspacesFailedError extends QvacErrorBase {
-    constructor(details, cause) {
-        super(createErrorOptions(SDK_SERVER_ERROR_CODES.RAG_LIST_WORKSPACES_FAILED, details ? [details] : undefined, cause));
-    }
-}
-export class DownloadAssetFailedError extends QvacErrorBase {
-    constructor(details, cause) {
-        super(createErrorOptions(SDK_SERVER_ERROR_CODES.DOWNLOAD_ASSET_FAILED, details ? [details] : undefined, cause));
-    }
-}
-export class DownloadCancelledError extends QvacErrorBase {
-    constructor(cause) {
-        super(createErrorOptions(SDK_SERVER_ERROR_CODES.DOWNLOAD_CANCELLED, undefined, cause));
-    }
-}
-export class ChecksumValidationFailedError extends QvacErrorBase {
-    constructor(fileName, cause) {
-        super(createErrorOptions(SDK_SERVER_ERROR_CODES.CHECKSUM_VALIDATION_FAILED, [fileName], cause));
-    }
-}
-export class HTTPError extends QvacErrorBase {
-    constructor(status, statusText, cause) {
-        super(createErrorOptions(SDK_SERVER_ERROR_CODES.HTTP_ERROR, [status, statusText], cause));
-    }
-}
-export class ModelLoadFailedError extends QvacErrorBase {
-    constructor(details, cause) {
-        super(createErrorOptions(SDK_SERVER_ERROR_CODES.MODEL_LOAD_FAILED, details ? [details] : undefined, cause));
-    }
-}
-export class DeleteCacheFailedError extends QvacErrorBase {
-    constructor(details, cause) {
-        super(createErrorOptions(SDK_SERVER_ERROR_CODES.DELETE_CACHE_FAILED, details ? [details] : undefined, cause));
-    }
-}
-export class InvalidDeleteCacheParamsError extends QvacErrorBase {
-    constructor(cause) {
-        super(createErrorOptions(SDK_SERVER_ERROR_CODES.INVALID_DELETE_CACHE_PARAMS, undefined, cause));
-    }
-}
-export class SetConfigFailedError extends QvacErrorBase {
-    constructor(details, cause) {
-        super(createErrorOptions(SDK_SERVER_ERROR_CODES.SET_CONFIG_FAILED, details ? [details] : undefined, cause));
-    }
-}
-// ============== QVAC Model Registry Operation Errors ==============
-// Registry client errors (19,001-20,000) are re-thrown directly from @qvac/registry-client
-// Only SDK-specific errors are defined here
-export class ModelRegistryQueryFailedError extends QvacErrorBase {
-    constructor(details, cause) {
-        super(createErrorOptions(SDK_SERVER_ERROR_CODES.QVAC_MODEL_REGISTRY_QUERY_FAILED, details ? [details] : undefined, cause));
-    }
-}
-// ============== Profiler Errors ==============
-export class ProfilerInvalidCapacityError extends QvacErrorBase {
-    constructor(minCapacity, cause) {
-        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.PROFILER_INVALID_CAPACITY, [minCapacity], cause));
-    }
-}