@qvac/harness 0.2.6 → 0.2.8

package/dist-lib/index.js

@@ -2,65 +2,65 @@ import fs from 'fs';
 import { platform, totalmem } from 'os';
 import process from 'process';
 import ReadyResource from 'ready-resource';
-import { probeGpuStats } from "./lib/hardware/gpu-probe.js";
-import { probeCapabilityProfile } from "./lib/hardware/capability-probe.js";
-import { closePythonWorker } from "./lib/tools/exec/adapters/python/worker/client.js";
-import { completion } from "./lib/capabilities/completion.js";
-import { download } from "./lib/capabilities/download.js";
-import { createEmbedLane } from "./lib/capabilities/embed.js";
-import { deleteAllKvCaches, deleteKvCacheKey } from "./lib/capabilities/kv-cache.js";
-import { pcmForTranscription } from "./lib/capabilities/audio-resample.js";
-import { buildWavBuffer } from "./lib/wav-encode.js";
-import { createVoiceLane, packSamples, speakOnce, speakStreamOnce, transcribeOnce, transcribeStreaming, SUPERTONIC_SAMPLE_RATE } from "./lib/capabilities/voice.js";
-import { pushQueue } from "./lib/queue.js";
-import { AbortedError, raceAbort } from "./lib/helpers/race-abort.js";
-import { audioGenDownloadMetadata, customProjectionMap, defaultProjectionMap, defaultTtsFor, defaultVoiceModel, diffusionDownloadMetadata, infraModelsFor, modelNameToCapabilityProfile, musicModelSet, setCustomModels } from "./lib/models/model-catalog.js";
-import { createModelStatusCache, invalidateModelStatusCache, listModels } from "./lib/models/model-list.js";
-import { deleteModelFiles, summarizeDelete } from "./lib/models/model-delete.js";
-import { createEmbedPool, createLoadTracker, createModelPool, createVoicePool, awaitModelCapacity, evictIdle, evictModelWithin, isResident, leaseCount, loadedModels, modelKey, releaseModel, resolveLoadOptions, progressState } from "./lib/models/model-pool.js";
-import { resolveMainGpu } from "./lib/models/gpu-selection.js";
-import { openclCacheDir } from "./lib/models/opencl-cache.js";
-import { assertEmbedDevice, createEmbedConfig } from "./lib/models/embed-config.js";
-import { createGpuFaultState, isSdkGpuDeviceLostError, isSdkModelWedgedError } from "./lib/models/sdk-faults.js";
-import { createSdkLoader } from "./lib/sdk-loader.js";
-import { createEditImageTool } from "./lib/tools/edit-image.js";
-import { toolCatalog } from "./lib/tools/catalog.js";
-import { createDiffusionRuntime, createGenerateImageTool } from "./lib/tools/generate-image.js";
-import { createGenerateMusicTool, createMusicRuntime } from "./lib/tools/generate-music.js";
-import { availableSkills, detectPlatform, loadSkillCatalog, resolveSkillStatuses, skillSupportsPlatform, versionProbeSkills } from "./lib/tools/skills/catalog.js";
-import { ensureBundledSkillsDir } from "./lib/tools/skills/bundled-dir.js";
-import { ensureSkillsOverlayDir } from "./lib/tools/skills/overlay-dir.js";
-import { copyBaseForEdit, deleteOverlaySkill, listManagedSkills, readSkillFile, writeSkillFile } from "./lib/tools/skills/overlay-crud.js";
-import { watchSkillsOverlay } from "./lib/tools/skills/overlay-watch.js";
-import { hlog } from "./lib/log.js";
+import { probeGpuStats } from './lib/hardware/gpu-probe.js';
+import { probeCapabilityProfile } from './lib/hardware/capability-probe.js';
+import { closePythonWorker } from './lib/tools/exec/adapters/python/worker/client.js';
+import { completion } from './lib/capabilities/completion.js';
+import { download } from './lib/capabilities/download.js';
+import { createEmbedLane } from './lib/capabilities/embed.js';
+import { deleteAllKvCaches, deleteKvCacheKey } from './lib/capabilities/kv-cache.js';
+import { pcmForTranscription } from './lib/capabilities/audio-resample.js';
+import { buildWavBuffer } from './lib/wav-encode.js';
+import { createVoiceLane, packSamples, speakOnce, speakStreamOnce, transcribeOnce, transcribeStreaming, SUPERTONIC_SAMPLE_RATE } from './lib/capabilities/voice.js';
+import { pushQueue } from './lib/queue.js';
+import { AbortedError, raceAbort } from './lib/helpers/race-abort.js';
+import { audioGenDownloadMetadata, customProjectionMap, defaultProjectionMap, defaultTtsFor, defaultVoiceModel, diffusionDownloadMetadata, infraModelsFor, modelNameToCapabilityProfile, musicModelSet, setCustomModels } from './lib/models/model-catalog.js';
+import { createModelStatusCache, invalidateModelStatusCache, listModels } from './lib/models/model-list.js';
+import { deleteModelFiles, summarizeDelete } from './lib/models/model-delete.js';
+import { createEmbedPool, createLoadTracker, createModelPool, createVoicePool, awaitModelCapacity, evictIdle, evictModelWithin, isResident, leaseCount, loadedModels, modelKey, releaseModel, resolveLoadOptions, progressState } from './lib/models/model-pool.js';
+import { resolveMainGpu } from './lib/models/gpu-selection.js';
+import { openclCacheDir } from './lib/models/opencl-cache.js';
+import { assertEmbedDevice, createEmbedConfig } from './lib/models/embed-config.js';
+import { createGpuFaultState, isSdkGpuDeviceLostError, isSdkModelWedgedError } from './lib/models/sdk-faults.js';
+import { createSdkLoader } from './lib/sdk-loader.js';
+import { createEditImageTool } from './lib/tools/edit-image.js';
+import { toolCatalog } from './lib/tools/catalog.js';
+import { createDiffusionRuntime, createGenerateImageTool } from './lib/tools/generate-image.js';
+import { createGenerateMusicTool, createMusicRuntime } from './lib/tools/generate-music.js';
+import { availableSkills, detectPlatform, loadSkillCatalog, resolveSkillStatuses, skillSupportsPlatform, versionProbeSkills } from './lib/tools/skills/catalog.js';
+import { ensureBundledSkillsDir } from './lib/tools/skills/bundled-dir.js';
+import { ensureSkillsOverlayDir } from './lib/tools/skills/overlay-dir.js';
+import { copyBaseForEdit, deleteOverlaySkill, listManagedSkills, readSkillFile, writeSkillFile } from './lib/tools/skills/overlay-crud.js';
+import { watchSkillsOverlay } from './lib/tools/skills/overlay-watch.js';
+import { hlog } from './lib/log.js';
 import { harness } from './spec/index.js';
-import { installResolutionDetector, resolutionDetail } from "./lib/resolution-detector.js";
-import { probeBinVersions } from "./lib/tools/skills/bin-check.js";
-import { bareRuntime } from "./lib/tools/exec.js";
-import { runCommand } from "./lib/tools/exec/runner.js";
-import { createLocalRoots } from "./lib/tools/fs/local.js";
-import { createRemoteRoots } from "./lib/tools/fs/remote.js";
-import { resetCredentialHealth as resetCredentialHealthAfterSnapshot } from "./lib/tools/skills/credential-health.js";
-import { isDeviceSharedCredentialKey, scopeKey } from "./lib/tools/skills/scope-key.js";
-import { settingsScopeKey } from "./lib/tools/skills/skill-settings.js";
-export * from "./lib/capabilities/completion.js";
-export { attachmentTurn, loadedSkillsFrom, skillLoadedTurn } from "./lib/capabilities/tool-turns.js";
-export * from "./lib/capabilities/download.js";
-export * from "./lib/models/model-catalog.js";
-export * from "./lib/models/model-list.js";
-export { harnessChild, spawnHarness } from "./lib/spawn.js";
-export { settingsDimension, settingsSteps } from "./lib/tools/generate-image.js";
-export * from "./lib/tools/skills/catalog.js";
-export { requiredSettings, settingEnvName } from "./lib/tools/skills/skill-settings.js";
-export { TOOLSETS, toolsetEnabled } from "./lib/tools/toolsets.js";
-export { markCredentialRejected, markCredentialValid, recordCredentialHealth, resetAllCredentialHealth, resetCredentialHealth } from "./lib/tools/skills/credential-health.js";
-export { readSetup as normalizeSkillSetup } from "./lib/tools/skills/manifest-parse.js";
-export { isAvailableState, SKILL_STATE } from "./lib/tools/skills/skill-state.js";
-export { connectHarness, HARNESS_DIED, RemoteHarness } from "./lib/connect.js";
-export { serveHarness } from "./lib/serve.js";
-export { hlog, setHarnessLog, setHarnessLogSink } from "./lib/log.js";
-export { harnessHooks } from "./lib/hooks/registry.js";
-export { EgressGuardHook, SkillCatalogGuardHook } from "./lib/hooks/built-in/index.js";
+import { installResolutionDetector, resolutionDetail } from './lib/resolution-detector.js';
+import { probeBinVersions } from './lib/tools/skills/bin-check.js';
+import { bareRuntime } from './lib/tools/exec.js';
+import { runCommand } from './lib/tools/exec/runner.js';
+import { createLocalRoots } from './lib/tools/fs/local.js';
+import { createRemoteRoots } from './lib/tools/fs/remote.js';
+import { resetCredentialHealth as resetCredentialHealthAfterSnapshot } from './lib/tools/skills/credential-health.js';
+import { isDeviceSharedCredentialKey, scopeKey } from './lib/tools/skills/scope-key.js';
+import { settingsScopeKey } from './lib/tools/skills/skill-settings.js';
+export * from './lib/capabilities/completion.js';
+export { attachmentTurn, loadedSkillsFrom, skillLoadedTurn } from './lib/capabilities/tool-turns.js';
+export * from './lib/capabilities/download.js';
+export * from './lib/models/model-catalog.js';
+export * from './lib/models/model-list.js';
+export { harnessChild, spawnHarness } from './lib/spawn.js';
+export { settingsDimension, settingsSteps } from './lib/tools/generate-image.js';
+export * from './lib/tools/skills/catalog.js';
+export { requiredSettings, settingEnvName } from './lib/tools/skills/skill-settings.js';
+export { TOOLSETS, toolsetEnabled } from './lib/tools/toolsets.js';
+export { markCredentialRejected, markCredentialValid, recordCredentialHealth, resetAllCredentialHealth, resetCredentialHealth } from './lib/tools/skills/credential-health.js';
+export { readSetup as normalizeSkillSetup } from './lib/tools/skills/manifest-parse.js';
+export { isAvailableState, SKILL_STATE } from './lib/tools/skills/skill-state.js';
+export { connectHarness, HARNESS_DIED, RemoteHarness } from './lib/connect.js';
+export { serveHarness } from './lib/serve.js';
+export { hlog, setHarnessLog, setHarnessLogSink } from './lib/log.js';
+export { harnessHooks } from './lib/hooks/registry.js';
+export { EgressGuardHook, SkillCatalogGuardHook } from './lib/hooks/built-in/index.js';
 const HarnessState = harness.getEnum('@harness/state');
 const BIN_VERSION_PROBE_TTL_MS = 45_000;
 const TRANSCRIBE_STREAM_MIN_BYTES = 16_000 * 2 * 60;

package/dist-lib/lib/audio-transcode-bare.js

@@ -1,6 +1,6 @@
 import ffmpeg from 'bare-ffmpeg';
-import { hlog } from "./log.js";
-import { buildWavBuffer, TARGET_SAMPLE_RATE } from "./wav-encode.js";
+import { hlog } from './log.js';
+import { buildWavBuffer, TARGET_SAMPLE_RATE } from './wav-encode.js';
 function bufferReadIO(input) {
     let offset = 0;
     return new ffmpeg.IOContext(Buffer.alloc(4096), {

package/dist-lib/lib/capabilities/completion.js

@@ -1,34 +1,34 @@
 import process from 'process';
-import { contextCandidates } from "../context-window.js";
-import { errorCode, errorMessage } from "../error-fields.js";
-import { bufferBurst } from "../helpers/buffer-burst.js";
-import { endsTurn, stopAtControlToken, stripControlTokens, truncateAtControlToken } from "../helpers/control-tokens.js";
-import { createMarkupStreamFilter } from "../helpers/markup-stream-filter.js";
-import { AbortedError, raceAbort } from "../helpers/race-abort.js";
-import { createRunOutcomeTracker, degenerateAnswer, unnamedWrites, writeReport } from "../helpers/run-outcome.js";
-import { splitThinking } from "../helpers/thinking.js";
-import { clipRawCall, normalizeToolArgs, recoverMarkupToolCalls, recoverPrintedSkillLoad, recoverSkillNamedCall, stripToolCallMarkup, stripToolResponseBlocks, toolCallMarkup } from "../helpers/tool-call-markup.js";
-import { INTENT_PARAM, INTENT_PARAM_DESCRIPTION, takeToolIntent } from "../helpers/tool-intent.js";
-import { HookPipeline } from "../hooks/pipeline.js";
-import { fallbackToolLabel } from "../helpers/tool-label.js";
-import { hlog } from "../log.js";
-import { resolveLlmGenerationParams } from "../models/llm-presets.js";
-import { customToolDialect } from "../models/model-catalog.js";
-import { isContextOverflowError, isSdkModelWedgedError } from "../models/sdk-faults.js";
-import { annotateLastUserTime, skillsPromptSection, systemPromptParts } from "../prompt.js";
-import { isMetadataMethod } from "../tools/mcp/utils.js";
-import { unquoteArg } from "../tools/model-args.js";
-import { SKILL_TOOL_NAME, WEB_SEARCH_TOOL_NAME } from "./tool-names.js";
-import { promptUsageParts, usageBreakdown } from "./usage-breakdown.js";
-import { collectToolGrants, enabledTools, isSelected, skillIsActive, skillsAreSelected } from "./tool-selection.js";
-import { guardToolCall } from "../tools/outbound-guard.js";
-import { isAvailableState } from "../tools/skills/skill-state-constants.js";
-import { resolveImplicitSkill, resolveSkillMention, skillPreloadMessage } from "../tools/skills/mention.js";
-import { permittedTools } from "../tools/toolsets.js";
-import { promptPrefixHash } from "./prompt-prefix.js";
-import { logToolPrompt } from "./tool-prompt-log.js";
-import { DIRECT_CALL_ID, loadedSkillFilesFrom, loadedSkillsFrom, TOOL_CONTINUATION_NUDGE, toolResultTurn, withoutSkillLoadTurns } from "./tool-turns.js";
-import { projectVisionHistory, visionHistoryCacheKey } from "./vision-history.js";
+import { contextCandidates } from '../context-window.js';
+import { errorCode, errorMessage } from '../error-fields.js';
+import { bufferBurst } from '../helpers/buffer-burst.js';
+import { endsTurn, stopAtControlToken, stripControlTokens, truncateAtControlToken } from '../helpers/control-tokens.js';
+import { createMarkupStreamFilter } from '../helpers/markup-stream-filter.js';
+import { AbortedError, raceAbort } from '../helpers/race-abort.js';
+import { createRunOutcomeTracker, degenerateAnswer, unnamedWrites, writeReport } from '../helpers/run-outcome.js';
+import { splitThinking } from '../helpers/thinking.js';
+import { clipRawCall, normalizeToolArgs, recoverMarkupToolCalls, recoverPrintedSkillLoad, recoverSkillNamedCall, stripToolCallMarkup, stripToolResponseBlocks, toolCallMarkup } from '../helpers/tool-call-markup.js';
+import { INTENT_PARAM, INTENT_PARAM_DESCRIPTION, takeToolIntent } from '../helpers/tool-intent.js';
+import { HookPipeline } from '../hooks/pipeline.js';
+import { fallbackToolLabel } from '../helpers/tool-label.js';
+import { hlog } from '../log.js';
+import { resolveLlmGenerationParams } from '../models/llm-presets.js';
+import { customToolDialect } from '../models/model-catalog.js';
+import { isContextOverflowError, isSdkModelWedgedError } from '../models/sdk-faults.js';
+import { annotateLastUserTime, skillsPromptSection, systemPromptParts } from '../prompt.js';
+import { isMetadataMethod } from '../tools/mcp/utils.js';
+import { unquoteArg } from '../tools/model-args.js';
+import { SKILL_TOOL_NAME, WEB_SEARCH_TOOL_NAME } from './tool-names.js';
+import { promptUsageParts, usageBreakdown } from './usage-breakdown.js';
+import { collectToolGrants, enabledTools, isSelected, skillIsActive, skillsAreSelected } from './tool-selection.js';
+import { guardToolCall } from '../tools/outbound-guard.js';
+import { isAvailableState } from '../tools/skills/skill-state-constants.js';
+import { resolveImplicitSkill, resolveSkillMention, skillPreloadMessage } from '../tools/skills/mention.js';
+import { permittedTools } from '../tools/toolsets.js';
+import { promptPrefixHash } from './prompt-prefix.js';
+import { logToolPrompt } from './tool-prompt-log.js';
+import { DIRECT_CALL_ID, loadedSkillFilesFrom, loadedSkillsFrom, TOOL_CONTINUATION_NUDGE, toolResultTurn, withoutSkillLoadTurns } from './tool-turns.js';
+import { projectVisionHistory, visionHistoryCacheKey } from './vision-history.js';
 export function imageSettingsFrom(agent) {
     if (!agent)
         return undefined;

package/dist-lib/lib/capabilities/download.js

@@ -1,6 +1,6 @@
 import { Readable } from 'streamx';
-import { errorMessage } from "../error-fields.js";
-import { resolveModelSrc } from "../models/model-source.js";
+import { errorMessage } from '../error-fields.js';
+import { resolveModelSrc } from '../models/model-source.js';
 const noop = () => { };
 export function download(sdkOrLoader, args, onSettled) {
     const { model, addon = 'llm', seed, signal, projection, companions = [], assetSizes } = args;

package/dist-lib/lib/capabilities/speech-text.js

@@ -1,5 +1,5 @@
 import { ascii } from 'asenion';
-import { CURRENCY_CODES, SPEECH_LEXICON } from "./speech-lexicon.js";
+import { CURRENCY_CODES, SPEECH_LEXICON } from './speech-lexicon.js';
 const EMOJI_MODIFIERS = /[\uFE0E\uFE0F\u200D\u{1F3FB}-\u{1F3FF}]/gu;
 const UNSPEAKABLE = /[^\nA-Za-z0-9 .,;:!?'"()\u002D_]/gu;
 export function normalizeForSpeech(text, lang = 'en') {

package/dist-lib/lib/capabilities/tool-prompt-log.js

@@ -1,4 +1,4 @@
-import { harnessLogEnabled, hlog } from "../log.js";
+import { harnessLogEnabled, hlog } from '../log.js';
 export function logToolPrompt({ promptPrefix, modelId, cacheKey, agentId, messageCount, responseFormat, tools = [], definitions, activeSkills, skillsSelected, enabledSkills, mentionedSkill, loadedSkills, toolOps }) {
     if (!harnessLogEnabled())
         return;

package/dist-lib/lib/capabilities/tool-selection.js

@@ -1,5 +1,5 @@
-import { parseToolGrant } from "../tools/skills/tool-grants.js";
-import { SKILL_TOOL_NAME, WEB_SEARCH_TOOL_NAME } from "./tool-names.js";
+import { parseToolGrant } from '../tools/skills/tool-grants.js';
+import { SKILL_TOOL_NAME, WEB_SEARCH_TOOL_NAME } from './tool-names.js';
 export function collectToolGrants(skills) {
     const grants = {
         grantedNames: new Set(),

package/dist-lib/lib/capabilities/tool-turns.js

@@ -1,4 +1,4 @@
-import { SKILL_TOOL_NAME } from "./tool-names.js";
+import { SKILL_TOOL_NAME } from './tool-names.js';
 export const DIRECT_CALL_ID = 'call-direct';
 export const TOOL_CONTINUATION_NUDGE = "[Tool results above. Continue the user's request: call the next tool, or answer.]";
 export function toolResultTurn(name, id, output) {

package/dist-lib/lib/capabilities/usage-breakdown.js

@@ -1,4 +1,4 @@
-import { detectToolDialect } from "../models/tool-dialect.js";
+import { detectToolDialect } from '../models/tool-dialect.js';
 const QWEN35 = { prose: 4.38, schema: 4.08, toolBlockTokens: 189 };
 const DENSITY_BY_DIALECT = new Map([['qwen35', QWEN35]]);
 export function densityFor(modelName) {

package/dist-lib/lib/capabilities/voice.js

@@ -1,7 +1,7 @@
 import b4a from 'b4a';
-import { AbortedError } from "../helpers/race-abort.js";
-import { hlog } from "../log.js";
-import { normalizeForSpeech } from "./speech-text.js";
+import { AbortedError } from '../helpers/race-abort.js';
+import { hlog } from '../log.js';
+import { normalizeForSpeech } from './speech-text.js';
 export const SUPERTONIC_SAMPLE_RATE = 44100;
 export function createVoiceLane() {
     let tail = Promise.resolve();

package/dist-lib/lib/connect.js

@@ -1,18 +1,18 @@
 import EventEmitter from 'events';
 import fs from 'fs';
-import { settleOnClose } from "./rpc-session.js";
+import { settleOnClose } from './rpc-session.js';
 import { harnessClient } from '../spec/calls.js';
 import HRPC from '../spec/hrpc/index.js';
-import { unsupportedKvCacheDeletion } from "./capabilities/kv-cache.js";
-import { hlog } from "./log.js";
-import { assertEmbedDevice } from "./models/embed-config.js";
-import { errorCode, errorMessage } from "./error-fields.js";
-import { pushQueue } from "./queue.js";
-import { stageFile, sweepStaging } from "./staging.js";
-import { readInstall, readSetup } from "./tools/skills/manifest-parse.js";
-import { SKILL_STATE } from "./tools/skills/skill-state.js";
-import { asToolset } from "./tools/toolsets.js";
-import { fromDownloadWire, fromWire, unpackVectors } from "./wire.js";
+import { unsupportedKvCacheDeletion } from './capabilities/kv-cache.js';
+import { hlog } from './log.js';
+import { assertEmbedDevice } from './models/embed-config.js';
+import { errorCode, errorMessage } from './error-fields.js';
+import { pushQueue } from './queue.js';
+import { stageFile, sweepStaging } from './staging.js';
+import { readInstall, readSetup } from './tools/skills/manifest-parse.js';
+import { SKILL_STATE } from './tools/skills/skill-state.js';
+import { asToolset } from './tools/toolsets.js';
+import { fromDownloadWire, fromWire, unpackVectors } from './wire.js';
 export const HARNESS_DIED = 'HARNESS_DIED';
 export function connectHarness(transport) {
     return new RemoteHarness(transport);

package/dist-lib/lib/context-window.js

@@ -1,4 +1,4 @@
-import { TOOL_CONTINUATION_NUDGE } from "./capabilities/tool-turns.js";
+import { TOOL_CONTINUATION_NUDGE } from './capabilities/tool-turns.js';
 export const TOOL_RESULT_TRUNCATION_MARKER = '\n[tool result truncated for context]\n';
 function isTurnBoundary(message) {
     return message.role === 'user' && message.content !== TOOL_CONTINUATION_NUDGE;

package/dist-lib/lib/docx/index.d.ts

@@ -0,0 +1,5 @@
+import type { AbortSignal } from 'bare-abort-controller';
+export { closePythonWorker as closeDocxWorker } from '../tools/exec/adapters/python/worker/client.ts';
+export declare function extractDocxText(bytes: Uint8Array, fileName: string, options?: {
+    readonly signal?: AbortSignal;
+}): Promise<string>;

package/dist-lib/lib/docx/index.js

@@ -0,0 +1,49 @@
+import b4a from 'b4a';
+import fs from 'fs';
+import { runPython } from '../tools/exec/adapters/python/pyodide.js';
+import { planVendoredInstall, vendoredManifest, wheelsDir } from '../tools/exec/adapters/python/wheels.js';
+export { closePythonWorker as closeDocxWorker } from '../tools/exec/adapters/python/worker/client.js';
+const MAX_OFFICE_BYTES = 20 * 1024 * 1024;
+const PACKAGES = ['python-docx==1.2.0'];
+const EXTRACT = `from docx import Document
+from docx.text.paragraph import Paragraph
+from pathlib import Path
+
+def text(container):
+    for block in container.iter_inner_content():
+        if isinstance(block, Paragraph):
+            if block.text.strip():
+                yield block.text
+        else:
+            for row in block.rows:
+                yield " | ".join(" ".join(text(cell)) for cell in row.cells)
+
+Path("extracted.txt").write_text("\\n".join(text(Document("input.docx"))), encoding="utf-8")
+`;
+export async function extractDocxText(bytes, fileName, options = {}) {
+    if (bytes.byteLength > MAX_OFFICE_BYTES) {
+        throw new Error(`document is too large to extract: ${bytes.byteLength} bytes, limit ${MAX_OFFICE_BYTES}`);
+    }
+    const dir = wheelsDir();
+    const manifest = vendoredManifest(dir);
+    const install = planVendoredInstall(PACKAGES, { dir, manifest });
+    if (!dir ||
+        !manifest ||
+        !install ||
+        !['micropip', ...install.packages].every((name) => Object.keys(manifest.files).some((file) => file.replaceAll('_', '-').startsWith(`${name}-`) && fs.existsSync(`${dir}/${file}`)))) {
+        throw new Error('bundled DOCX extraction packages are unavailable');
+    }
+    const result = await runPython(EXTRACT, {
+        packages: PACKAGES,
+        inputs: [{ path: 'input.docx', bytes }],
+        outputs: ['extracted.txt'],
+        signal: options.signal
+    });
+    if (result.exitCode !== 0)
+        throw new Error(`${fileName}: ${result.stderr.trim()}`);
+    const output = result.files?.get('extracted.txt');
+    if (!output) {
+        throw new Error(result.rejected?.[0]?.reason ?? 'DOCX extraction produced no text file');
+    }
+    return b4a.toString(output, 'utf8');
+}

package/dist-lib/lib/hardware/capability-probe.js

@@ -1,7 +1,7 @@
 import process from 'process';
-import { capabilityProfileToModelName } from "../models/model-catalog.js";
-import { probeWithAddon } from "./gpu-probe-addon.js";
-import { mobileBudget, parseNvidiaSmiOutput, parseRocmSmiOutput, parseWindowsRegistryOutput, sharedRamBudget } from "./parsers.js";
+import { capabilityProfileToModelName } from '../models/model-catalog.js';
+import { probeWithAddon } from './gpu-probe-addon.js';
+import { mobileBudget, parseNvidiaSmiOutput, parseRocmSmiOutput, parseWindowsRegistryOutput, sharedRamBudget } from './parsers.js';
 const GIB = 1024 * 1024 * 1024;
 const WINDOWS_REGISTRY_QUERY = "(Get-ItemProperty 'HKLM:\\SYSTEM\\ControlSet001\\Control\\Class\\{4d36e968-e325-11ce-bfc1-08002be10318}\\0*' -Name 'HardwareInformation.qwMemorySize' -ErrorAction SilentlyContinue).'HardwareInformation.qwMemorySize' | Sort-Object -Descending | Select-Object -First 1";
 const SYSFS_VRAM_PATHS = [

package/dist-lib/lib/hardware/gpu-probe-addon.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { classifyGpu } from "./gpu-classify.js";
-import { IGPU_LIE_THRESHOLD, sharedRamBudget } from "./parsers.js";
+import { classifyGpu } from './gpu-classify.js';
+import { IGPU_LIE_THRESHOLD, sharedRamBudget } from './parsers.js';
 const GpuDeviceSchema = z.object({
     name: z.string(),
     videoMemoryBytes: z.number()

package/dist-lib/lib/hardware/gpu-probe-entry.js

@@ -1,2 +1,2 @@
-import { runGpuProbeIfRequested } from "./gpu-probe.js";
+import { runGpuProbeIfRequested } from './gpu-probe.js';
 runGpuProbeIfRequested();

package/dist-lib/lib/helpers/markup-stream-filter.js

@@ -1,6 +1,6 @@
 import { firstMarker } from 'asenion/guards';
 import { holdback } from 'asenion/scan';
-import { createJoinGuard } from "./join-guard.js";
+import { createJoinGuard } from './join-guard.js';
 const MARKUP_OPENERS = ['<tool_call>', '<function=', '<tool_response>'];
 const MARKUP_CLOSERS = {
     '<tool_call>': '</tool_call>',

package/dist-lib/lib/helpers/run-outcome.js

@@ -1,4 +1,4 @@
-import { TOOL_CONTINUATION_NUDGE } from "../capabilities/tool-turns.js";
+import { TOOL_CONTINUATION_NUDGE } from '../capabilities/tool-turns.js';
 export const DEGENERATE_ANSWER_FALLBACK = "I couldn't complete that step and don't have a useful result to share.";
 export const ROUND_CAP_ANSWER = "I ran out of steps before I could finish that. Ask me to continue and I'll pick up where I left off.";
 export const SEARCH_CAPPED_ANSWER = "I searched the web but couldn't find the answer in the results I got.";

package/dist-lib/lib/helpers/spawn-path.d.ts

@@ -1,5 +1,5 @@
 export declare const HOMEBREW_BIN_DIRS: readonly string[];
 export declare function withHomebrewPath(path: string | undefined, platformName: string): string | undefined;
-export declare const EXEC_ENV_ALLOWLIST: readonly ["PATH", "HOME", "TMPDIR", "TMP", "TEMP", "LANG", "LC_ALL", "LC_CTYPE", "TZ", "USER", "LOGNAME", "HTTP_PROXY", "http_proxy", "HTTPS_PROXY", "https_proxy", "ALL_PROXY", "all_proxy", "NO_PROXY", "no_proxy", "SSL_CERT_FILE", "SSL_CERT_DIR", "CURL_CA_BUNDLE", "REQUESTS_CA_BUNDLE", "NODE_EXTRA_CA_CERTS"];
+export declare const EXEC_ENV_ALLOWLIST: readonly ['PATH', 'HOME', 'TMPDIR', 'TMP', 'TEMP', 'LANG', 'LC_ALL', 'LC_CTYPE', 'TZ', 'USER', 'LOGNAME', 'HTTP_PROXY', 'http_proxy', 'HTTPS_PROXY', 'https_proxy', 'ALL_PROXY', 'all_proxy', 'NO_PROXY', 'no_proxy', 'SSL_CERT_FILE', 'SSL_CERT_DIR', 'CURL_CA_BUNDLE', 'REQUESTS_CA_BUNDLE', 'NODE_EXTRA_CA_CERTS'];
 export declare function execEnv(env: Readonly<Record<string, string | undefined>>, platformName: string): Record<string, string>;
 export declare function spawnEnv(env: Readonly<Record<string, string | undefined>>, platformName: string, overrides?: Readonly<Record<string, string>>): Record<string, string>;

package/dist-lib/lib/helpers/thinking.js

@@ -1,7 +1,7 @@
 import { firstMarker } from 'asenion/guards';
 import { holdback } from 'asenion/scan';
-import { STOP_MARKERS } from "./control-tokens.js";
-import { createJoinGuard } from "./join-guard.js";
+import { STOP_MARKERS } from './control-tokens.js';
+import { createJoinGuard } from './join-guard.js';
 const OPEN_TAGS = ['<think>', '<thinking>'];
 const CLOSE_TAGS = ['</think>', '</thinking>'];
 const ALL_TAGS = [...OPEN_TAGS, ...CLOSE_TAGS];

package/dist-lib/lib/helpers/tool-intent.js

@@ -1,4 +1,4 @@
-import { stripControlTokens } from "./control-tokens.js";
+import { stripControlTokens } from './control-tokens.js';
 export const INTENT_PARAM = 'intent';
 export const INTENT_PARAM_DESCRIPTION = 'One short sentence, addressed to the user, saying plainly what this call will ' +
     'do for them — the outcome, never the code. It is the only thing the approval ' +

package/dist-lib/lib/helpers/tool-label.js

@@ -1,7 +1,7 @@
 import { unwrap } from 'asenion';
-import { SKILL_TOOL_NAME } from "../capabilities/tool-names.js";
-import { unquoteArg } from "../tools/model-args.js";
-import { stripControlTokens } from "./control-tokens.js";
+import { SKILL_TOOL_NAME } from '../capabilities/tool-names.js';
+import { unquoteArg } from '../tools/model-args.js';
+import { stripControlTokens } from './control-tokens.js';
 const MAX_LABEL_WORDS = 6;
 const MAX_LABEL_LENGTH = 60;
 const MAX_DESCRIPTION_LENGTH = 200;

package/dist-lib/lib/hooks/built-in/arg-repair.d.ts

@@ -1,5 +1,5 @@
 import type { HarnessHook, HookContext, HookResult } from '../types.ts';
 export declare class ArgRepairHook implements HarnessHook {
-    readonly phase: "preToolCall";
+    readonly phase: 'preToolCall';
     run(ctx: HookContext): HookResult;
 }

package/dist-lib/lib/hooks/built-in/arg-repair.js

@@ -1,5 +1,5 @@
 import { jsonrepair } from 'jsonrepair';
-import { hlog } from "../../log.js";
+import { hlog } from '../../log.js';
 const STRUCTURED_TYPES = new Set(['object', 'array']);
 export class ArgRepairHook {
     phase = 'preToolCall';

package/dist-lib/lib/hooks/built-in/egress.d.ts

@@ -1,5 +1,5 @@
 import type { HarnessHook, HookContext, HookResult } from '../types.ts';
 export declare class EgressGuardHook implements HarnessHook {
-    readonly phase: "preToolCall";
+    readonly phase: 'preToolCall';
     run(ctx: HookContext): HookResult;
 }

package/dist-lib/lib/hooks/built-in/egress.js

@@ -1,5 +1,5 @@
-import { mcpTargetUrl } from "../../tools/mcp-call.js";
-import { checkOutboundHost } from "../../tools/url-guard.js";
+import { mcpTargetUrl } from '../../tools/mcp-call.js';
+import { checkOutboundHost } from '../../tools/url-guard.js';
 export class EgressGuardHook {
     phase = 'preToolCall';
     run(ctx) {

package/dist-lib/lib/hooks/built-in/index.js

@@ -1,3 +1,3 @@
-export { ArgRepairHook } from "./arg-repair.js";
-export { EgressGuardHook } from "./egress.js";
-export { SkillCatalogGuardHook } from "./skill-catalog.js";
+export { ArgRepairHook } from './arg-repair.js';
+export { EgressGuardHook } from './egress.js';
+export { SkillCatalogGuardHook } from './skill-catalog.js';

package/dist-lib/lib/hooks/built-in/skill-catalog.d.ts

@@ -2,7 +2,7 @@ import type { SkillCatalogEntry } from '../../tools/skills/catalog.ts';
 import type { HarnessHook, HookContext, HookResult } from '../types.ts';
 type SkillCatalogInput = readonly SkillCatalogEntry[] | (() => readonly SkillCatalogEntry[] | readonly string[]);
 export declare class SkillCatalogGuardHook implements HarnessHook {
-    readonly phase: "preToolCall";
+    readonly phase: 'preToolCall';
     private readonly _catalog;
     constructor(catalog?: SkillCatalogInput);
     run(ctx: HookContext): HookResult;

package/dist-lib/lib/hooks/pipeline.js

@@ -1,7 +1,7 @@
-import { hlog } from "../log.js";
-import { normalizeToolExecutionOutcome } from "../helpers/run-outcome.js";
-import { harnessHooks } from "./registry.js";
-import { runHooks } from "./run.js";
+import { hlog } from '../log.js';
+import { normalizeToolExecutionOutcome } from '../helpers/run-outcome.js';
+import { harnessHooks } from './registry.js';
+import { runHooks } from './run.js';
 export class HookPipeline {
     _behaviorHooks;
     constructor(hooks = harnessHooks) {

package/dist-lib/lib/hooks/registry.js

@@ -1,4 +1,4 @@
-import { ArgRepairHook, EgressGuardHook, SkillCatalogGuardHook } from "./built-in/index.js";
+import { ArgRepairHook, EgressGuardHook, SkillCatalogGuardHook } from './built-in/index.js';
 export const harnessHooks = [
     new ArgRepairHook(),
     new EgressGuardHook(),

package/dist-lib/lib/hooks/run.js

@@ -1,4 +1,4 @@
-import { hlog } from "../log.js";
+import { hlog } from '../log.js';
 function cloneJson(value) {
     try {
         const text = JSON.stringify(value);

package/dist-lib/lib/models/model-catalog.js

@@ -1,7 +1,7 @@
 import { AUDIOGEN_ACESTEP_5HZ_LM_0_6B_Q8_0, AUDIOGEN_ACESTEP_V15_SFT_Q8_0, AUDIOGEN_ACESTEP_V15_TURBO_Q4_K_M, AUDIOGEN_ACESTEP_V15_TURBO_Q8_0, AUDIOGEN_QWEN3_EMBEDDING_0_6B_Q8_0, AUDIOGEN_VAE_BF16, EMBEDDINGGEMMA_300M_Q4_0, FLUX_2_KLEIN_4B_Q4_0, FLUX_2_KLEIN_4B_VAE, HEALTHCARE_1_7B_MEDICAL_Q4_K_M, HEALTHCARE_4B_MEDICAL_Q4_K_M, MMPROJ_QWEN3_5_2B_MULTIMODAL_Q8_0, MMPROJ_QWEN3_5_4B_MULTIMODAL_Q8_0, MMPROJ_QWEN3_5_9B_MULTIMODAL_F16, MMPROJ_QWEN3_6_27B_MULTIMODAL_F16, MMPROJ_QWEN3_6_35B_A3B_MULTIMODAL_F16, MMPROJ_QWEN3_8_27B_MULTIMODAL_F16, QWEN3_5_2B_MULTIMODAL_Q4_K_M, QWEN3_5_4B_MULTIMODAL_Q4_K_M, QWEN3_5_9B_MULTIMODAL_Q4_K_M, PARAKEET_TDT_0_6B_V3_Q8_0, QWEN3_4B_Q4_K_M, QWEN3_6_27B_MULTIMODAL_Q4_K_XL, QWEN3_6_35B_A3B_MULTIMODAL_Q4_K_M, QWEN3_8_27B_MULTIMODAL_UD_Q4_K_XL, SD_V2_1_1B_Q8_0, SDXL_BASE_1_0_3B_Q4_0, TTS_MULTILINGUAL_SUPERTONIC3_Q4_0, TTS_MULTILINGUAL_SUPERTONIC3_Q8_0 } from '@qvac/sdk/models';
-import { detectToolDialect } from "./tool-dialect.js";
-import { defaultTtsModelName } from "./tts-model-default.js";
-import { CAPABILITY_PROFILE_ORDER, QWEN_35_2B, QWEN_35_4B, QWEN_35_9B, QWEN_36_27B, QWEN_36_35B_A3B, QWEN_38_27B, MEDPSY_1_7B, MEDPSY_4B, isCapabilityProfile, meetsMinCapabilityProfile, modelNameToCapabilityProfile, capabilityProfileToModelName, isMultimodalLlm, AGENT_MODEL_NAMES, modelDisplayName, capabilityProfileModelLabel, DEFAULT_IMAGE_MODEL_CHOICE, IMAGE_CHOICE_CATALOG } from "./model-catalog-constants.js";
+import { detectToolDialect } from './tool-dialect.js';
+import { defaultTtsModelName } from './tts-model-default.js';
+import { CAPABILITY_PROFILE_ORDER, QWEN_35_2B, QWEN_35_4B, QWEN_35_9B, QWEN_36_27B, QWEN_36_35B_A3B, QWEN_38_27B, MEDPSY_1_7B, MEDPSY_4B, isCapabilityProfile, meetsMinCapabilityProfile, modelNameToCapabilityProfile, capabilityProfileToModelName, isMultimodalLlm, AGENT_MODEL_NAMES, modelDisplayName, capabilityProfileModelLabel, DEFAULT_IMAGE_MODEL_CHOICE, IMAGE_CHOICE_CATALOG } from './model-catalog-constants.js';
 export { CAPABILITY_PROFILE_ORDER, QWEN_35_2B, QWEN_35_4B, QWEN_35_9B, QWEN_36_27B, QWEN_36_35B_A3B, QWEN_38_27B, MEDPSY_1_7B, MEDPSY_4B, isCapabilityProfile, meetsMinCapabilityProfile, modelNameToCapabilityProfile, capabilityProfileToModelName, isMultimodalLlm, AGENT_MODEL_NAMES, modelDisplayName, capabilityProfileModelLabel, DEFAULT_IMAGE_MODEL_CHOICE, IMAGE_CHOICE_CATALOG };
 export const LLM_CATALOG = [
     {
@@ -153,7 +153,7 @@ export function diffusionDownloadMetadata(model, addon) {
         assetSizes
     };
 }
-import { DEFAULT_MUSIC_MODEL_CHOICE } from "./music-catalog.js";
+import { DEFAULT_MUSIC_MODEL_CHOICE } from './music-catalog.js';
 export { DEFAULT_MUSIC_MODEL_CHOICE };
 const MUSIC_GENERATION_SKILL = 'music-generation';
 export const AUDIOGEN_CATALOG = [

package/dist-lib/lib/models/model-delete.js

@@ -1,5 +1,5 @@
 import fs from 'fs';
-import { curatedListables, musicListables } from "./model-catalog.js";
+import { curatedListables, musicListables } from './model-catalog.js';
 export function summarizeDelete(result) {
     return { name: result.name, removed: result.removed.length, freedBytes: result.freedBytes };
 }

package/dist-lib/lib/models/model-handle.js

@@ -1,4 +1,4 @@
-import { retryMemo } from "../helpers/retry-memo.js";
+import { retryMemo } from '../helpers/retry-memo.js';
 export class ModelHandle {
     _load;
     _peek;

package/dist-lib/lib/models/model-list.js

@@ -1,4 +1,4 @@
-import { companionRegistryPaths, curatedListables, musicListables } from "./model-catalog.js";
+import { companionRegistryPaths, curatedListables, musicListables } from './model-catalog.js';
 export const MODEL_STATUS_TTL_MS = 30_000;
 export function createModelStatusCache() {
     return { entries: new Map(), epoch: 0 };