import { QvacErrorBase } from "@qvac/error";
import type { CompletionStats, ToolCallWithCall } from "../schemas/index";
/**
 * 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 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 ModelIsDelegatedError 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 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);
}
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);
}
/**
 * Thrown when the prompt exceeds the loaded model's configured context
 * window — 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.
 *
 * Carries the addon-reported prompt size and the model's context window
 * when the addon's error message includes them (the C++ overflow paths
 * in `TextLlmContext.cpp` and `MtmdLlmContext.cpp` format both numbers
 * into the message; the bare `processPromptImpl: context overflow`
 * fallback in `LlamaModel.cpp` carries neither — both fields are
 * therefore optional). `modelId` is supplied by the server-side handler
 * that wraps the addon error.
 *
 * Round-trips the RPC boundary via the typed-error reconstructor in
 * `client/rpc/rpc-error.ts`, so `err instanceof ContextOverflowError`
 * works on the consumer side.
 */
export declare class ContextOverflowError extends QvacErrorBase {
    readonly promptTokens?: number;
    readonly ctxSize?: number;
    readonly modelId?: string;
    constructor(promptTokens?: number, ctxSize?: number, modelId?: string, cause?: unknown);
    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 RPC error envelope so the client-side
     * reconstructor in `client/rpc/rpc-error.ts` can rebuild this exact
     * class on the consumer side. Without this, `err instanceof
     * RequestIdConflictError` would always be `false` after the error
     * crosses the worker boundary.
     */
    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);
 *        }
 *      }
 *
 * The error is constructed client-side in
 * `client/api/completion-stream.ts` when the wire stream ends with
 * `stopReason: "cancelled"` — the partial payload comes from the
 * client's own event aggregator. The class lives in `errors-server.ts`
 * (and is re-exported from the package root) because the *semantic*
 * origin of the cancel is server-side, and other handlers
 * (embeddings, transcribe, …) will reuse the same class once their
 * cancel surface lands.
 */
export declare class InferenceCancelledError extends QvacErrorBase {
    readonly requestId: string;
    readonly partial: InferenceCancelledPartial;
    constructor(requestId: string, partial?: InferenceCancelledPartial, cause?: 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 ConfigReloadNotSupportedError extends QvacErrorBase {
    constructor(modelId: 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 OCRFailedError extends QvacErrorBase {
    constructor(details?: 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 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 RAGUnknownOperationError extends QvacErrorBase {
    constructor(operation: string, cause?: unknown);
}
export declare class RAGHyperDBFailedError 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 HTTPError extends QvacErrorBase {
    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 ConfigAlreadySetError extends QvacErrorBase {
    constructor(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 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 DelegateNoFinalResponseError extends QvacErrorBase {
    constructor(cause?: unknown);
}
export declare class DelegateConnectionFailedError extends QvacErrorBase {
    constructor(details: string, cause?: unknown);
}
export declare class DelegateProviderError extends QvacErrorBase {
    constructor(details: string, providerCode?: number, 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);
}
//# sourceMappingURL=errors-server.d.ts.map