@crouton-kit/humanloop 0.3.13 → 0.3.14

package/dist/api.js

@@ -4,7 +4,7 @@ import { join } from 'node:path';
 import { resolveInteractionDir } from './tui/app.js';
 import { scanInbox } from './inbox/scan.js';
 import { pickFromInbox } from './inbox/tui.js';
-import { deckPath, atomicWriteJson, readJson } from './inbox/convention.js';
+import { deckPath, atomicWriteJson, readJson, stampCanvasNode } 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';
@@ -61,6 +61,7 @@ function buildSummary(deck, responses) {
 export async function ask(deck, opts = {}) {
     const dir = opts.dir ?? managedDir();
     mkdirSync(dir, { recursive: true });
+    stampCanvasNode(deck);
     atomicWriteJson(deckPath(dir), deck);
     const { responses, completedAt, responsePath, deck: answeredDeck } = await resolveInteractionDir(dir, deck, {
         sessionId: opts.sessionId,

package/dist/cli.js

@@ -11,7 +11,7 @@ import { ask, inbox } from './api.js';
 import { display } from './surfaces/display.js';
 import { renderMarkdown, checkMarkdown } from './render/termrender.js';
 import { scanInbox } from './inbox/scan.js';
-import { deckPath, atomicWriteJson, readJson, responsePath, } from './inbox/convention.js';
+import { deckPath, atomicWriteJson, readJson, responsePath, stampCanvasNode, } from './inbox/convention.js';
 // ── Version ───────────────────────────────────────────────────────────────────
 const HL_VERSION = '0.2.1';
 function emitError(err, exitCode = 1) {
@@ -372,6 +372,7 @@ deckCmd
     }
     const dir = input.dir ? resolve(input.dir) : mkdtempSync(join(tmpdir(), 'hl-ix-'));
     mkdirSync(dir, { recursive: true });
+    stampCanvasNode(deck);
     atomicWriteJson(deckPath(dir), deck);
     const jobId = basename(dir);
     const visuals = input.visuals !== false;

package/dist/inbox/convention.d.ts

@@ -1,4 +1,4 @@
-import type { InteractionResponse } from '../types.js';
+import type { Deck, InteractionResponse } from '../types.js';
 export declare function deckPath(dir: string): string;
 export declare function responsePath(dir: string): string;
 export declare function progressPath(dir: string): string;
@@ -10,6 +10,15 @@ export declare function interactionState(dir: string): InteractionState;
 export declare function isResolved(dir: string): boolean;
 /** Returns true if a live resolver owns this dir (progress.json mtime < 300s). */
 export declare function isClaimed(dir: string): boolean;
+/**
+ * Stamp the originating canvas node id onto a deck's `source` so per-node
+ * attention scoping (crouter's nav chrome) can attribute the ask to the node
+ * that raised it rather than every sibling node sharing the same cwd.
+ *
+ * No-op when not inside a canvas node (CRTR_NODE_ID unset) or when the deck
+ * already carries a nodeId. Mutates `deck` in place.
+ */
+export declare function stampCanvasNode(deck: Deck): void;
 export declare function atomicWriteJson(path: string, value: unknown): void;
 export declare function readJson<T>(path: string): T | null;
 export declare function writeResponse(dir: string, responses: InteractionResponse[], completedAt: string): string;

package/dist/inbox/convention.js

@@ -47,6 +47,23 @@ export function isClaimed(dir) {
         return false;
     }
 }
+// ── Canvas-node attribution ─────────────────────────────────────────
+/**
+ * Stamp the originating canvas node id onto a deck's `source` so per-node
+ * attention scoping (crouter's nav chrome) can attribute the ask to the node
+ * that raised it rather than every sibling node sharing the same cwd.
+ *
+ * No-op when not inside a canvas node (CRTR_NODE_ID unset) or when the deck
+ * already carries a nodeId. Mutates `deck` in place.
+ */
+export function stampCanvasNode(deck) {
+    const id = process.env['CRTR_NODE_ID'];
+    if (id === undefined || id.trim() === '')
+        return;
+    if (deck.source?.nodeId != null && deck.source.nodeId !== '')
+        return;
+    deck.source = { ...(deck.source ?? {}), nodeId: id };
+}
 // ── Atomic I/O ────────────────────────────────────────────────────────────────
 export function atomicWriteJson(path, value) {
     const payload = JSON.stringify(value, null, 2);

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

@@ -18,6 +18,7 @@ export declare const deckSchema: z.ZodObject<{
         sessionName: z.ZodOptional<z.ZodString>;
         askedBy: z.ZodOptional<z.ZodString>;
         blockedSince: z.ZodOptional<z.ZodString>;
+        nodeId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     interactions: z.ZodArray<z.ZodObject<{
         id: z.ZodString;

package/dist/inbox/deck-schema.js

@@ -33,6 +33,7 @@ const deckSourceSchema = z.object({
     sessionName: z.string().optional(),
     askedBy: z.string().optional(),
     blockedSince: z.string().optional(),
+    nodeId: z.string().optional(),
 });
 export const deckSchema = z.object({
     title: z.string().optional(),

package/dist/types.d.ts

@@ -54,6 +54,10 @@ export interface DeckSource {
     sessionName?: string;
     askedBy?: string;
     blockedSince?: string;
+    /** Originating canvas node id (CRTR_NODE_ID) when the ask was raised inside
+     *  a crouter canvas node. Lets per-node attention scoping attribute the ask
+     *  to the node that raised it rather than every sibling sharing the cwd. */
+    nodeId?: string;
 }
 export interface Deck {
     title?: string;

package/package.json

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