gnome-jarvis/QVAC.md

QVAC integration pin

Pinned against the live QVAC documentation for SDK series v0.19.x on 2026-09-11. Source of truth: https://docs.qvac.tether.io/reference/api/ and https://docs.qvac.tether.io/reference/release-notes/.

Rules for Jarvis

• Use the function-centric @qvac/sdk API in the 0.19.x series. The current repository package pin is 0.19.1; verify the installed package before use.
• Do not use removed startQVACProvider, delegate, or no_mmap APIs.
• Use load_mode for the replacement load behavior described by the release notes.
• Use completion() for streamed LLM work; its canonical surfaces are events and final.
• Use loadModel() / unloadModel() for model lifecycle.
• Use textToSpeech() or textToSpeechStream() for TTS.
• Use transcribe() / transcribeStream() for ASR, ocr() for OCR, translate() for text translation, and assessModelFit() before model fetch.
• Use cancel({ requestId }) for a specific operation and suspend() / resume() for runtime lifecycle.
• QVAC's local HTTP server is qvac serve --openai; it exposes OpenAI-compatible /v1/* at http://127.0.0.1:11434/v1/. qvac serve openai is deprecated.

v0.19 API names used by the capability registry

completion, batchCompletion, embed, ragIngest, ragSearch, ragReindex, ragDeleteEmbeddings, ragListWorkspaces, diffusion, video, audioGen, transcribe, transcribeStream, textToSpeech, textToSpeechStream, translate, ocr, classify, bciTranscribe, vla, worldCreateScene, worldStep, assessModelFit, downloadAsset, cancel, loadModel, unloadModel, suspend, resume, getSystemResources, getLoadedModelInfo, getModelInfo, modelRegistryList, modelRegistrySearch, modelRegistryGetModel, and state are documented public surfaces. Confirm parameter types against the installed .d.ts files before implementing each skill.

The HTTP server mounts /v1/chat/completions, /v1/responses, /v1/completions, /v1/embeddings, files/vector stores, image/video generation, audio transcription/speech/translation, and /qvac/v1/translate.