import { QvacErrorBase } from '@qvac/error';
import type { CompletionStats, ToolCallWithCall } from '../schemas/index.js';
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 InvalidToolsArrayError extends QvacErrorBase {
    constructor(cause?: unknown);
}
export declare class InvalidToolSchemaError extends QvacErrorBase {
    constructor(details: string, cause?: unknown);
}
export declare class ModelTypeRequiredError extends QvacErrorBase {
    constructor(cause?: unknown);
}
export declare class ModelSrcTypeMismatchError extends QvacErrorBase {
    constructor(inferred: string, resolved: string, cause?: unknown);
}
export declare class RequestValidationFailedError extends QvacErrorBase {
    constructor(errors: string, cause?: unknown);
}
export declare class RPCNoHandlerError extends QvacErrorBase {
    constructor(requestType: string, cause?: unknown);
}
export declare class PluginsNotRegisteredError extends QvacErrorBase {
    constructor(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 ConfigAlreadySetError extends QvacErrorBase {
    constructor(cause?: unknown);
}
export declare class ConfigReloadNotSupportedError extends QvacErrorBase {
    constructor(modelId: string, cause?: unknown);
}
export declare class ProfilerInvalidCapacityError extends QvacErrorBase {
    constructor(minCapacity: number, cause?: unknown);
}
export declare class ModelAlreadyRegisteredError extends QvacErrorBase {
    constructor(modelId: string, cause?: unknown);
}
export declare class ModelNotFoundError extends QvacErrorBase {
    constructor(modelId: string, cause?: unknown);
}
export declare class ModelNotLoadedError extends QvacErrorBase {
    constructor(modelId: string, cause?: unknown);
}
export declare class ModelLoadFailedError extends QvacErrorBase {
    constructor(details?: string, cause?: unknown);
}
export declare class ModelFileNotFoundError extends QvacErrorBase {
    constructor(modelPath: string, cause?: unknown);
}
export declare class ModelFileNotFoundInDirError extends QvacErrorBase {
    constructor(modelFile: string, modelDir: string, modelType: string, cause?: unknown);
}
export declare class ModelFitRefusedError extends QvacErrorBase {
    constructor(modelType: string, reason: string, detail?: string, cause?: unknown);
}
export declare class ModelFileLocateFailedError extends QvacErrorBase {
    constructor(modelType: string, modelPath: string, cause?: unknown);
}
export declare class ProjectionModelRequiredError extends QvacErrorBase {
    constructor(cause?: unknown);
}
export declare class VADModelRequiredError extends QvacErrorBase {
    constructor(cause?: unknown);
}
export declare class TtsArtifactsRequiredError extends QvacErrorBase {
    constructor(cause?: unknown);
}
export declare class TtsReferenceAudioRequiredError extends QvacErrorBase {
    constructor(cause?: unknown);
}
export declare class LegacyParakeetModelDeprecatedError extends QvacErrorBase {
    constructor(legacyFields: readonly string[], cause?: unknown);
}
export declare class LegacyTtsModelDeprecatedError extends QvacErrorBase {
    constructor(legacyFields: readonly string[], cause?: unknown);
}
/**
 * Partial completion payload attached to `InferenceCancelledError` when a
 * cancel hits mid-stream. Mirrors the named fields on `CompletionFinal`
 * so callers who want the partial output can read `.partial.text`,
 * `.partial.toolCalls`, `.partial.stats` directly without reaching for
 * a `Partial<CompletionFinal>` import.
 *
 * Fields are all optional: a same-tick cancel-before-begin races every
 * event; a cancel after the first content chunk carries `text` but no
 * `stats`; a cancel after a tool-call frame carries both.
 */
export interface InferenceCancelledPartial {
    text?: string;
    toolCalls?: ToolCallWithCall[];
    stats?: CompletionStats;
}
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 EmbedNoEmbeddingsError extends QvacErrorBase {
    constructor(cause?: unknown);
}
export declare class TranscriptionFailedError extends QvacErrorBase {
    constructor(details?: string, cause?: unknown);
}
export declare class AudioFileNotFoundError extends QvacErrorBase {
    constructor(filePath: string, cause?: unknown);
}
export declare class TranslationFailedError extends QvacErrorBase {
    constructor(details?: string, cause?: unknown);
}
export declare class CompletionFailedError extends QvacErrorBase {
    constructor(details?: string, cause?: unknown);
}
/** The overflow sizes as one record; fields admit explicit `undefined` so a parser result assigns directly. */
export type ContextOverflowErrorSizes = {
    promptTokens?: number | undefined;
    cachedTokens?: number | undefined;
    requiredTokens?: number | undefined;
    ctxSize?: number | undefined;
};
/**
 * Thrown when a request no longer fits the model's effective context
 * capacity — distinct from a generic `CompletionFailedError` so consumers
 * can drive UX (truncate, summarize, or surface a "increase ctx_size /
 * start a new thread" CTA) instead of treating it as an opaque failure.
 *
 * All size fields are optional: they carry whatever the addon guard
 * reported (a cold prompt, a warm cached-plus-prompt split, or a bare
 * overflow with no numbers). `modelId` is supplied by the handler that
 * wraps the addon error.
 *
 * Serializes its typed fields (`toErrorResponseFields`) so a receiver can
 * rebuild it after the error crosses a serialization boundary (an RPC
 * response).
 */
export declare class ContextOverflowError extends QvacErrorBase {
    /** The prompt alone, in tokens; unset when the source reported KV cells. */
    readonly promptTokens?: number;
    /** Cached conversation on a warm-cache overflow, in `ctxSize` units. */
    readonly cachedTokens?: number;
    /** Total the failing guard reported, in `ctxSize` units; can equal the window (`>=` triggers). */
    readonly requiredTokens?: number;
    /** Effective per-request ceiling: `ctx_size` split across slots at `parallel > 1`. */
    readonly ctxSize?: number;
    readonly modelId?: string;
    /** Canonical form: the parsed sizes as one record. */
    constructor(contextSizes: ContextOverflowErrorSizes, modelId?: string, cause?: unknown);
    /** @deprecated Kept for external consumers of the published package; in-repo callers use the record form. */
    constructor(promptTokens?: number, ctxSize?: number, modelId?: string, cause?: unknown, extraSizes?: {
        cachedTokens?: number | undefined;
        requiredTokens?: number | undefined;
    });
    toErrorResponseFields(): Record<string, unknown>;
}
export declare class AttachmentNotFoundError extends QvacErrorBase {
    constructor(path: string, cause?: unknown);
}
export declare class CancelFailedError extends QvacErrorBase {
    constructor(details?: string, cause?: unknown);
}
export declare class RequestIdConflictError extends QvacErrorBase {
    readonly requestId: string;
    constructor(requestId: string, cause?: unknown);
    /**
     * Surface typed fields on the serialized error envelope so a receiver can
     * rebuild this exact class from `typedFields` after the error is serialized
     * across a boundary (an RPC response). Without this,
     * `err instanceof RequestIdConflictError` would be `false` on the far side.
     */
    toErrorResponseFields(): Record<string, unknown>;
}
export declare class RequestNotFoundError extends QvacErrorBase {
    readonly requestId: string;
    constructor(requestId: string, cause?: unknown);
    toErrorResponseFields(): Record<string, unknown>;
}
/**
 * Thrown by `await RequestRegistry.begin(...)` when a registered concurrency
 * policy refuses the request. Under the default queue policy a same-model
 * request waits FIFO rather than rejecting, so this fires on the bounded-queue
 * cases: an explicit `onOverflow: "reject"`, the per-model queue-depth cap, or
 * a `queueTimeoutMs` elapsing while waiting for a slot. Distinct from
 * `RequestIdConflictError`, which only fires on UUID collisions.
 */
export declare class RequestRejectedByPolicyError extends QvacErrorBase {
    readonly requestId: string;
    readonly kind: string;
    readonly modelId: string;
    readonly reason: string;
    constructor(requestId: string, kind: string, modelId: string, reason: string, cause?: unknown);
    toErrorResponseFields(): Record<string, unknown>;
}
/**
 * Thrown when a long-running inference request was cancelled before
 * completion. The `events` stream on `CompletionRun` ends normally with
 * `stopReason: "cancelled"` on the last `completionDone`, but the
 * promise-aggregates on the same run (`final` / `text` / `toolCalls` /
 * `stats`) reject with this error so callers can't accidentally treat a
 * cancelled run as a successful one.
 *
 * Carries:
 *  - `requestId` — correlates with `run.requestId` so callers know which
 *    in-flight request was cancelled when they fan out multiple cancels.
 *  - `partial` — whatever the aggregator accumulated up to the cancel
 *    point. Optional fields so consumers can opt into "show partial":
 *
 *      try { await run.text } catch (err) {
 *        if (err instanceof InferenceCancelledError) {
 *          renderPartial(err.partial.text);
 *        }
 *      }
 */
export declare class InferenceCancelledError extends QvacErrorBase {
    readonly requestId: string;
    readonly partial: InferenceCancelledPartial;
    constructor(requestId: string, partial?: InferenceCancelledPartial, cause?: unknown);
    toErrorResponseFields(): Record<string, unknown>;
}
export declare class AsyncDisposeUnavailableError extends QvacErrorBase {
    constructor(cause?: unknown);
}
export declare class TextToSpeechFailedError extends QvacErrorBase {
    constructor(details?: string, cause?: unknown);
}
export declare class TextToSpeechStreamFailedError extends QvacErrorBase {
    constructor(details?: string, cause?: unknown);
}
export declare class ModelTypeMismatchError extends QvacErrorBase {
    constructor(expectedType: string, providedType: string, cause?: unknown);
}
export declare class ModelOperationNotSupportedError extends QvacErrorBase {
    readonly modelId: string;
    readonly modelType: string;
    readonly operation: string;
    readonly supportedOperations: readonly string[];
    readonly suggestedModelTypes: readonly string[];
    constructor(modelId: string, modelType: string, operation: string, supportedOperations: readonly string[], suggestedModelTypes: readonly string[], cause?: unknown);
}
export declare class ImageFileNotFoundError extends QvacErrorBase {
    constructor(filePath: string, cause?: unknown);
}
export declare class InvalidImageInputError extends QvacErrorBase {
    constructor(cause?: unknown);
}
export declare class InvalidAudioInputError 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 RAGChunkFailedError 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 RAGUnknownOperationError extends QvacErrorBase {
    constructor(operation: string, cause?: unknown);
}
export declare class RAGHyperDBFailedError extends QvacErrorBase {
    constructor(details: string, cause?: unknown);
}
export declare class RAGWorkspaceModelMismatchError extends QvacErrorBase {
    constructor(workspace: string, existingModelId: string, newModelId: string, cause?: unknown);
}
export declare class RAGWorkspaceNotFoundError extends QvacErrorBase {
    constructor(workspace: string, cause?: unknown);
}
export declare class RAGWorkspaceInUseError extends QvacErrorBase {
    constructor(workspace: string, cause?: unknown);
}
export declare class RAGWorkspaceNotOpenError extends QvacErrorBase {
    constructor(workspace: string, cause?: unknown);
}
export declare class VectorIndexProviderUnavailableError extends QvacErrorBase {
    constructor(cause?: unknown);
}
export declare class VectorIndexNotFoundError extends QvacErrorBase {
    constructor(indexId: string, cause?: unknown);
}
export declare class VectorIndexInvalidVectorsError extends QvacErrorBase {
    constructor(details: string, cause?: unknown);
}
export declare class VectorIndexFailedError extends QvacErrorBase {
    constructor(details: string, cause?: unknown);
}
export declare class FileNotFoundError extends QvacErrorBase {
    constructor(path: 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 InsecureModelSourceError extends QvacErrorBase {
    constructor(url: string, reason: string, cause?: unknown);
}
export declare class ChecksumUnavailableError extends QvacErrorBase {
    constructor(url: string, cause?: unknown);
}
export declare class HTTPError extends QvacErrorBase {
    /** HTTP status code; `0` denotes a connection/network failure (no response). */
    readonly httpStatus: number;
    constructor(status: number, statusText: string, cause?: unknown);
}
export declare class NoResponseBodyError extends QvacErrorBase {
    constructor(cause?: unknown);
}
export declare class ResponseBodyNotReadableError extends QvacErrorBase {
    constructor(cause?: unknown);
}
export declare class NoBlobFoundError extends QvacErrorBase {
    constructor(fileName: string, cause?: unknown);
}
export declare class DownloadAssetFailedError extends QvacErrorBase {
    constructor(details?: string, cause?: unknown);
}
export declare class SeedingNotSupportedError extends QvacErrorBase {
    constructor(cause?: unknown);
}
export declare class HyperdriveDownloadFailedError extends QvacErrorBase {
    constructor(details: string, cause?: unknown);
}
export declare class RegistryDownloadFailedError extends QvacErrorBase {
    constructor(details: string, cause?: unknown);
}
export declare class InvalidShardUrlPatternError extends QvacErrorBase {
    constructor(url: string, cause?: unknown);
}
export declare class ArchiveExtractionFailedError extends QvacErrorBase {
    constructor(archivePath: string, cause?: unknown);
}
export declare class ArchiveUnsupportedTypeError extends QvacErrorBase {
    constructor(archivePath: string, cause?: unknown);
}
export declare class ArchiveMissingShardsError extends QvacErrorBase {
    constructor(missingFile: string, cause?: unknown);
}
export declare class PartialDownloadOfflineError extends QvacErrorBase {
    constructor(url: string, downloadedBytes: number, 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 CacheDirNotAbsoluteError extends QvacErrorBase {
    constructor(cause?: unknown);
}
export declare class CacheDirNotWritableError extends QvacErrorBase {
    constructor(cacheDir: string, details?: string, cause?: unknown);
}
export declare class FFmpegNotAvailableError extends QvacErrorBase {
    constructor(cause?: unknown);
}
export declare class AudioPlayerFailedError extends QvacErrorBase {
    constructor(details: string, cause?: unknown);
}
export declare class InvalidAudioChunkError extends QvacErrorBase {
    constructor(cause?: unknown);
}
export declare class RPCNoDataReceivedError extends QvacErrorBase {
    constructor(cause?: unknown);
}
export declare class RPCUnknownRequestTypeError extends QvacErrorBase {
    constructor(requestType: string, cause?: unknown);
}
export declare class PluginNotFoundError extends QvacErrorBase {
    constructor(modelType: string, cause?: unknown);
}
export declare class PluginHandlerNotFoundError extends QvacErrorBase {
    constructor(modelType: string, handler: string, availableHandlers?: string[], cause?: unknown);
}
export declare class PluginRequestValidationFailedError extends QvacErrorBase {
    constructor(handler: string, details?: string, cause?: unknown);
}
export declare class PluginResponseValidationFailedError extends QvacErrorBase {
    constructor(handler: string, details?: string, cause?: unknown);
}
export declare class PluginAlreadyRegisteredError extends QvacErrorBase {
    constructor(modelType: string, cause?: unknown);
}
export declare class PluginModelTypeReservedError extends QvacErrorBase {
    constructor(modelType: string, cause?: unknown);
}
export declare class PluginLoadConfigValidationFailedError extends QvacErrorBase {
    constructor(modelType: string, details: string, cause?: unknown);
}
export declare class PluginHandlerTypeMismatchError extends QvacErrorBase {
    constructor(handlerName: string, expected: string, actual: string, cause?: unknown);
}
export declare class PluginLoggingInvalidError extends QvacErrorBase {
    constructor(modelType: string, reason: string, cause?: unknown);
}
export declare class PluginDefinitionInvalidError extends QvacErrorBase {
    constructor(modelType: string, details: string, cause?: unknown);
}
export declare class LifecycleSuspendFailedError extends QvacErrorBase {
    constructor(details?: string, cause?: unknown);
}
export declare class LifecycleResumeFailedError extends QvacErrorBase {
    constructor(details?: string, cause?: unknown);
}
export declare class LifecycleOperationBlockedError extends QvacErrorBase {
    constructor(requestType: string, lifecycleState: string);
}
export declare class PathTraversalError extends QvacErrorBase {
    constructor(component: string, basePath: string, cause?: unknown);
}
export declare class ModelRegistryQueryFailedError extends QvacErrorBase {
    constructor(details?: string, cause?: unknown);
}
export declare class RpcServerOperationError extends QvacErrorBase {
    readonly operation: string;
    readonly details: string;
    constructor(operation: string, details: string, cause?: unknown);
    toErrorResponseFields(): Record<string, unknown>;
}