@qvac/harness 0.7.1 → 1.0.0-rc.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qvac/harness",
-  "version": "0.7.1",
+  "version": "1.0.0-rc.1",
   "type": "module",
   "engines": {
     "bare": ">=1.34.0"
@@ -23,6 +23,14 @@
       "types": "./dist-lib/lib/dns-lookup.d.ts",
       "default": "./dist-lib/lib/dns-lookup.js"
     },
+    "./lib/connect.ts": {
+      "types": "./dist-lib/lib/connect.d.ts",
+      "default": "./dist-lib/lib/connect.js"
+    },
+    "./lib/contract-types.ts": {
+      "types": "./dist-lib/lib/contract-types.d.ts",
+      "default": "./dist-lib/lib/contract-types.js"
+    },
     "./lib/helpers/race-abort.ts": {
       "types": "./dist-lib/lib/helpers/race-abort.d.ts",
       "default": "./dist-lib/lib/helpers/race-abort.js"
@@ -155,6 +163,14 @@
       "types": "./dist-lib/lib/sdk-storage.d.ts",
       "default": "./dist-lib/lib/sdk-storage.js"
     },
+    "./run-log": {
+      "types": "./dist-lib/lib/run-log-protocol.d.ts",
+      "default": "./dist-lib/lib/run-log-protocol.js"
+    },
+    "./run-log-inspect": {
+      "types": "./dist-lib/lib/run-log-inspect.d.ts",
+      "default": "./dist-lib/lib/run-log-inspect.js"
+    },
     "./model-progress": {
       "types": "./dist-lib/lib/model-download-progress.d.ts",
       "default": "./dist-lib/lib/model-download-progress.js"
@@ -619,6 +635,7 @@
     "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 brittle-jobs 'test/{,!(helpers)/}*.ts'",
+    "machine:graph": "bun scripts/generate-completion-graph.ts",
     "format": "prettier . --write",
     "lint": "prettier . --check && lunte && tsc --noEmit",
     "build:bundle": "node scripts/build-bundle.mjs",
@@ -692,7 +709,7 @@
     },
     "#pyodide-worker-entry": "./dist-lib/lib/tools/exec/adapters/python/worker/entry.js",
     "#pyodide-interrupt-deadline": "./dist-lib/lib/tools/exec/adapters/python/worker/interrupt-deadline.js",
-    "#pyodide-wheels": "./wheels/",
+    "#pyodide-wheels": "./wheels/manifest.json",
     "worker_threads": {
       "bare": "bare-worker"
     },
@@ -765,6 +782,7 @@
     "streamx": "^2.28.0",
     "watch-drive": "^2.0.3",
     "which-runtime": "^1.4.0",
+    "xstate": "~5.33.1",
     "zod": "^4.3.6"
   },
   "devDependencies": {

package/patches/@qvac%2Finference@0.20.0.patch

@@ -0,0 +1,67 @@
+diff --git a/dist/plugins/builtin/llamacpp-completion/ops/completion-stream.js b/dist/plugins/builtin/llamacpp-completion/ops/completion-stream.js
+index 9eab782f56a8cf18065470a17d2d82a9d123bec8..3439075affeded6d818286a67bb296da3b60a605 100644
+--- a/dist/plugins/builtin/llamacpp-completion/ops/completion-stream.js
++++ b/dist/plugins/builtin/llamacpp-completion/ops/completion-stream.js
+@@ -267,7 +267,10 @@ export async function* completion(params, opts) {
+         const transformedHistory = transformMessages(historyWithTools);
+         logCacheDisabled();
+         logMessagesToAddon(transformedHistory, 'NO_CACHE');
+-        return yield* processModelResponse(model, transformedHistory, tools, mergedGenerationParams, undefined, dialect, setActiveResponse);
++        // qvac-app patch: see the PROMPT_SEND path below
++        const uncached = yield* processModelResponse(model, transformedHistory, tools, mergedGenerationParams, undefined, dialect, setActiveResponse);
++        if (uncached?.stats) uncached.stats.sentMessages = transformedHistory;
++        return uncached;
+     }
+     // ---- KV-cache path. The session owns every bookkeeping layer; the handler
+     // registers one deferred unwind that `commitTurn` short-circuits on the happy
+@@ -340,6 +343,9 @@ export async function* completion(params, opts) {
+         preserveCacheOnUnwind = !addonRunSettled;
+         throw error;
+     }
++    // qvac-app patch: the messages the cache slice actually pushed, for the prompt inspector.
++    // Rides the call's own result, so it needs no correlation back to the request.
++    if (result?.stats) result.stats.sentMessages = messagesToSend;
+     const shouldCommitTurn = shouldCommitCachedTurn({
+         aborted: signal.aborted,
+         producedTokens: result.producedTokens,
+diff --git a/dist/schemas/completion-event.d.ts b/dist/schemas/completion-event.d.ts
+index 535792ffeedc7f8bcd8fec53b9c9486a76e935e0..737c14b11ed7c2a13d612fae1cd06f7655e84870 100644
+--- a/dist/schemas/completion-event.d.ts
++++ b/dist/schemas/completion-event.d.ts
+@@ -5,6 +5,7 @@ export declare const completionStatsSchema: z.ZodObject<{
+     timeToFirstToken: z.ZodOptional<z.ZodNumber>;
+     tokensPerSecond: z.ZodOptional<z.ZodNumber>;
+     promptTokensPerSecond: z.ZodOptional<z.ZodNumber>;
++    sentMessages: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+     cacheTokens: z.ZodOptional<z.ZodNumber>;
+     promptTokens: z.ZodOptional<z.ZodNumber>;
+     generatedTokens: z.ZodOptional<z.ZodNumber>;
+@@ -63,6 +64,7 @@ export declare const statsEventSchema: z.ZodObject<{
+         timeToFirstToken: z.ZodOptional<z.ZodNumber>;
+         tokensPerSecond: z.ZodOptional<z.ZodNumber>;
+         promptTokensPerSecond: z.ZodOptional<z.ZodNumber>;
++    sentMessages: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+         cacheTokens: z.ZodOptional<z.ZodNumber>;
+         promptTokens: z.ZodOptional<z.ZodNumber>;
+         generatedTokens: z.ZodOptional<z.ZodNumber>;
+@@ -147,6 +149,7 @@ export declare const completionEventSchema: z.ZodUnion<readonly [z.ZodObject<{
+         timeToFirstToken: z.ZodOptional<z.ZodNumber>;
+         tokensPerSecond: z.ZodOptional<z.ZodNumber>;
+         promptTokensPerSecond: z.ZodOptional<z.ZodNumber>;
++    sentMessages: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+         cacheTokens: z.ZodOptional<z.ZodNumber>;
+         promptTokens: z.ZodOptional<z.ZodNumber>;
+         generatedTokens: z.ZodOptional<z.ZodNumber>;
+diff --git a/dist/schemas/completion-event.js b/dist/schemas/completion-event.js
+index 1ef0d68a9a8cf6f590988272e114ac54ea093614..1d110710d476eed33ed5118f6f32f605f8ea5be8 100644
+--- a/dist/schemas/completion-event.js
++++ b/dist/schemas/completion-event.js
+@@ -4,6 +4,8 @@ export const completionStatsSchema = z.object({
+     timeToFirstToken: z.number().optional(),
+     tokensPerSecond: z.number().optional(),
+     promptTokensPerSecond: z.number().optional(),
++    // qvac-harness patch: the post-cache messages the SDK pushed to the addon
++    sentMessages: z.array(z.unknown()).optional(),
+     cacheTokens: z.number().optional(),
+     promptTokens: z.number().optional(),
+     // Decode count (`llama_perf` `n_eval`) — length / KV-cache budget decisions.

package/patches/bare-stow@0.1.5.patch

@@ -0,0 +1,68 @@
+diff --git a/lib/host.d.ts b/lib/host.d.ts
+index dacda847a9efbeab6991bbd7adf3ee644aad1523..82d3a1e11cef3c449ec00e2dc11908ed081f0aed 100644
+--- a/lib/host.d.ts
++++ b/lib/host.d.ts
+@@ -12,8 +12,4 @@ declare class IPC {
+ 
+ declare function wrap(stream: Duplex): IPC
+ 
+-declare namespace wrap {
+-  export { IPC }
+-}
+-
+-export = wrap
++export { type IPC, wrap }
+diff --git a/lib/host.js b/lib/host.js
+index 7e62e044374ffa5db7dd3f8bd231e8cd0b973d70..1233405a9e437c6ff1b28a7db968b65dc8f6cd58 100644
+--- a/lib/host.js
++++ b/lib/host.js
+@@ -5,17 +5,27 @@ class IPC extends Protocol {
+     super(stream)
+ 
+     this._ready = new Promise((resolve, reject) => {
++      const cleanup = () => {
++        this.off('ready', onready)
++          .off('error', onerror)
++          .off('close', onclose)
++          .off('exit', onexit)
++      }
++
+       const onready = () => {
+-        this.off('ready', onready).off('error', onerror)
++        cleanup()
+         resolve()
+       }
+ 
+       const onerror = (err) => {
+-        this.off('ready', onready).off('error', onerror)
++        cleanup()
+         reject(err)
+       }
+ 
+-      this.on('ready', onready).on('error', onerror)
++      const onclose = () => onerror(new Error('Worker IPC closed before ready'))
++      const onexit = (code) => onerror(new Error(`Worker exited (${code}) before ready`))
++
++      this.on('ready', onready).on('error', onerror).on('close', onclose).on('exit', onexit)
+     })
+ 
+     this._ready.catch(() => {})
+@@ -50,8 +60,16 @@ class IPC extends Protocol {
+   _destroy(err, cb) {
+     if (this._stream.destroyed) return cb(null)
+ 
+-    this.send('terminate')
+-    this._stream.once('close', () => cb(null))
++    let finished = false
++    const finish = () => {
++      if (finished) return
++      finished = true
++      if (!this._stream.destroyed) this._stream.destroy()
++      cb(null)
++    }
++
++    this.send('terminate').then(finish, finish)
++    this._stream.once('close', finish)
+   }
+ }
+ 

package/patches/hypercore-blob-server@1.15.0.patch

@@ -0,0 +1,15 @@
+diff --git a/index.js b/index.js
+index b69385ddadfa23e5fe1bbdbe8e2c92a6c2d65e97..a230bae8496fca54c476f2810a6e985377dc3d12 100644
+--- a/index.js
++++ b/index.js
+@@ -478,7 +478,9 @@ module.exports = class HypercoreBlobServer {
+     if (this.listening) await this.listening
+     if (this.resuming) await this.resuming
+     this.resuming = null
+-    await this._closeAll(false)
++    // _closeAll(false) drops the server reference without closing the socket, so the
++    // orphan keeps the port and resume rebinds elsewhere, invalidating every link
++    await this._closeAll(true)
+   }
+ 
+   resume () {

package/patches/localwatch@1.4.3.patch

@@ -0,0 +1,13 @@
+diff --git a/index.js b/index.js
+index 385cd0ec3ebc88c0394d25056e4872f43a3b78ca..4fecd4b6bbb7b2d9568b2355dea8c5e3bbe9af03 100644
+--- a/index.js
++++ b/index.js
+@@ -58,7 +58,7 @@ class TreeEntry {
+     for (const [entryFilename, node] of this.list(filename)) {
+       if (node.watcher) node.watcher.close()
+       node.watcher = null
+-      if (node.entries || node.stat.isDirectory()) continue
++      if (node.entries || node.stat?.isDirectory()) continue
+       if (!node.ignore) diff.push({ type: 'delete', filename: entryFilename })
+     }
+     this.entries = null

package/patches/pyodide@314.0.2.patch

@@ -0,0 +1,144 @@
+diff --git a/node_modules/pyodide/.bun-tag-92a0f2d2814ec5f7 b/.bun-tag-92a0f2d2814ec5f7
+new file mode 100644
+index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
+diff --git a/node_modules/pyodide/.bun-tag-eaec348535ef2447 b/.bun-tag-eaec348535ef2447
+new file mode 100644
+index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
+diff --git a/node_modules/pyodide/child-process-stub.cjs b/child-process-stub.cjs
+new file mode 100644
+index 0000000000000000000000000000000000000000..80e5c648355e432f4752fe92b384fbf287bdfedb
+--- /dev/null
++++ b/child-process-stub.cjs
+@@ -0,0 +1,9 @@
++// Pyodide puts this in the globalThis.require map it hands to the interpreter;
++// the real module would give in-interpreter Python code subprocess spawn.
++// spawnSync fails soft (127, command not found) rather than being absent: a
++// throw out of __emscripten_system is a fatal Pyodide error that bricks the
++// interpreter for the rest of the process, so os.system must get an error
++// status back, never an exception.
++module.exports = {
++  spawnSync: () => ({ status: 127, signal: null })
++}
+diff --git a/node_modules/pyodide/module-stub.cjs b/module-stub.cjs
+new file mode 100644
+index 0000000000000000000000000000000000000000..5faa9356939a2c5a4c7cb17f63adb1641eddc9b7
+--- /dev/null
++++ b/module-stub.cjs
+@@ -0,0 +1,22 @@
++// Emscripten's Node glue loads these through createRequire(import.meta.url).
++// bare-module's createRequire reads them off disk, which a Bare >= 1.33 thread
++// cannot, so each is required here, in sight of whatever bundles the graph.
++const modules = {
++  'node:child_process': () => require('node:child_process'),
++  'node:crypto': () => require('node:crypto'),
++  'node:fs': () => require('node:fs'),
++  'node:fs/promises': () => require('node:fs/promises'),
++  'node:net': () => require('node:net'),
++  'node:path': () => require('node:path'),
++  'node:stream': () => require('node:stream'),
++  'node:tls': () => require('node:tls'),
++  'node:tty': () => require('node:tty'),
++  'node:url': () => require('node:url'),
++  'node:vm': () => require('node:vm'),
++  ws: () => require('ws')
++}
++
++exports.createRequire = () => (name) => {
++  if (name in modules) return modules[name]()
++  throw new Error(`Cannot find module '${name}'`)
++}
+diff --git a/package.json b/package.json
+index 96dd5878bc375dae28e8fe61489c522a8ccb70a6..0596466e27b01c4f03ddb8a7b8abcef611a8c3b1 100644
+--- a/package.json
++++ b/package.json
+@@ -121,5 +121,59 @@
+   "types": "./pyodide.d.ts",
+   "engines": {
+     "node": ">=18.0.0"
++  },
++  "imports": {
++    "node:url": {
++      "bare": "bare-url",
++      "default": "node:url"
++    },
++    "node:fs": {
++      "bare": "bare-fs",
++      "default": "node:fs"
++    },
++    "node:fs/promises": {
++      "bare": "bare-fs/promises",
++      "default": "node:fs/promises"
++    },
++    "node:path": {
++      "bare": "bare-path",
++      "default": "node:path"
++    },
++    "node:crypto": {
++      "bare": "bare-crypto",
++      "default": "node:crypto"
++    },
++    "node:child_process": {
++      "bare": "./child-process-stub.cjs",
++      "default": "./child-process-stub.cjs"
++    },
++    "node:module": {
++      "bare": "./module-stub.cjs",
++      "default": "node:module"
++    },
++    "node:tty": {
++      "bare": "./tty-stub.cjs",
++      "default": "node:tty"
++    },
++    "node:net": {
++      "bare": "bare-net",
++      "default": "node:net"
++    },
++    "node:tls": {
++      "bare": "bare-tls",
++      "default": "node:tls"
++    },
++    "node:stream": {
++      "bare": "bare-stream",
++      "default": "node:stream"
++    },
++    "node:vm": {
++      "bare": "./vm-stub.cjs",
++      "default": "node:vm"
++    },
++    "ws": {
++      "bare": "./ws-stub.cjs",
++      "default": "./ws-stub.cjs"
++    }
+   }
+ }
+diff --git a/node_modules/pyodide/tty-stub.cjs b/tty-stub.cjs
+new file mode 100644
+index 0000000000000000000000000000000000000000..9d76ff4984bb153f6eca45d215cecdad610283a2
+--- /dev/null
++++ b/tty-stub.cjs
+@@ -0,0 +1,7 @@
++// Pyodide only needs isatty() for stdin/stdout shape detection. Headless
++// python-pptx runs never have a TTY; return false so the Node writer path
++// does not require bare-tty (which bare-pack often ships as a prebuild-only
++// shell that cannot be resolved from a deferred import).
++module.exports = {
++  isatty: () => false
++}
+diff --git a/node_modules/pyodide/vm-stub.cjs b/vm-stub.cjs
+new file mode 100644
+index 0000000000000000000000000000000000000000..daf730b0788fe050e844b737eb5b3a6337ccb26c
+--- /dev/null
++++ b/vm-stub.cjs
+@@ -0,0 +1,2 @@
++// Bare has no vm; Pyodide imports node:vm but never uses the result.
++module.exports = {}
+diff --git a/node_modules/pyodide/ws-stub.cjs b/ws-stub.cjs
+new file mode 100644
+index 0000000000000000000000000000000000000000..b376ec679ec769c3e6951acf5ddf15227acbdb89
+--- /dev/null
++++ b/ws-stub.cjs
+@@ -0,0 +1,4 @@
++// Pyodide imports this into the globalThis.require map it hands to the
++// interpreter but never calls into it; upstream itself maps "ws": false for
++// browsers. Stubbed to close the outbound network path.
++module.exports = {}