@crouton-kit/humanloop 0.3.6 → 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/package.json

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