@crouton-kit/humanloop 0.3.10 → 0.3.12

package/dist/cli.js

@@ -657,7 +657,9 @@ viewCmd
     .command('show')
     .description('Render a file live in a tmux pane — passive, no result.\n' +
     '\n' +
-    'stdin  { path: string (required), watch?: bool=true, window?: "split"|"new"="split" }\n' +
+    'The pane always watches the file and live-updates on every save.\n' +
+    '\n' +
+    'stdin  { path: string (required), window?: "split"|"new"="split" }\n' +
     'stdout { pane_id: string|null, reason: string|null }\n' +
     'exit   0 always (not-in-tmux / renderer-unavailable is NOT an error)\n')
     .helpOption('-h, --help', 'Show help')
@@ -667,9 +669,8 @@ viewCmd
         emitError({ error: 'bad_input', message: 'path is required', field: 'path', next: 'Provide: {"path": "/abs/path/file.md"}' });
     }
     const absPath = resolve(input.path);
-    const watch = input.watch !== false;
     const window = input.window === 'new' ? 'new' : 'split';
-    const res = display(absPath, { watch, window });
+    const res = display(absPath, { window });
     if (res.paneId) {
         process.stdout.write(JSON.stringify({ pane_id: res.paneId, reason: null }) + '\n');
     }

package/dist/render/termrender.d.ts

@@ -21,8 +21,6 @@ export declare function checkMarkdown(md: string): {
     error: string;
 };
 export interface DisplayInPaneOpts {
-    /** Pass watch so the pane live-updates on file edits. Default true. */
-    watch?: boolean;
     /** Open in a new tmux window instead of splitting the current one. */
     newWindow?: boolean;
 }

package/dist/render/termrender.js

@@ -263,9 +263,8 @@ export function displayInPane(path, opts = {}) {
     ensureRenderer();
     if (rendererState !== 'ready')
         return {};
-    const args = ['pane', 'open', path];
-    if (opts.watch !== false)
-        args.push('--watch');
+    // Always watch: a displayed pane is a live view of the file by definition.
+    const args = ['pane', 'open', path, '--watch'];
     args.push('--window', opts.newWindow ? 'new' : 'split');
     const result = spawnSync(VENV_BIN, args, {
         encoding: 'utf-8',

package/dist/surfaces/display.js

@@ -10,10 +10,10 @@ export function countPanesInCurrentWindow() {
     return result.stdout.split('\n').filter((line) => line.trim() !== '').length;
 }
 export function display(path, opts) {
-    const watch = opts?.watch !== false;
     const window = (opts?.window === 'split' || opts?.window === 'new') ? opts.window : 'auto';
     const maxPanes = (opts?.maxPanes !== undefined && opts.maxPanes > 0) ? opts.maxPanes : 3;
     const newWindow = window === 'new' ||
         (window === 'auto' && countPanesInCurrentWindow() >= maxPanes);
-    return displayInPane(path, { watch, newWindow });
+    // The pane always watches the file — displayed docs are live by definition.
+    return displayInPane(path, { newWindow });
 }

package/dist/types.d.ts

@@ -146,10 +146,9 @@ export interface InboxItem {
     blockedSince: string;
     source?: DeckSource;
 }
-/** Options for `display()` — the live-watch tmux pane surface. */
+/** Options for `display()` — the live-watch tmux pane surface. The pane always
+ *  watches the file and live-updates on edits; there is no non-watched mode. */
 export interface DisplayOpts {
-    /** Pass `--watch` so the pane live-updates on edits. Default true. */
-    watch?: boolean;
     /** `'auto'` (default) splits until the pane budget, then opens a new window. */
     window?: 'auto' | 'split' | 'new';
     /** Pane budget per window before `'auto'` opens a new window. Default 3. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crouton-kit/humanloop",
-  "version": "0.3.10",
+  "version": "0.3.12",
   "description": "Human-in-the-loop decision TUI — agents write questions, humans answer them",
   "type": "module",
   "main": "dist/index.js",