@crouton-kit/humanloop 0.3.5 → 0.3.7

package/dist/api.js

@@ -6,6 +6,7 @@ import { scanInbox } from './inbox/scan.js';
 import { pickFromInbox } from './inbox/tui.js';
 import { deckPath, atomicWriteJson, readJson } from './inbox/convention.js';
 import { getTerminalSize } from './tui/terminal.js';
+import { approveDeck, notifyDeck } from './inbox/deck-factories.js';
 const RESPONSE_SCHEMA_ID = 'humanloop.response/v2';
 function managedDir() {
     return mkdtempSync(join(tmpdir(), 'hl-ix-'));
@@ -72,33 +73,13 @@ export async function ask(deck, opts = {}) {
 }
 /** Sugar: a single `kind:'validation'` Yes/No interaction. */
 export async function approve(title, opts = {}) {
-    const deck = {
-        interactions: [{
-                id: 'approve',
-                title,
-                ...(opts.subtitle !== undefined ? { subtitle: opts.subtitle } : {}),
-                ...(opts.body !== undefined ? { body: opts.body } : {}),
-                kind: 'validation',
-                options: [
-                    { id: 'yes', label: 'Yes' },
-                    { id: 'no', label: 'No' },
-                ],
-            }],
-    };
+    const deck = approveDeck(title, { subtitle: opts.subtitle, body: opts.body });
     const env = await ask(deck, { dir: opts.dir, sessionId: opts.sessionId });
     return env.responses[0]?.selectedOptionId === 'yes';
 }
 /** Sugar: a single `kind:'notify'` acknowledgement. */
 export async function notify(title, body) {
-    const deck = {
-        interactions: [{
-                id: 'notify',
-                title,
-                ...(body !== undefined ? { body } : {}),
-                kind: 'notify',
-                options: [{ id: 'ok', label: 'OK' }],
-            }],
-    };
+    const deck = notifyDeck(title, body !== undefined ? { body } : {});
     await ask(deck, {});
 }
 /**

package/dist/inbox/deck-factories.d.ts

@@ -0,0 +1,12 @@
+import type { Deck } from '../types.js';
+export interface ApproveDeckOpts {
+    subtitle?: string;
+    body?: string;
+}
+/** Build a validated Yes/No validation deck. id: 'approve', kind: 'validation'. */
+export declare function approveDeck(title: string, opts?: ApproveDeckOpts): Deck;
+export interface NotifyDeckOpts {
+    body?: string;
+}
+/** Build a validated single-option notify deck. id: 'notify', kind: 'notify'. */
+export declare function notifyDeck(title: string, opts?: NotifyDeckOpts): Deck;

package/dist/inbox/deck-factories.js

@@ -0,0 +1,29 @@
+import { validateDeck } from './deck-schema.js';
+/** Build a validated Yes/No validation deck. id: 'approve', kind: 'validation'. */
+export function approveDeck(title, opts = {}) {
+    return validateDeck({
+        interactions: [{
+                id: 'approve',
+                title,
+                ...(opts.subtitle !== undefined ? { subtitle: opts.subtitle } : {}),
+                ...(opts.body !== undefined ? { body: opts.body } : {}),
+                kind: 'validation',
+                options: [
+                    { id: 'yes', label: 'Yes' },
+                    { id: 'no', label: 'No' },
+                ],
+            }],
+    });
+}
+/** Build a validated single-option notify deck. id: 'notify', kind: 'notify'. */
+export function notifyDeck(title, opts = {}) {
+    return validateDeck({
+        interactions: [{
+                id: 'notify',
+                title,
+                ...(opts.body !== undefined ? { body: opts.body } : {}),
+                kind: 'notify',
+                options: [{ id: 'ok', label: 'OK' }],
+            }],
+    });
+}

package/dist/index.d.ts

@@ -8,6 +8,8 @@ export { display } from './surfaces/display.js';
 export { scanInbox } from './inbox/scan.js';
 export { renderMarkdown, checkMarkdown, ensureRenderer, isRendererReady, } from './render/termrender.js';
 export { parseDeck, validateDeck, deckSchema } from './inbox/deck-schema.js';
+export { approveDeck, notifyDeck } from './inbox/deck-factories.js';
+export type { ApproveDeckOpts, NotifyDeckOpts } from './inbox/deck-factories.js';
 export { deckPath, responsePath, progressPath, visualsDir, interactionState, isResolved, isClaimed, atomicWriteJson, readJson, writeResponse, writeProgress, clearProgress, } from './inbox/convention.js';
 export type { InteractionState } from './inbox/convention.js';
 export type { Interaction, InteractionOption, InteractionResponse, InteractionKind, Deck, DeckSource, MountedPanel, MountedPanelOpts, GenerateVisual, VisualBlock, FeedbackComment, FeedbackResult, ResolutionEnvelope, InboxItem, DisplayOpts, } from './types.js';

package/dist/index.js

@@ -11,5 +11,8 @@ export { scanInbox } from './inbox/scan.js';
 export { renderMarkdown, checkMarkdown, ensureRenderer, isRendererReady, } from './render/termrender.js';
 // Canonical deck schema + parsing/validation (consumers stop forking it).
 export { parseDeck, validateDeck, deckSchema } from './inbox/deck-schema.js';
+// Deck factories — pure builders for common deck shapes (sugar for SDK consumers
+// who want validated Yes/No or notify decks without inline construction).
+export { approveDeck, notifyDeck } from './inbox/deck-factories.js';
 // Interaction-directory convention helpers (§B) — names humanloop owns.
 export { deckPath, responsePath, progressPath, visualsDir, interactionState, isResolved, isClaimed, atomicWriteJson, readJson, writeResponse, writeProgress, clearProgress, } from './inbox/convention.js';

package/dist/render/termrender.js

@@ -97,11 +97,14 @@ export function ensureRenderer() {
         return;
     }
     try {
-        // Skip venv creation on drift (venv exists with wrong termrender version)
-        // — `uv pip install` into the existing venv replaces it in place. Only
-        // create when the venv directory is genuinely absent.
-        if (!existsSync(VENV_DIR)) {
-            execFileSync('uv', ['venv', VENV_DIR], { stdio: 'pipe', timeout: 60000 });
+        // (Re)create the venv whenever the interpreter is missing — covers both
+        // "directory absent" and "directory present but bin/python stripped"
+        // (seen in the wild when pnpm rebuilds/dedupes node_modules or uv rotates
+        // its managed Python store). `--clear` makes uv wipe any partial state
+        // rather than refusing on the existing dir. If the interpreter is intact,
+        // skip straight to `uv pip install` so version drift reuses the venv.
+        if (!existsSync(VENV_PYTHON)) {
+            execFileSync('uv', ['venv', '--clear', VENV_DIR], { stdio: 'pipe', timeout: 60000 });
         }
         execFileSync('uv', ['pip', 'install', '--python', VENV_PYTHON, `termrender==${TERMRENDER_VERSION}`], { stdio: 'pipe', timeout: 120000 });
     }
@@ -193,9 +196,8 @@ export function renderMarkdown(md, width) {
     ensureRenderer();
     if (rendererState === 'ready') {
         try {
-            const input = JSON.stringify({ source: md, width, color: true });
-            const out = execFileSync(VENV_BIN, ['doc', 'render'], {
-                input,
+            const out = execFileSync(VENV_BIN, ['doc', 'render', '--width', String(width), '--color', 'on'], {
+                input: md,
                 encoding: 'utf-8',
                 timeout: 5000,
                 stdio: ['pipe', 'pipe', 'pipe'],
@@ -221,9 +223,8 @@ export function checkMarkdown(md) {
     // plaintext later. Bricking deck validation here would be the wrong default.
     if (rendererState !== 'ready')
         return { ok: true };
-    const input = JSON.stringify({ source: md });
     const result = spawnSync(VENV_BIN, ['doc', 'check'], {
-        input,
+        input: md,
         encoding: 'utf-8',
         timeout: 5000,
     });
@@ -262,13 +263,11 @@ export function displayInPane(path, opts = {}) {
     ensureRenderer();
     if (rendererState !== 'ready')
         return {};
-    const input = JSON.stringify({
-        path,
-        watch: opts.watch !== false,
-        window: opts.newWindow ? 'new' : 'split',
-    });
-    const result = spawnSync(VENV_BIN, ['pane', 'open'], {
-        input,
+    const args = ['pane', 'open', path];
+    if (opts.watch !== false)
+        args.push('--watch');
+    args.push('--window', opts.newWindow ? 'new' : 'split');
+    const result = spawnSync(VENV_BIN, args, {
         encoding: 'utf-8',
         stdio: ['pipe', 'pipe', 'pipe'],
     });

package/dist/render/version.d.ts

@@ -1 +1 @@
-export declare const TERMRENDER_VERSION = "2.1.0";
+export declare const TERMRENDER_VERSION = "3.0.0";

package/dist/render/version.js

@@ -1 +1 @@
-export const TERMRENDER_VERSION = '2.1.0';
+export const TERMRENDER_VERSION = '3.0.0';

package/package.json

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