@qvac/harness 0.3.3 → 0.5.0

package/dist-lib/spec/hyperschema/schema.json

@@ -1,5 +1,5 @@
 {
-  "version": 13,
+  "version": 15,
   "schema": [
     {
       "name": "empty",
@@ -1336,6 +1336,11 @@
           "name": "actualSize",
           "type": "uint",
           "version": 1
+        },
+        {
+          "name": "label",
+          "type": "string",
+          "version": 15
         }
       ]
     },
@@ -2129,6 +2134,26 @@
           "name": "projectionSrc",
           "type": "string",
           "version": 5
+        },
+        {
+          "name": "taskType",
+          "type": "string",
+          "version": 14
+        },
+        {
+          "name": "expectedSize",
+          "type": "uint",
+          "version": 14
+        },
+        {
+          "name": "label",
+          "type": "string",
+          "version": 15
+        },
+        {
+          "name": "contextLength",
+          "type": "uint",
+          "version": 15
         }
       ]
     },
@@ -2553,6 +2578,145 @@
           "version": 13
         }
       ]
+    },
+    {
+      "name": "preview-model-source-request",
+      "namespace": "harness",
+      "compact": false,
+      "flagsPosition": 1,
+      "fields": [
+        {
+          "name": "src",
+          "required": true,
+          "type": "string",
+          "version": 14
+        },
+        {
+          "name": "mmprojSrc",
+          "type": "string",
+          "version": 14
+        }
+      ]
+    },
+    {
+      "name": "model-source-file",
+      "namespace": "harness",
+      "compact": false,
+      "flagsPosition": 2,
+      "fields": [
+        {
+          "name": "src",
+          "required": true,
+          "type": "string",
+          "version": 14
+        },
+        {
+          "name": "label",
+          "required": true,
+          "type": "string",
+          "version": 14
+        },
+        {
+          "name": "sizeBytes",
+          "type": "uint",
+          "version": 14
+        }
+      ]
+    },
+    {
+      "name": "preview-model-source-response",
+      "namespace": "harness",
+      "compact": false,
+      "flagsPosition": 0,
+      "fields": [
+        {
+          "name": "ok",
+          "required": false,
+          "type": "bool",
+          "version": 14
+        },
+        {
+          "name": "refusal",
+          "type": "string",
+          "version": 14
+        },
+        {
+          "name": "reason",
+          "type": "string",
+          "version": 14
+        },
+        {
+          "name": "src",
+          "type": "string",
+          "version": 14
+        },
+        {
+          "name": "files",
+          "array": true,
+          "type": "@harness/model-source-file",
+          "version": 14
+        },
+        {
+          "name": "sizeBytes",
+          "type": "uint",
+          "version": 14
+        },
+        {
+          "name": "contextLength",
+          "type": "uint",
+          "version": 14
+        },
+        {
+          "name": "architecture",
+          "type": "string",
+          "version": 14
+        },
+        {
+          "name": "sizeLabel",
+          "type": "string",
+          "version": 14
+        },
+        {
+          "name": "taskType",
+          "type": "string",
+          "version": 14
+        },
+        {
+          "name": "license",
+          "type": "string",
+          "version": 14
+        },
+        {
+          "name": "fit",
+          "type": "string",
+          "version": 14
+        },
+        {
+          "name": "fitReasons",
+          "array": true,
+          "type": "string",
+          "version": 14
+        },
+        {
+          "name": "mmprojSrc",
+          "type": "string",
+          "version": 14
+        }
+      ]
+    },
+    {
+      "name": "set-model-idle-timeout-request",
+      "namespace": "harness",
+      "compact": false,
+      "flagsPosition": -1,
+      "fields": [
+        {
+          "name": "ms",
+          "required": true,
+          "type": "uint",
+          "version": 15
+        }
+      ]
     }
   ]
 }

package/dist-lib/spec/hyperschema/types.d.ts

@@ -1,5 +1,5 @@
 // This file is autogenerated by hyperschema-ts
-// Schema version: 13
+// Schema version: 15
 // Do not edit manually.
 
 export interface HarnessEmpty {
@@ -256,6 +256,7 @@ export interface HarnessModelInfo {
   supportsImages?: boolean
   expectedSize: number
   actualSize?: number
+  label?: string | null
 }
 
 export interface HarnessListModelsRequest {
@@ -425,6 +426,10 @@ export interface HarnessCustomModel {
   name: string
   src: string
   projectionSrc?: string | null
+  taskType?: string | null
+  expectedSize?: number
+  label?: string | null
+  contextLength?: number
 }
 
 export interface HarnessSetCustomModelsRequest {
@@ -531,6 +536,38 @@ export interface HarnessSkillOauthVerify {
   reject?: HarnessSkillOauthVerifyRule[] | null
 }
 
+export interface HarnessPreviewModelSourceRequest {
+  src: string
+  mmprojSrc?: string | null
+}
+
+export interface HarnessModelSourceFile {
+  src: string
+  label: string
+  sizeBytes?: number
+}
+
+export interface HarnessPreviewModelSourceResponse {
+  ok?: boolean
+  refusal?: string | null
+  reason?: string | null
+  src?: string | null
+  files?: HarnessModelSourceFile[] | null
+  sizeBytes?: number
+  contextLength?: number
+  architecture?: string | null
+  sizeLabel?: string | null
+  taskType?: string | null
+  license?: string | null
+  fit?: string | null
+  fitReasons?: string[] | null
+  mmprojSrc?: string | null
+}
+
+export interface HarnessSetModelIdleTimeoutRequest {
+  ms: number
+}
+
 export interface SchemaTypes {
   "@harness/empty": HarnessEmpty
   "@harness/ok-response": HarnessOkResponse
@@ -617,4 +654,8 @@ export interface SchemaTypes {
   "@harness/skill-oauth-config": HarnessSkillOauthConfig
   "@harness/skill-oauth-verify-rule": HarnessSkillOauthVerifyRule
   "@harness/skill-oauth-verify": HarnessSkillOauthVerify
+  "@harness/preview-model-source-request": HarnessPreviewModelSourceRequest
+  "@harness/model-source-file": HarnessModelSourceFile
+  "@harness/preview-model-source-response": HarnessPreviewModelSourceResponse
+  "@harness/set-model-idle-timeout-request": HarnessSetModelIdleTimeoutRequest
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qvac/harness",
-  "version": "0.3.3",
+  "version": "0.5.0",
   "type": "module",
   "description": "An AI harness implementing generate(context) via @qvac/sdk. Knows nothing about workbench, hyperdb, or chunks — just inference in, events out.",
   "exports": {
@@ -420,17 +420,17 @@
       "types": "./dist-lib/lib/tools/http-request/encode-fields.d.ts",
       "default": "./dist-lib/lib/tools/http-request/encode-fields.js"
     },
+    "./lib/tools/http-request/request.ts": {
+      "types": "./dist-lib/lib/tools/http-request/request.d.ts",
+      "default": "./dist-lib/lib/tools/http-request/request.js"
+    },
     "./lib/tools/http-request/truncate-response.ts": {
       "types": "./dist-lib/lib/tools/http-request/truncate-response.d.ts",
       "default": "./dist-lib/lib/tools/http-request/truncate-response.js"
     },
-    "./lib/tools/http-request/utils.ts": {
-      "types": "./dist-lib/lib/tools/http-request/utils.d.ts",
-      "default": "./dist-lib/lib/tools/http-request/utils.js"
-    },
-    "./lib/tools/mcp/utils.ts": {
-      "types": "./dist-lib/lib/tools/mcp/utils.d.ts",
-      "default": "./dist-lib/lib/tools/mcp/utils.js"
+    "./lib/tools/mcp/protocol.ts": {
+      "types": "./dist-lib/lib/tools/mcp/protocol.d.ts",
+      "default": "./dist-lib/lib/tools/mcp/protocol.js"
     },
     "./lib/tools/model-args.ts": {
       "types": "./dist-lib/lib/tools/model-args.d.ts",
@@ -600,7 +600,7 @@
   "scripts": {
     "build:schema": "bare schema/build.ts",
     "test": "npm run vendor:wheels && npm run test:bare && npm run test:addons",
-    "test:bare": "QVAC_NO_SKILL_BIN_PROBE=1 prettytap -- brittle-bare test/all.ts",
+    "test:bare": "QVAC_NO_SKILL_BIN_PROBE=1 brittle-jobs 'test/{,!(helpers)/}*.ts'",
     "format": "prettier . --write",
     "lint": "prettier . --check && lunte && tsc --noEmit",
     "build:bundle": "node scripts/build-bundle.mjs",
@@ -699,7 +699,7 @@
     "@qvac/sdk": "0.20.0",
     "@qvac/skills": "0.1.9",
     "asenion": "^0.1.0",
-    "b4a": "^1.8.1",
+    "b4a": "^1.9.0",
     "bare-abort-controller": "^1.1.2",
     "bare-buffer": "^3.6.1",
     "bare-channel": "^5.2.4",
@@ -747,21 +747,21 @@
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@types/b4a": "^1.6.5",
     "bare-bundle": "^1.10.0",
     "bare-module-lexer": "^1.6.3",
     "bare-runtime": "^1.30.0",
     "bare-semver": "^1.1.0",
     "brittle": "^4.0.2",
+    "brittle-jobs": "^0.2.1",
     "corestore": "^7.11.0",
     "holepunch-types": "^0.2.1",
     "hyperdrive": "^13.3.3",
     "jsdom": "~30.0.1",
-    "lunte": "^1.8.3",
+    "lunte": "^1.8.4",
+    "lunte-plugin-qvac": "^0.1.0",
     "mermaid": "~11.16.1",
     "prettier": "^3.6.2",
     "prettier-config-holepunch": "^2.0.0",
-    "prettytap": "^0.2.0",
     "terser": "^5.51.2",
     "typescript": "^7.0.2"
   },
@@ -771,7 +771,6 @@
     "localwatch@1.4.3": "patches/localwatch@1.4.3.patch",
     "hypercore-blob-server@1.15.0": "patches/hypercore-blob-server@1.15.0.patch",
     "bare-stow@0.1.5": "patches/bare-stow@0.1.5.patch",
-    "brittle@4.1.0": "patches/brittle@4.1.0.patch",
     "@qvac/inference@0.20.0": "patches/@qvac%2Finference@0.20.0.patch"
   },
   "repository": {

package/worker/harness-sidecar.mjs

@@ -1,10 +1,4 @@
-// bare-stow entry: serves the Harness over the ipc duplex bare-stow wires.
-// argv (empty = absent): [2] skillsDir, [3] SDK storage JSON (required: the fs deny list fences it), [4] embedding config JSON,
-// [5] imageModel JSON, [6] imageClamps JSON,
-// [7] '1' to enable harness logging (written to `harness.log`, beside assistant.log),
-// [8] llm config JSON (llmDevice/llmGpuLayers/contextSize/kvCacheK/kvCacheV/completionModelCap),
-// [9] musicModel JSON, [10] musicClamps JSON, [11] vendored python wheels dir,
-// [12] host-supplied GPU stats JSON.
+// bare-stow entry: argv slots are the ones spawnHarness forwards in lib/spawn.ts; empty is absent
 import '../dist-lib/lib/hardware/gpu-probe-entry.js'
 import FileLog from 'bare-file-logger'
 import fs from 'fs'
@@ -41,10 +35,7 @@ const SCOPE = '[harness]'
 // when the file will not open, everything still has somewhere to go that is not the pipe
 const DISCARD = { info() {}, debug() {}, warn() {}, error() {} }
 
-// On Windows the host does not read our stdout, and writing past the OS buffer takes the
-// Bare thread with it: the event loop stops, nothing raises, and a download never produces
-// a byte. Elsewhere the same write only queues in memory (measured), which is why it only
-// showed up there. Every line goes to a file instead, via the FileLog the assistant uses.
+// on Windows unread stdout past the OS buffer silently halts the Bare thread, so log to a file
 function openHarnessLog(path) {
   try {
     fs.mkdirSync(dirname(path), { recursive: true })
@@ -54,8 +45,7 @@ function openHarnessLog(path) {
   }
 }
 
-// Ungated by the host's log flag: the SDK and its addons log through `console`, and a
-// chatty dependency must not be able to wedge this process.
+// ungated by the log flag: the SDK and addons log via console, and chatter must not wedge us
 function captureConsole(log) {
   console.log = console.info = (...args) => log.info(SCOPE, ...args)
   console.debug = (...args) => log.debug(SCOPE, ...args)
@@ -73,17 +63,16 @@ async function alignSdkConsoleWithHost(hostWantsLogs) {
   }
 }
 
+// lunte-disable-next-line qvac/no-default-export -- the stow entry calls this module's default
 export default async function start(ipc, ready) {
   let harness
   let dying = false
-  // close() cancels in-flight SDK model loads (see Harness._close) so exit is not
-  // parked behind a multi-GB load; a wedged native call still ends at the host's
-  // kill deadline (bare-supervisor/stow reap)
+  // close() cancels in-flight SDK loads so exit is not parked; the host's kill deadline backstops
   const die = () => {
     if (dying) return
     dying = true
     Promise.resolve(harness?.close())
-      .catch(() => {})
+      .catch(noop)
       .then(() => Bare.exit(0))
   }
   Bare.IPC.on('end', die).on('close', die)
@@ -92,9 +81,7 @@ export default async function start(ipc, ready) {
   const deniedRoots = deniedRootsFor(sdkStorage.home)
   const hostWantsLogs = Bare.argv[7] === '1'
   setHarnessLog(hostWantsLogs)
-  // before the first await, so nothing logs ahead of the sink. The SDK home sits in
-  // the storage root, which is where the host writes assistant.log — harness.log
-  // belongs next to it.
+  // before the first await so nothing logs ahead of the sink; the host writes assistant.log beside it
   const log = openHarnessLog(join(dirname(sdkStorage.home), 'harness.log')) ?? DISCARD
   setHarnessLogSink((line) => log.info(SCOPE, line))
   captureConsole(log)
@@ -109,7 +96,9 @@ export default async function start(ipc, ready) {
   const musicClamps = Bare.argv[10] ? JSON.parse(Bare.argv[10]) : undefined
   const gpuStats = Bare.argv[12] ? JSON.parse(Bare.argv[12]) : undefined
   // Only the host knows where the shipped wheels landed.
-  if (Bare.argv[11]) process.env.QVAC_PYTHON_WHEELS_DIR = Bare.argv[11]
+  if (Bare.argv[11]) {
+    process.env.QVAC_PYTHON_WHEELS_DIR = Bare.argv[11]
+  }
 
   configureSdkStorage(sdkStorage)
   process.env.QVAC_PYODIDE_CACHE_DIR = `${sdkStorage.home}/pyodide-cache`
@@ -148,18 +137,21 @@ export default async function start(ipc, ready) {
   if (skillCatalog) {
     tools.push(...compileOperationTools(skillCatalog, { httpRequestTool, mcpCallTool }))
   }
+
   if (skillsDir) {
     tools.push(
       createSkillTool({
         skillsDir,
-        ...(credentialed ? { credentialStore: credentialed.credentialStore } : {})
+        credentialStore: credentialed?.credentialStore
       })
     )
   }
+
   harness = new Harness({
     gpuStats,
     tools,
     skillsDir,
+    modelsDir: sdkStorage.models,
     imageModel,
     imageClamps,
     musicModel,
@@ -179,3 +171,5 @@ export default async function start(ipc, ready) {
 
   return () => {}
 }
+
+function noop() {}

package/worker/stow-entry.mjs

@@ -1,6 +1,5 @@
 /* global Bare */
-// bare-stow's generated bundle shim (lib/shim.js) as a plain file, so the
-// sidecar can be spawned without stowing one.
+// bare-stow's generated shim (lib/shim.js) as a plain file, so the sidecar spawns unstowed
 import '../dist-lib/lib/hardware/gpu-probe-entry.js'
 import protocol from 'bare-stow/protocol'
 
@@ -22,12 +21,16 @@ async function shutdown(code, err = null) {
   exited = true
 
   try {
-    if (stop) await stop()
+    if (stop) {
+      await stop()
+    }
   } catch (e) {
     err = err || e
   }
 
-  if (err) ipc.send('error', { message: err.message, stack: err.stack })
+  if (err) {
+    ipc.send('error', { message: err.message, stack: err.stack })
+  }
 
   await ipc.send('exit', { code })
 

package/dist-lib/lib/tools/mcp/utils.d.ts

@@ -1,47 +0,0 @@
-import type { AbortSignal as BareAbortSignal } from 'bare-abort-controller';
-import type { ToolExecuteContext } from '../../capabilities/completion.ts';
-import { type FetchInit } from '../http-request/utils.ts';
-export declare const MCP_PROTOCOL_VERSION = "2025-03-26";
-export declare const TIMEOUT_MS = 30000;
-export type McpFetchFn = (url: URL, init: FetchInit) => Promise<{
-    status: number;
-    statusText?: string;
-    headers: {
-        get(name: string): string | null;
-    };
-    text(): Promise<string> | string;
-}>;
-export declare function isNotification(method: string): boolean;
-export declare function isMetadataMethod(method: unknown): boolean;
-export declare function normalizeMethod(method: string, params: Record<string, unknown> | undefined): {
-    method: string;
-    params: Record<string, unknown> | undefined;
-};
-export declare function flattenMcpResponse(body: string): {
-    error: string;
-} | {
-    body: string;
-};
-export declare function sessionKey(url: string, ctx: ToolExecuteContext | undefined, credentialKey?: string): string;
-export declare function getSession(key: string): string;
-export declare function deleteSession(key: string): void;
-export declare function cacheSession(key: string, sessionId: string): void;
-export declare function post(fetch: McpFetchFn, url: URL, method: string, params: Record<string, unknown> | undefined, authHeader: string | null, sessionId: string | undefined, signal: BareAbortSignal): Promise<{
-    status: number;
-    statusText?: string;
-    headers: {
-        get(name: string): string | null;
-    };
-    text(): Promise<string> | string;
-}>;
-export declare function readBody(response: {
-    text(): Promise<string> | string;
-    headers: {
-        get(name: string): string | null;
-    };
-}): Promise<string>;
-export declare function needsSession(status: number, cached: string): boolean;
-export declare function establishSession(fetch: McpFetchFn, url: URL, authHeader: string | null, signal: BareAbortSignal): Promise<string | {
-    error: string;
-    stateless?: true;
-}>;