@xrkseek/harness 0.6.21 → 0.7.0-rc.1

package/node_modules/@xrkseek/exec-computer-use/package.json

@@ -1,26 +1,26 @@
-{
-  "name": "@xrkseek/exec-computer-use",
-  "version": "0.1.0",
-  "type": "module",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "dependencies": {
-    "@xrkseek/core-tools": "workspace:*"
-  },
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/xrkseek/XRK-harness.git",
-    "directory": "packages/exec/computer-use"
-  },
-  "private": true
-}
+{
+  "name": "@xrkseek/exec-computer-use",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@xrkseek/core-tools": "workspace:*"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xrkseek/XRK-harness.git",
+    "directory": "packages/exec/computer-use"
+  },
+  "private": true
+}

package/node_modules/@xrkseek/exec-fs/README.md

@@ -1,12 +1,12 @@
-# @xrkseek/exec-fs
-
-Workspace-rooted `FsService` + tools:
-
-- `read_file` / `write_file` / `apply_edit` / `apply_patch` (Codex `*** Begin Patch` format)
-- `glob` / `grep` (built-in; no shell rg)
-
-Provider: `createFsLocalProvider`. Consumer: `createFsTools(fs)`.
-`apply_patch` shares the session cwd (including managed subagent worktrees);
-folding a worktree branch back into the parent repo is Face
-`ManagedWorktreeManager.mergeIntoParent` (ff-only), not this package.
-See `docs/seams.md` · `docs/status.md`.
+# @xrkseek/exec-fs
+
+Workspace-rooted `FsService` + tools:
+
+- `read_file` / `write_file` / `apply_edit` / `apply_patch` (Codex `*** Begin Patch` format)
+- `glob` / `grep` (built-in; no shell rg)
+
+Provider: `createFsLocalProvider`. Consumer: `createFsTools(fs)`.
+`apply_patch` shares the session cwd (including managed subagent worktrees);
+folding a worktree branch back into the parent repo is Face
+`ManagedWorktreeManager.mergeIntoParent` (ff-only), not this package.
+See `docs/seams.md` · `docs/status.md`.

package/node_modules/@xrkseek/exec-fs/dist/read-image.js

@@ -31,10 +31,10 @@ export function formatImageReadOutput(displayPath, image) {
                 `(${image.cropOffset.x}, ${image.cropOffset.y}); coordinates are relative ` +
                 `to that crop origin — add the offset to map back to the full image`;
     }
-    return `<path>${displayPath}</path>
-<type>image</type>
-<content>
-${image.mediaType} image, ${image.width}x${image.height} px, ${image.bytes} bytes${scaled}${cropNote}
+    return `<path>${displayPath}</path>
+<type>image</type>
+<content>
+${image.mediaType} image, ${image.width}x${image.height} px, ${image.bytes} bytes${scaled}${cropNote}
 </content>`;
 }
 /** Host attachment id (`sha256:…`) or `attachment:<id>` — not a workspace path. */

package/node_modules/@xrkseek/exec-image-gen/README.md

@@ -1,13 +1,13 @@
-# @xrkseek/exec-image-gen
-
-Text-to-image / image-to-image Provider seam for the model tool surface.
-
-**Product path**: Settings → Plugins → Image generation (Face ns `image-gen`). Modes: `off` · `openai` · `fal` · `xai`. Credentials hold `XRK_IMAGE_GEN_OPENAI_KEY` / `XRK_IMAGE_GEN_FAL_KEY` / `XRK_IMAGE_GEN_XAI_KEY` (runtime also accepts `OPENAI_API_KEY` · `FAL_KEY` · `XAI_API_KEY`). Env (`XRK_IMAGE_GEN=memory` / `=1` / `fal` / `xai`) is CI / headless bypass only — see [docs/image-gen.md](../../../docs/image-gen.md).
-
-- **Definition**: `ImageGenService.generate` + optional `capabilities()`
-- **Provider**: `createMemoryImageGenProvider` · `createOpenAiImageGenProvider` (generations + edits)
-- **Consumer**: `createImageGenTools` → `image_generate` (schema rebuilt from capabilities)
-
-Edit args (`image_url` · `reference_image_urls` · `reference_attachment_ids`) appear only when the Provider advertises image modalities.
-
-See also [docs/seams.md](../../../docs/seams.md).
+# @xrkseek/exec-image-gen
+
+Text-to-image / image-to-image Provider seam for the model tool surface.
+
+**Product path**: Settings → Plugins → Image generation (Face ns `image-gen`). Modes: `off` · `openai` · `fal` · `xai`. Credentials hold `XRK_IMAGE_GEN_OPENAI_KEY` / `XRK_IMAGE_GEN_FAL_KEY` / `XRK_IMAGE_GEN_XAI_KEY` (runtime also accepts `OPENAI_API_KEY` · `FAL_KEY` · `XAI_API_KEY`). Env (`XRK_IMAGE_GEN=memory` / `=1` / `fal` / `xai`) is CI / headless bypass only — see [docs/image-gen.md](../../../docs/image-gen.md).
+
+- **Definition**: `ImageGenService.generate` + optional `capabilities()`
+- **Provider**: `createMemoryImageGenProvider` · `createOpenAiImageGenProvider` (generations + edits)
+- **Consumer**: `createImageGenTools` → `image_generate` (schema rebuilt from capabilities)
+
+Edit args (`image_url` · `reference_image_urls` · `reference_attachment_ids`) appear only when the Provider advertises image modalities.
+
+See also [docs/seams.md](../../../docs/seams.md).

package/node_modules/@xrkseek/exec-image-gen/package.json

@@ -1,28 +1,28 @@
-{
-  "name": "@xrkseek/exec-image-gen",
-  "version": "0.1.0",
-  "type": "module",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "dependencies": {
-    "@xrkseek/attachment": "workspace:*",
-    "@xrkseek/core-tools": "workspace:*",
-    "@xrkseek/protocol": "workspace:*"
-  },
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/xrkseek/XRK-harness.git",
-    "directory": "packages/exec/image-gen"
-  },
-  "private": true
-}
+{
+  "name": "@xrkseek/exec-image-gen",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@xrkseek/attachment": "workspace:*",
+    "@xrkseek/core-tools": "workspace:*",
+    "@xrkseek/protocol": "workspace:*"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xrkseek/XRK-harness.git",
+    "directory": "packages/exec/image-gen"
+  },
+  "private": true
+}

package/node_modules/@xrkseek/exec-memory/README.md

@@ -1,14 +1,14 @@
-# @xrkseek/exec-memory
-
-Curated memory files frozen into the system prompt at session start.
-
-- **Definition**: `CuratedMemoryStore` / `MemoryProvider` (`add` / `replace` / `remove`, plus an atomic batch)
-- **Providers**: default **file** (`MEMORY.md` / `USER.md` under `{XRK_HOME}/memories`); optional **HTTP** and **sqlite** samples
-- **Consumer**: `createCuratedMemoryTools` → `memory`
-- **Consolidate**: Phase1 heuristic session-end; optional Phase2 LLM extract (`consolidateCuratedMemoryPhase2`)
-
-The prompt block is the snapshot taken when the store is created. Tool writes update the backend and leave that snapshot alone. This is not the Mnemon document library.
-
-Select via `resolveMemoryProvider` / `XRK_MEMORY_PROVIDER=file|http|sqlite` (+ `XRK_MEMORY_HTTP_URL` for http).
-
-See [docs/curated-memory.md](../../../docs/curated-memory.md).
+# @xrkseek/exec-memory
+
+Curated memory files frozen into the system prompt at session start.
+
+- **Definition**: `CuratedMemoryStore` / `MemoryProvider` (`add` / `replace` / `remove`, plus an atomic batch)
+- **Providers**: default **file** (`MEMORY.md` / `USER.md` under `{XRK_HOME}/memories`); optional **HTTP** and **sqlite** samples
+- **Consumer**: `createCuratedMemoryTools` → `memory`
+- **Consolidate**: Phase1 heuristic session-end; optional Phase2 LLM extract (`consolidateCuratedMemoryPhase2`)
+
+The prompt block is the snapshot taken when the store is created. Tool writes update the backend and leave that snapshot alone. This is not the Mnemon document library.
+
+Select via `resolveMemoryProvider` / `XRK_MEMORY_PROVIDER=file|http|sqlite` (+ `XRK_MEMORY_HTTP_URL` for http).
+
+See [docs/curated-memory.md](../../../docs/curated-memory.md).

package/node_modules/@xrkseek/exec-memory/dist/live-fragment.d.ts

@@ -0,0 +1,11 @@
+import type { CuratedMemoryStore } from "./store.js";
+export declare const CURATED_MEMORY_FRAGMENT_ID = "additional_context.curated_memory";
+/** Inner body (host wraps `<external_curated_memory>`). */
+export declare function formatCuratedMemoryLiveBody(store: CuratedMemoryStore): string;
+export declare function curatedMemoryBodyFingerprint(body: string): string;
+/** turn-start always (if non-empty); post-tool only when the body fingerprint moved. */
+export declare function createCuratedMemoryLiveGate(store: CuratedMemoryStore): {
+    turnStart(): string | undefined;
+    postTool(): string | undefined;
+};
+//# sourceMappingURL=live-fragment.d.ts.map

package/node_modules/@xrkseek/exec-memory/dist/live-fragment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-fragment.d.ts","sourceRoot":"","sources":["../src/live-fragment.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,eAAO,MAAM,0BAA0B,sCAAsC,CAAC;AAE9E,2DAA2D;AAC3D,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAI7E;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wFAAwF;AACxF,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,kBAAkB,GAAG;IACtE,SAAS,IAAI,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,IAAI,MAAM,GAAG,SAAS,CAAC;CAChC,CAkBA"}

package/node_modules/@xrkseek/exec-memory/dist/live-fragment.js

@@ -0,0 +1,40 @@
+/**
+ * Live curated-memory body for the fragment channel: leading system stays
+ * policy-only; MEMORY.md / USER.md ride a last-wins additional_context row.
+ */
+import { createHash } from "node:crypto";
+export const CURATED_MEMORY_FRAGMENT_ID = "additional_context.curated_memory";
+/** Inner body (host wraps `<external_curated_memory>`). */
+export function formatCuratedMemoryLiveBody(store) {
+    const block = store.frozenSystemBlock().trim();
+    if (!block)
+        return "";
+    return `LIVE curated memory (prefer over older memory text):\n${block}`;
+}
+export function curatedMemoryBodyFingerprint(body) {
+    return createHash("sha256").update(body).digest("hex");
+}
+/** turn-start always (if non-empty); post-tool only when the body fingerprint moved. */
+export function createCuratedMemoryLiveGate(store) {
+    let lastFp = "";
+    return {
+        turnStart() {
+            const body = formatCuratedMemoryLiveBody(store);
+            if (!body)
+                return undefined;
+            lastFp = curatedMemoryBodyFingerprint(body);
+            return body;
+        },
+        postTool() {
+            const body = formatCuratedMemoryLiveBody(store);
+            if (!body)
+                return undefined;
+            const fp = curatedMemoryBodyFingerprint(body);
+            if (fp === lastFp)
+                return undefined;
+            lastFp = fp;
+            return body;
+        },
+    };
+}
+//# sourceMappingURL=live-fragment.js.map

package/node_modules/@xrkseek/exec-memory/dist/live-fragment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-fragment.js","sourceRoot":"","sources":["../src/live-fragment.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,MAAM,CAAC,MAAM,0BAA0B,GAAG,mCAAmC,CAAC;AAE9E,2DAA2D;AAC3D,MAAM,UAAU,2BAA2B,CAAC,KAAyB;IACnE,MAAM,KAAK,GAAG,KAAK,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,CAAC;IAC/C,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO,yDAAyD,KAAK,EAAE,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,IAAY;IACvD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,2BAA2B,CAAC,KAAyB;IAInE,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,OAAO;QACL,SAAS;YACP,MAAM,IAAI,GAAG,2BAA2B,CAAC,KAAK,CAAC,CAAC;YAChD,IAAI,CAAC,IAAI;gBAAE,OAAO,SAAS,CAAC;YAC5B,MAAM,GAAG,4BAA4B,CAAC,IAAI,CAAC,CAAC;YAC5C,OAAO,IAAI,CAAC;QACd,CAAC;QACD,QAAQ;YACN,MAAM,IAAI,GAAG,2BAA2B,CAAC,KAAK,CAAC,CAAC;YAChD,IAAI,CAAC,IAAI;gBAAE,OAAO,SAAS,CAAC;YAC5B,MAAM,EAAE,GAAG,4BAA4B,CAAC,IAAI,CAAC,CAAC;YAC9C,IAAI,EAAE,KAAK,MAAM;gBAAE,OAAO,SAAS,CAAC;YACpC,MAAM,GAAG,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}

package/node_modules/@xrkseek/exec-memory/package.json

@@ -1,28 +1,28 @@
-{
-  "name": "@xrkseek/exec-memory",
-  "version": "0.1.0",
-  "type": "module",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "dependencies": {
-    "@xrkseek/core-tools": "workspace:*",
-    "@xrkseek/secrets": "workspace:*",
-    "@xrkseek/xrk-home-paths": "workspace:*"
-  },
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/xrkseek/XRK-harness.git",
-    "directory": "packages/exec/memory"
-  },
-  "private": true
-}
+{
+  "name": "@xrkseek/exec-memory",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@xrkseek/core-tools": "workspace:*",
+    "@xrkseek/secrets": "workspace:*",
+    "@xrkseek/xrk-home-paths": "workspace:*"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xrkseek/XRK-harness.git",
+    "directory": "packages/exec/memory"
+  },
+  "private": true
+}

package/node_modules/@xrkseek/exec-sandbox/README.md

@@ -1,15 +1,15 @@
-# @xrkseek/exec-sandbox
-
-`SandboxService.wrapArgv` (sync) · `confine(argv, cwd?, signal?)` (cancellable async).
-
-Providers (same Definition):
-
-| Provider | Role |
-|----------|------|
-| Permissive · Workspace · DenyList | Default Host stack |
-| **Docker** | `docker run --rm` + workspace bind mount (`XRK_SANDBOX_BACKEND=docker`) |
-| **bubblewrap** | Linux `bwrap` (`XRK_SANDBOX_BACKEND=bwrap`) |
-
-`createSandboxStack` builds the chain from options / env. `createSandboxWrapGuard` plugs into tool pipeline guards. Shell / PTY spawn paths prefer `confine`.
-
-See [docs/sandbox.md](../../../docs/sandbox.md) · [docs/seams.md](../../../docs/seams.md).
+# @xrkseek/exec-sandbox
+
+`SandboxService.wrapArgv` (sync) · `confine(argv, cwd?, signal?)` (cancellable async).
+
+Providers (same Definition):
+
+| Provider | Role |
+|----------|------|
+| Permissive · Workspace · DenyList | Default Host stack |
+| **Docker** | `docker run --rm` + workspace bind mount (`XRK_SANDBOX_BACKEND=docker`) |
+| **bubblewrap** | Linux `bwrap` (`XRK_SANDBOX_BACKEND=bwrap`) |
+
+`createSandboxStack` builds the chain from options / env. `createSandboxWrapGuard` plugs into tool pipeline guards. Shell / PTY spawn paths prefer `confine`.
+
+See [docs/sandbox.md](../../../docs/sandbox.md) · [docs/seams.md](../../../docs/seams.md).

package/node_modules/@xrkseek/exec-ssh/README.md

@@ -1,19 +1,19 @@
-# @xrkseek/exec-ssh
-
-POSIX SSH providers for a **local Host / remote execution world** (Hermes-style thin transport; DSH-shaped seams).
-
-When Settings General → Remote (`ssh-remote`) or `XRK_SSH_HOST` + `XRK_SSH_WORKSPACE` are set (env host non-empty bypasses Settings), Host/CLI swap `FsService` + `SubprocessService` (and optional `run_code`) onto OpenSSH. Model tools stay `read_file` / `bash` / `run_code` — no `ssh_*` tools. Face `host.listDirectory` / `host.createDirectory` use the same session (`listSshDirectory` / `createSshDirectory`). Interactive PTY and host-local `openPath` / OS folder picker are off (`host.describe.remoteExecution`). Settings changes need a Host restart.
-
-| Env | Meaning |
-| --- | --- |
-| `XRK_SSH_HOST` | OpenSSH host or `user@host` alias (required with workspace) |
-| `XRK_SSH_WORKSPACE` | Absolute remote cwd (required) |
-| `XRK_SSH_USER` | Optional user when host is bare |
-| `XRK_SSH_PORT` | Optional port (default OpenSSH) |
-| `XRK_SSH_KEY` | Optional identity file |
-| `XRK_SSH_NODE` | Remote Node for `run_code` (default `node`) |
-| `XRK_SSH_SKIP_PROBE` | `1` skips Host BatchMode connect probe (CI mocks) |
-
-Host probes with remote `true` before serving when SSH is on (`createSshExecutionWorldReady`). `xrkh doctor` reports `ssh-remote`. Cloud tasks / Codex Noise exec-server are **not** in this package.
-
-See `docs/seams.md` · `docs/configuration.md`.
+# @xrkseek/exec-ssh
+
+POSIX SSH providers for a **local Host / remote execution world** (Hermes-style thin transport; DSH-shaped seams).
+
+When Settings General → Remote (`ssh-remote`) or `XRK_SSH_HOST` + `XRK_SSH_WORKSPACE` are set (env host non-empty bypasses Settings), Host/CLI swap `FsService` + `SubprocessService` (and optional `run_code`) onto OpenSSH. Model tools stay `read_file` / `bash` / `run_code` — no `ssh_*` tools. Face `host.listDirectory` / `host.createDirectory` use the same session (`listSshDirectory` / `createSshDirectory`). Interactive PTY and host-local `openPath` / OS folder picker are off (`host.describe.remoteExecution`). Settings changes need a Host restart.
+
+| Env | Meaning |
+| --- | --- |
+| `XRK_SSH_HOST` | OpenSSH host or `user@host` alias (required with workspace) |
+| `XRK_SSH_WORKSPACE` | Absolute remote cwd (required) |
+| `XRK_SSH_USER` | Optional user when host is bare |
+| `XRK_SSH_PORT` | Optional port (default OpenSSH) |
+| `XRK_SSH_KEY` | Optional identity file |
+| `XRK_SSH_NODE` | Remote Node for `run_code` (default `node`) |
+| `XRK_SSH_SKIP_PROBE` | `1` skips Host BatchMode connect probe (CI mocks) |
+
+Host probes with remote `true` before serving when SSH is on (`createSshExecutionWorldReady`). `xrkh doctor` reports `ssh-remote`. Cloud tasks / Codex Noise exec-server are **not** in this package.
+
+See `docs/seams.md` · `docs/configuration.md`.

package/node_modules/@xrkseek/exec-subprocess/README.md

@@ -1,10 +1,10 @@
-# @xrkseek/exec-subprocess
-
-Local `SubprocessService`:
-
-- `spawn(argv)` — await exit (stdout/stderr/code; AbortSignal + timeout)  
-- `start(argv)` → `SubprocessHandle` (`kill` · `result()`; **no** `pid`)
-- Windows: non-terminal children use `windowsHide` (no console flash for bash/code helpers); stop uses `taskkill /T /F` (hidden helper)
-- Terminal processes keep `pid` on `@xrkseek/exec-pty` `SubprocessTerminalHandle`
-
-Consumer: `@xrkseek/exec-shell`. See `docs/seams.md` · `docs/shell-jobs.md`.
+# @xrkseek/exec-subprocess
+
+Local `SubprocessService`:
+
+- `spawn(argv)` — await exit (stdout/stderr/code; AbortSignal + timeout)  
+- `start(argv)` → `SubprocessHandle` (`kill` · `result()`; **no** `pid`)
+- Windows: non-terminal children use `windowsHide` (no console flash for bash/code helpers); stop uses `taskkill /T /F` (hidden helper)
+- Terminal processes keep `pid` on `@xrkseek/exec-pty` `SubprocessTerminalHandle`
+
+Consumer: `@xrkseek/exec-shell`. See `docs/seams.md` · `docs/shell-jobs.md`.

package/node_modules/@xrkseek/exec-video-analyze/README.md

@@ -1,11 +1,11 @@
-# `@xrkseek/exec-video-analyze`
-
-Hermes-style **video understanding** tool (`video_analyze`).
-
-- **In**: video URL or workspace path + question  
-- **Out**: JSON `{ success, analysis, … }` text (whole-clip multimodal LLM — not frame extraction)  
-- **Not**: `browser_vision` (live page screenshot) · `video_generate` (create video) · `read_image` (stills)
-
-Providers: `memory` (CI) · OpenAI-compatible chat with `video_url` part (needs a video-capable model such as Gemini).
-
-See [docs/video-analyze.md](../../../docs/video-analyze.md).
+# `@xrkseek/exec-video-analyze`
+
+Hermes-style **video understanding** tool (`video_analyze`).
+
+- **In**: video URL or workspace path + question  
+- **Out**: JSON `{ success, analysis, … }` text (whole-clip multimodal LLM — not frame extraction)  
+- **Not**: `browser_vision` (live page screenshot) · `video_generate` (create video) · `read_image` (stills)
+
+Providers: `memory` (CI) · OpenAI-compatible chat with `video_url` part (needs a video-capable model such as Gemini).
+
+See [docs/video-analyze.md](../../../docs/video-analyze.md).

package/node_modules/@xrkseek/exec-video-analyze/package.json

@@ -1,26 +1,26 @@
-{
-  "name": "@xrkseek/exec-video-analyze",
-  "version": "0.1.0",
-  "type": "module",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "dependencies": {
-    "@xrkseek/core-tools": "workspace:*"
-  },
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/xrkseek/XRK-harness.git",
-    "directory": "packages/exec/video-analyze"
-  },
-  "private": true
-}
+{
+  "name": "@xrkseek/exec-video-analyze",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@xrkseek/core-tools": "workspace:*"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xrkseek/XRK-harness.git",
+    "directory": "packages/exec/video-analyze"
+  },
+  "private": true
+}

package/node_modules/@xrkseek/exec-video-gen/README.md

@@ -1,26 +1,26 @@
-# @xrkseek/exec-video-gen
-
-Text-to-video / image-to-video Provider seam for the model tool surface.
-
-**Product path**: Settings → Plugins → Video generation (Face ns `video-gen`). Modes: `off` · `openai` · `fal` · `xai`. Credentials hold `XRK_VIDEO_GEN_OPENAI_KEY` / `XRK_VIDEO_GEN_FAL_KEY` / `XRK_VIDEO_GEN_XAI_KEY` (runtime also accepts `OPENAI_API_KEY` · `FAL_KEY` · `XAI_API_KEY`). Env (`XRK_VIDEO_GEN=memory` / `=1` / `fal` / `xai`) is CI / headless bypass only — see [docs/video-gen.md](../../../docs/video-gen.md).
-
-- **Definition**: `VideoGenService` — `create` · `get` · `content` (+ optional `capabilities`)
-- **Provider**: `createMemoryVideoGenProvider` · `createOpenAiVideoGenProvider` · Host-injected
-- **Consumer**: `createVideoGenTools` → `video_generate` (schema rebuilt from `capabilities()`)
-
-Renders are asynchronous, so the seam exposes job semantics instead of one-shot bytes:
-`create` returns a `jobId`, `get` polls status, and `content` downloads the MP4 once
-`status=completed` (an early `content` call raises `VIDEO_GEN_NOT_READY`).
-
-**i2v**: pass a decoded `firstFrame` (tools resolve `first_frame` / `image_url` /
-`reference_attachment_ids`). OpenAI uploads it as multipart `input_reference`.
-
-**edit / extend**: `create({ kind: "edit"|"extend", sourceVideoId, prompt })` →
-`POST /videos/edits` · `/videos/extensions`. Tools expose `action=edit|extend|catalog`.
-
-**Family catalog**: `capabilities().families` (Hermes fal-style; OpenAI lists sora-2 / sora-2-pro).
-
-Video bytes are never inlined into tool text; with an `AttachmentStore` the finished MP4 is
-persisted via `saveFile` and returned as an attachment id.
-
-See also [docs/seams.md](../../../docs/seams.md).
+# @xrkseek/exec-video-gen
+
+Text-to-video / image-to-video Provider seam for the model tool surface.
+
+**Product path**: Settings → Plugins → Video generation (Face ns `video-gen`). Modes: `off` · `openai` · `fal` · `xai`. Credentials hold `XRK_VIDEO_GEN_OPENAI_KEY` / `XRK_VIDEO_GEN_FAL_KEY` / `XRK_VIDEO_GEN_XAI_KEY` (runtime also accepts `OPENAI_API_KEY` · `FAL_KEY` · `XAI_API_KEY`). Env (`XRK_VIDEO_GEN=memory` / `=1` / `fal` / `xai`) is CI / headless bypass only — see [docs/video-gen.md](../../../docs/video-gen.md).
+
+- **Definition**: `VideoGenService` — `create` · `get` · `content` (+ optional `capabilities`)
+- **Provider**: `createMemoryVideoGenProvider` · `createOpenAiVideoGenProvider` · Host-injected
+- **Consumer**: `createVideoGenTools` → `video_generate` (schema rebuilt from `capabilities()`)
+
+Renders are asynchronous, so the seam exposes job semantics instead of one-shot bytes:
+`create` returns a `jobId`, `get` polls status, and `content` downloads the MP4 once
+`status=completed` (an early `content` call raises `VIDEO_GEN_NOT_READY`).
+
+**i2v**: pass a decoded `firstFrame` (tools resolve `first_frame` / `image_url` /
+`reference_attachment_ids`). OpenAI uploads it as multipart `input_reference`.
+
+**edit / extend**: `create({ kind: "edit"|"extend", sourceVideoId, prompt })` →
+`POST /videos/edits` · `/videos/extensions`. Tools expose `action=edit|extend|catalog`.
+
+**Family catalog**: `capabilities().families` (Hermes fal-style; OpenAI lists sora-2 / sora-2-pro).
+
+Video bytes are never inlined into tool text; with an `AttachmentStore` the finished MP4 is
+persisted via `saveFile` and returned as an attachment id.
+
+See also [docs/seams.md](../../../docs/seams.md).

package/node_modules/@xrkseek/exec-voice/README.md

@@ -1,25 +1,25 @@
-# @xrkseek/exec-voice
-
-Voice Host seam: TTS · dictation (STT) · realtime voice session broker.
-
-- **Definition**: `VoiceService` (`synthesize` · `transcribe` · `createLiveSession` · `liveStatus`)
-- **Provider**: `createMemoryVoiceProvider` · `createOpenAiVoiceProvider` · `createSenseVoiceLocalProvider` · Host-injected
-- **Consumer**: `createVoiceTools` → `text_to_speech` · `voice_transcribe` · `voice_session`
-
-Mic/speaker and WebRTC stay on the client. Tools stay registered when no Provider is configured; execute fails honestly (`describeVoiceAccess` / `voiceUnavailableMessage` share the same copy with Settings and `xrkh doctor`).
-
-Product path: Settings → Plugins → Voice (`mode` off/openai + Credentials key). Env: `XRK_VOICE=memory` | `XRK_VOICE=1` + `OPENAI_API_KEY` / `XRK_VOICE_OPENAI_KEY`. Wake word is not shipped.
-
-## Browser mic transport
-
-`@xrkseek/exec-voice/browser` is the client-side capture seam: DOM-free structural types with every
-capability injected through `BrowserVoiceDeps` (`getUserMedia` · `MediaRecorder` · `PeerConnection` · `btoa`).
-
-- `createBrowserVoiceTransport(deps)` → `capabilities()` · `dictate()` / `openDictation()` · `session({ broker })`
-- `startDictation` · `dictateOnce` · `pickRecorderMime` · `encodeBase64`
-- `startVoiceSession` — local SDP offer → Host broker → answer; `stop()` releases the mic and closes the peer connection
-
-Audio never transits the Host. A denied mic → `VOICE_BACKEND`; a missing API (insecure context / SSR) →
-`VOICE_UNAVAILABLE`; a client-secret-only broker answer → `VOICE_LIVE_UNSUPPORTED`.
-
-See [docs/voice.md](../../../docs/voice.md) · [docs/seams.md](../../../docs/seams.md).
+# @xrkseek/exec-voice
+
+Voice Host seam: TTS · dictation (STT) · realtime voice session broker.
+
+- **Definition**: `VoiceService` (`synthesize` · `transcribe` · `createLiveSession` · `liveStatus`)
+- **Provider**: `createMemoryVoiceProvider` · `createOpenAiVoiceProvider` · `createSenseVoiceLocalProvider` · Host-injected
+- **Consumer**: `createVoiceTools` → `text_to_speech` · `voice_transcribe` · `voice_session`
+
+Mic/speaker and WebRTC stay on the client. Tools stay registered when no Provider is configured; execute fails honestly (`describeVoiceAccess` / `voiceUnavailableMessage` share the same copy with Settings and `xrkh doctor`).
+
+Product path: Settings → Plugins → Voice (`mode` off/openai + Credentials key). Env: `XRK_VOICE=memory` | `XRK_VOICE=1` + `OPENAI_API_KEY` / `XRK_VOICE_OPENAI_KEY`. Wake word is not shipped.
+
+## Browser mic transport
+
+`@xrkseek/exec-voice/browser` is the client-side capture seam: DOM-free structural types with every
+capability injected through `BrowserVoiceDeps` (`getUserMedia` · `MediaRecorder` · `PeerConnection` · `btoa`).
+
+- `createBrowserVoiceTransport(deps)` → `capabilities()` · `dictate()` / `openDictation()` · `session({ broker })`
+- `startDictation` · `dictateOnce` · `pickRecorderMime` · `encodeBase64`
+- `startVoiceSession` — local SDP offer → Host broker → answer; `stop()` releases the mic and closes the peer connection
+
+Audio never transits the Host. A denied mic → `VOICE_BACKEND`; a missing API (insecure context / SSR) →
+`VOICE_UNAVAILABLE`; a client-secret-only broker answer → `VOICE_LIVE_UNSUPPORTED`.
+
+See [docs/voice.md](../../../docs/voice.md) · [docs/seams.md](../../../docs/seams.md).