@north-light/crouter 0.3.249 → 0.3.251

package/dist/pi-extensions/canvas-context-intro.js

@@ -11,26 +11,16 @@
 // stamp and receives a new baseline. The preference snapshot and persona
 // acknowledgment persist only after Pi materializes that baseline.
 //
-// COLLAPSED BY DEFAULT: a `registerMessageRenderer` keyed to our customType
-// renders the block as a single one-line stub; the full body only appears when
-// the user expands tool output (Ctrl+O / `app.tools.expand`). pi drives this via
-// `CustomMessageComponent.setExpanded(toolOutputExpanded)`, so the same toggle
-// that expands tool results expands the bearings. The renderer returns a plain
-// object satisfying pi's structural `Component` interface ({ render, invalidate })
-// — no pi-tui class needed. The LLM always sees the full `content` regardless of
-// how it renders; the renderer is display-only.
-//
 // Plain TS-with-types — no imports from @earendil-works/* so this compiles inside
 // crouter's own tsc build without a dep on the pi packages.
 import { envNodeId } from '../shared/env.js';
-import { CONTEXT_INTRO_CUSTOM_TYPE, formatCard, parseCard } from '../shared/generated-context.js';
+import { CONTEXT_INTRO_CUSTOM_TYPE, formatCard } from '../shared/generated-context.js';
 import { brokerExtensionState } from '../core/runtime/broker/daemon-ops.js';
 import { buildContextBearingsFromState, buildForkBearingsFromState, buildProjectContextBlockForBroker, renderPreferencesFromState, } from '../core/runtime/broker-extension-render.js';
 import { acknowledgePersonaBaseline } from '../core/runtime/broker-persona-guidance.js';
 import { situationalContextEnvelope } from '../core/runtime/situational-context.js';
 import { clearContextExposureState, cloneTranscriptExposureState, emptyContextExposureState, exposureTarget, freezePreferenceSnapshot, hasTranscriptExposure, loadContextExposureState, replaceContextExposureState, saveContextExposureState, sharedContextExposureState, } from '../core/substrate/injected-store.js';
 import { clearSessionCache } from '../core/substrate/session-cache.js';
-import { truncateToWidth } from './truncate.js';
 /** The `customType` stamped on the injected session message. Used both to write
  *  the entry and to detect it on resume (the idempotency guard). Defined beside
  *  the block builder in `core/runtime/bearings.ts` because the warm-pool claim's
@@ -49,16 +39,7 @@ export async function buildForkContextIntro(nodeId) {
     const state = await brokerExtensionState(nodeId);
     return buildForkBearingsFromState(state, situationalContextEnvelope(nodeId) ?? '');
 }
-// Collapsed-by-default rendering
-/** Pull the plain text out of a custom message's content (string or blocks). */
-function messageText(message) {
-    if (typeof message.content === 'string')
-        return message.content;
-    return message.content
-        .filter((c) => c.type === 'text' && typeof c.text === 'string')
-        .map((c) => c.text)
-        .join('\n');
-}
+// Message extraction
 /** Plain text of a session entry's content (string or text blocks), '' when
  *  absent. Used by the idempotency guard to tell OUR own injected bearings
  *  (which name our node id) from a SOURCE's bearings copied in by `--fork-from`. */
@@ -74,62 +55,9 @@ function entryText(e) {
     }
     return '';
 }
-function activeBranch(ctx) {
-    return typeof ctx.sessionManager.getBranch === 'function'
-        ? ctx.sessionManager.getBranch()
-        : ctx.sessionManager.getEntries();
-}
-/** Hard-wrap a single logical line to `width` columns (content carries no ANSI).
- *  Code-point aware so wide-string slicing never splits a surrogate pair; the
- *  bearings prose is plain text, so code-point count == visible columns. */
-function wrapLine(line, width) {
-    if (width <= 0)
-        return [''];
-    const chars = Array.from(line);
-    if (chars.length <= width)
-        return [line];
-    const out = [];
-    for (let i = 0; i < chars.length; i += width)
-        out.push(chars.slice(i, i + width).join(''));
-    return out;
-}
-/**
- * Renderer for `crtr-context` messages. Collapsed (default) shows a one-line
- * stub; expanded (Ctrl+O) shows the label + full body. Returns a plain object
- * matching pi's structural `Component` interface — no pi-tui import. Exported for
- * testing.
- */
-export function renderContextMessage(message, options, theme) {
-    const expanded = options?.expanded === true;
-    const paint = (color, text) => typeof theme?.fg === 'function' ? theme.fg(color, text) : text;
-    return {
-        render(width) {
-            const w = typeof width === 'number' && width > 0 ? width : 80;
-            if (!expanded) {
-                // Truncate BEFORE painting so the ANSI wrapper never inflates the
-                // measured width; an over-wide line aborts pi's entire TUI render.
-                const stub = `[${CONTEXT_INTRO_CUSTOM_TYPE}] orienting bearings — ctrl+o to expand`;
-                return [paint('dim', truncateToWidth(stub, w))];
-            }
-            const lines = [paint('customMessageLabel', truncateToWidth(`[${CONTEXT_INTRO_CUSTOM_TYPE}]`, w)), ''];
-            const body = parseCard({ role: 'custom', customType: message.customType, content: messageText(message) })?.body ?? messageText(message);
-            for (const raw of body.split('\n')) {
-                for (const wrapped of wrapLine(raw, w))
-                    lines.push(paint('customMessageText', wrapped));
-            }
-            return lines;
-        },
-        invalidate() {
-            /* stateless — nothing to clear */
-        },
-    };
-}
 // Extension
 /** Register new-context baseline assembly; a strict resume changes nothing. */
 export function registerCanvasContextIntro(pi) {
-    // Collapse the block to a one-liner until the user expands tool output (Ctrl+O).
-    // Harmless to register outside TUI mode (it's only consulted while rendering).
-    pi.registerMessageRenderer(CONTEXT_INTRO_CUSTOM_TYPE, renderContextMessage);
     pi.on('session_start', async (event, ctx) => {
         const nodeId = envNodeId();
         if (nodeId === undefined || nodeId.trim() === '')
@@ -150,7 +78,7 @@ export function registerCanvasContextIntro(pi) {
         }
         // The active branch, rather than the whole session file, is the context the
         // next turn sees. A new cycle therefore receives its own current baseline.
-        const contextEntries = activeBranch(ctx).filter((e) => e.type === 'custom_message' && e.customType === CONTEXT_INTRO_CUSTOM_TYPE);
+        const contextEntries = ctx.sessionManager.getBranch().filter((e) => e.type === 'custom_message' && e.customType === CONTEXT_INTRO_CUSTOM_TYPE);
         const ours = contextEntries.some((e) => e.details?.nodeId === nodeId || entryText(e).includes(nodeId));
         if (ours)
             return;
@@ -170,7 +98,7 @@ export function registerCanvasContextIntro(pi) {
             display: true,
             details: { nodeId },
         });
-        const delivered = activeBranch(ctx).some((entry) => entry.type === 'custom_message'
+        const delivered = ctx.sessionManager.getBranch().some((entry) => entry.type === 'custom_message'
             && entry.customType === CONTEXT_INTRO_CUSTOM_TYPE
             && entry.details?.nodeId === nodeId
             && entryText(entry) === messageContent);

package/dist/pi-extensions/canvas-inbox-watcher.js

@@ -10,7 +10,10 @@
 // Context sends never trigger a turn: the visible human delivery is the sole
 // trigger, so the agent cannot run on context alone before hearing the person.
 // A context-only batch keeps its wake by triggering on its LAST card while idle,
-// and rides the running turn while streaming.
+// and rides the running turn while streaming. A deferred-only idle batch stays
+// held until either durable mail wakes a turn or the broker prepends it to an
+// already-admitted live human prompt; that bridge still commits only at
+// agent_settled.
 import { envNodeId, envProfileId, envWatcherDebounceMs, envWatcherTickMs } from '../shared/env.js';
 import { coalesceBrokerInbox, entryCards, readBrokerCanceledEntryIds, readBrokerCursor, readBrokerInboxSince, reportRefNodeId, } from '../core/runtime/broker/inbox.js';
 import { advanceBrokerInboxCursor, brokerExtensionState } from '../core/runtime/broker/daemon-ops.js';
@@ -20,6 +23,7 @@ import { errorClassFromError } from '../core/events/errors.js';
 import { operationIdContext } from '../core/events/operation-id.js';
 import { situationalContextEnvelope, SITUATIONAL_CONTEXT_CUSTOM_TYPE } from '../core/runtime/situational-context.js';
 import { isProfilePaused } from '../core/profiles/manifest.js';
+import { HELD_DEFERRED_INBOX_PROMPT_JOIN, } from '../core/runtime/broker/held-deferred-inbox.js';
 const MAX_PENDING_HANDOFFS = 64;
 const MAX_SOURCE_OPERATION_IDS = 16;
 let currentWatcher;
@@ -188,6 +192,7 @@ class CanvasInboxWatcher {
     lastArrival = 0;
     pendingHandoffs = [];
     pendingCommit;
+    promptJoinInFlight = false;
     seeded = false;
     disposed = false;
     disposalReason;
@@ -250,7 +255,7 @@ class CanvasInboxWatcher {
                 // every queued continuation has drained, so hasPendingMessages() must
                 // not veto the commit here. Await crtrd before changing the in-memory
                 // durable cursor; a failed commit remains replayable after process exit.
-                const result = await this.settle(nodeId, ctx, false);
+                const result = await this.settle(nodeId, ctx, false, true);
                 if (result === 'refresh_held')
                     this.dispose('refresh', false);
             }
@@ -383,6 +388,7 @@ class CanvasInboxWatcher {
             this.reportNodes.clear();
             this.reportNodesAsked.clear();
             this.pendingCommit = undefined;
+            this.promptJoinInFlight = false;
             this.nodeId = undefined;
             this.lastCtx = undefined;
             this.lastArrival = 0;
@@ -531,6 +537,8 @@ class CanvasInboxWatcher {
             this.retryPendingCommitOnTick(nodeId);
             return;
         }
+        if (this.promptJoinInFlight)
+            return;
         // A paused profile is inert: read nothing, send nothing, leave the cursor
         // where it is, so every queued entry — critical included, since aborting the
         // live turn is exactly the punch-through pause forbids — is still there to
@@ -599,6 +607,9 @@ class CanvasInboxWatcher {
         const hiddenIds = new Set(hiddenEntries.map((entry) => entry.entry_id));
         const visibleIds = new Set(visibleEntries.map((entry) => entry.entry_id));
         const routedEntries = entries.filter((entry) => hiddenIds.has(entry.entry_id) || visibleIds.has(entry.entry_id));
+        // Deferred-only idle mail remains in this buffer until a non-deferred inbox
+        // entry starts delivery, or a live human prompt claims it through
+        // prependHeldDeferredInbox(). Neither path wakes the node on its own.
         const deferredHold = this.isIdle()
             && routedEntries.length > 0
             && routedEntries.every((entry) => entry.tier === 'deferred');
@@ -826,6 +837,83 @@ class CanvasInboxWatcher {
         this.requeueFromBatch(batch, execution.requeueEntryIds);
         return 'attempted';
     }
+    /** Claim the deferred-only idle batch for the human prompt already admitted
+     * by the broker. Each rendered delivery is persisted before that prompt, but
+     * no cursor may advance until the prompt's agent_settled event proves the
+     * turn consumed it. */
+    async prependHeldDeferredInbox(session) {
+        if (!this.canMutate() || this.nodeId === undefined || profilePaused())
+            return;
+        const plan = this.ordinaryPlan();
+        if (!plan.deferredHold)
+            return;
+        const deliveries = plan.visibleEntries.length === 0
+            ? []
+            : this.digest(plan.visibleEntries, 'poll');
+        const handoffCount = Number(plan.hiddenEntries.length > 0) + deliveries.length;
+        if (this.pendingHandoffs.length + handoffCount > MAX_PENDING_HANDOFFS)
+            return;
+        const batch = [...this.buffer];
+        this.promptJoinInFlight = true;
+        try {
+            if (plan.hiddenEntries.length > 0) {
+                await this.sendPromptJoinDelivery(session, 'hidden', plan.hiddenEntries, this.contextCards(this.nodeId, plan.hiddenEntries));
+            }
+            for (const delivery of deliveries) {
+                await this.sendPromptJoinDelivery(session, 'visible', delivery.entries, [...delivery.cards, delivery.text]);
+            }
+            if (!this.canMutate())
+                return;
+            this.buffer.splice(0, batch.length);
+        }
+        finally {
+            this.promptJoinInFlight = false;
+        }
+    }
+    async sendPromptJoinDelivery(session, channel, entries, messages) {
+        let facts;
+        try {
+            facts = deliveryFacts(entries, channel);
+        }
+        catch (error) {
+            this.raiseReadFatal('poll', error);
+        }
+        let operationId;
+        try {
+            await operationIdContext.fresh(async (freshOperationId) => {
+                operationId = freshOperationId;
+                emitBestEffort({
+                    level: 'info',
+                    event: 'inbox.delivery.started',
+                    operation_id: freshOperationId,
+                    fields: deliveryFields(facts),
+                });
+                for (const content of messages) {
+                    await session.sendCustomMessage({
+                        customType: SITUATIONAL_CONTEXT_CUSTOM_TYPE,
+                        content,
+                        display: true,
+                    });
+                }
+            });
+        }
+        catch (error) {
+            if (operationId === undefined)
+                this.raiseReadFatal('poll', error);
+            emitDeliveryFailure(operationId, facts, 'send', error);
+            throw error;
+        }
+        if (operationId === undefined) {
+            this.raiseReadFatal('poll', new Error(`${channel} prompt-join delivery returned without an operation id`));
+        }
+        const handoff = { operationId, ...facts, settleAtAgentSettled: true };
+        if (!this.canMutate()) {
+            if (this.disposed && this.disposalReason !== undefined)
+                emitDeliveryAbandoned(handoff, this.disposalReason);
+            return;
+        }
+        this.pendingHandoffs.push(handoff);
+    }
     coveredEntryIds(channel) {
         const covered = new Set();
         for (const handoff of this.pendingHandoffs) {
@@ -883,7 +971,7 @@ class CanvasInboxWatcher {
             emitDeliveryCompleted(handoff);
         return 'settled';
     }
-    async settle(nodeId, ctx, holdPendingMessages) {
+    async settle(nodeId, ctx, holdPendingMessages, atAgentSettled = false) {
         if (holdPendingMessages) {
             try {
                 if (ctx?.hasPendingMessages?.() === true)
@@ -903,9 +991,17 @@ class CanvasInboxWatcher {
             for (const handoff of alreadyDurable)
                 emitDeliveryCompleted(handoff);
         }
+        const agentSettledBlock = atAgentSettled
+            ? undefined
+            : this.pendingHandoffs
+                .filter((handoff) => handoff.settleAtAgentSettled === true)
+                .map((handoff) => physical.throughIndexes.get(handoff))
+                .reduce((first, index) => first === undefined ? index : Math.min(first, index), undefined);
         const eligible = this.pendingHandoffs.filter((handoff) => {
             const throughIndex = physical.throughIndexes.get(handoff);
-            return physical.blockedIndex === undefined || throughIndex < physical.blockedIndex;
+            return (handoff.settleAtAgentSettled !== true || atAgentSettled)
+                && (physical.blockedIndex === undefined || throughIndex < physical.blockedIndex)
+                && (agentSettledBlock === undefined || throughIndex < agentSettledBlock);
         });
         if (eligible.length === 0)
             return 'settled';
@@ -1006,6 +1102,11 @@ function installWatcher(pi, cadence) {
     currentWatcher?.dispose('reload', false);
     const watcher = new CanvasInboxWatcher(pi, cadence, ++nextGeneration);
     currentWatcher = watcher;
+    // Pi loads this extension through Jiti while the broker driver is native ESM,
+    // so their module-level singletons differ. Register the bound watcher on the
+    // process-global key that the broker reads immediately before a human prompt.
+    const promptJoin = (session) => watcher.prependHeldDeferredInbox(session);
+    globalThis[HELD_DEFERRED_INBOX_PROMPT_JOIN] = promptJoin;
     try {
         watcher.start();
     }

package/dist/pi-extensions/canvas-review-boundary.d.ts

@@ -7,8 +7,9 @@ interface SessionEntryLike {
 }
 interface SessionStartCtxLike {
     sessionManager: {
-        getEntries: () => SessionEntryLike[];
-        getBranch?: (fromId?: string) => SessionEntryLike[];
+        /** Required by pi's `ReadonlySessionManager`: the active branch, which is
+         * the context the next turn actually sees. */
+        getBranch: (fromId?: string) => SessionEntryLike[];
     };
 }
 interface CustomMessageLike {
@@ -25,35 +26,13 @@ interface CustomMessageLike {
         kind: 'review' | 'page_feedback';
     };
 }
-interface RenderedMessageLike {
-    customType: string;
-    content: string | Array<{
-        type: string;
-        text?: string;
-    }>;
-}
-interface ComponentLike {
-    render: (width: number) => string[];
-    invalidate: () => void;
-}
-interface ThemeLike {
-    fg?: (color: string, text: string) => string;
-}
 interface PiLike {
     on: (event: 'session_start', handler: (event: unknown, ctx: SessionStartCtxLike) => void | Promise<void>) => void;
     sendMessage: (message: CustomMessageLike, options?: {
         deliverAs?: string;
         triggerTurn?: boolean;
     }) => void;
-    registerMessageRenderer: (customType: string, renderer: (message: RenderedMessageLike, options: {
-        expanded?: boolean;
-    }, theme: ThemeLike) => ComponentLike | undefined) => void;
 }
-/** Render the marker as a single compact divider; its full content remains in
- * the message list for the model and generated-context presenters. */
-export declare function renderReviewBoundary(message: RenderedMessageLike, options: {
-    expanded?: boolean;
-}, theme: ThemeLike): ComponentLike;
 /**
  * Register the review boundary marker. Companion nodes receive one boundary
  * marker on session_start that separates inherited context from the visible

package/dist/pi-extensions/canvas-review-boundary.js

@@ -7,30 +7,7 @@
 import { envNodeId } from '../shared/env.js';
 import { brokerExtensionState } from '../core/runtime/broker/daemon-ops.js';
 import { isReviewBoundary, REVIEW_BOUNDARY_CUSTOM_TYPE } from '../core/runtime/session-visibility.js';
-import { formatCard, parseCard } from '../shared/generated-context.js';
-import { truncateToWidth } from './truncate.js';
-// Collapsed-by-default rendering
-/** Render the marker as a single compact divider; its full content remains in
- * the message list for the model and generated-context presenters. */
-export function renderReviewBoundary(message, options, theme) {
-    const paint = (color, text) => typeof theme?.fg === 'function' ? theme.fg(color, text) : text;
-    const text = typeof message.content === 'string'
-        ? message.content
-        : message.content.filter((block) => block.type === 'text' && typeof block.text === 'string').map((block) => block.text).join('\n');
-    const body = parseCard({ role: 'custom', customType: message.customType, content: text })?.body ?? text;
-    return {
-        render(width) {
-            const w = typeof width === 'number' && width > 0 ? width : 80;
-            const divider = paint('dim', truncateToWidth('[review boundary] earlier conversation is not shown', w));
-            if (options?.expanded !== true)
-                return [divider];
-            return [divider, '', ...body.split('\n').map((line) => paint('customMessageText', truncateToWidth(line, w)))];
-        },
-        invalidate() {
-            /* stateless — nothing to clear */
-        },
-    };
-}
+import { formatCard } from '../shared/generated-context.js';
 // Extension
 /**
  * Register the review boundary marker. Companion nodes receive one boundary
@@ -38,7 +15,6 @@ export function renderReviewBoundary(message, options, theme) {
  * transcript. Ordinary nodes get nothing.
  */
 export function registerCanvasReviewBoundary(pi) {
-    pi.registerMessageRenderer(REVIEW_BOUNDARY_CUSTOM_TYPE, renderReviewBoundary);
     pi.on('session_start', async (_event, ctx) => {
         const nodeId = envNodeId();
         if (!nodeId || nodeId.trim() === '')
@@ -54,10 +30,9 @@ export function registerCanvasReviewBoundary(pi) {
             return;
         // The active branch, not the whole session file, is the context the next
         // turn sees. Check for an existing boundary marker on this branch.
-        const scan = typeof ctx.sessionManager.getBranch === 'function'
-            ? ctx.sessionManager.getBranch()
-            : ctx.sessionManager.getEntries();
-        const alreadyMarked = scan.some((entry) => isReviewBoundary(entry, node.review_binding?.review_id));
+        const alreadyMarked = ctx.sessionManager
+            .getBranch()
+            .some((entry) => isReviewBoundary(entry, node.review_binding?.review_id));
         if (alreadyMarked)
             return;
         const binding = node.review_binding;

package/dist/pi-extensions/canvas-stophook.js

@@ -94,12 +94,7 @@ function lastAssistantMessage(messages) {
  * Pi-owned fact; crtrd compares it with the node's daemon-owned review binding. */
 function currentReviewBoundaryIds(ctx) {
     try {
-        const manager = ctx?.sessionManager;
-        const entries = typeof manager?.getBranch === 'function'
-            ? manager.getBranch()
-            : typeof manager?.getEntries === 'function'
-                ? manager.getEntries()
-                : [];
+        const entries = ctx?.sessionManager?.getBranch();
         if (!Array.isArray(entries))
             return [];
         const ids = new Set();

package/dist/shared/birth-announcement.d.ts

@@ -0,0 +1,12 @@
+/** The entry marker keeps delivery-time rendering exclusive to birth notices. */
+export declare const BIRTH_ANNOUNCEMENT_MARKER = "crtr.birth-announcement.v1";
+export declare const BIRTH_ANNOUNCEMENT_AGE_TOKEN = "[[CRTR_BIRTH_ANNOUNCEMENT_AGE]]";
+export declare function birthAnnouncementBody(child: {
+    name: string;
+    nodeId: string;
+    kind: string;
+    creator: string;
+}): string;
+export declare function birthAnnouncementAge(createdAt: string, now?: number): string;
+/** Return a birth notice's body rendered at delivery, or null for every other entry. */
+export declare function renderBirthAnnouncementBody(data: Record<string, unknown> | undefined, createdAt: string, now?: number): string | null;

package/dist/shared/birth-announcement.js

@@ -0,0 +1,25 @@
+/** The entry marker keeps delivery-time rendering exclusive to birth notices. */
+export const BIRTH_ANNOUNCEMENT_MARKER = 'crtr.birth-announcement.v1';
+export const BIRTH_ANNOUNCEMENT_AGE_TOKEN = '[[CRTR_BIRTH_ANNOUNCEMENT_AGE]]';
+export function birthAnnouncementBody(child) {
+    return `${child.name} (${child.nodeId}, ${child.kind}) was created under you by ${child.creator} ${BIRTH_ANNOUNCEMENT_AGE_TOKEN} ago. For your awareness only — no response or action is needed, and no need to mention it unless asked. Treat its future reports as background you already know about; investigate only if something genuinely needs you.`;
+}
+export function birthAnnouncementAge(createdAt, now = Date.now()) {
+    const elapsed = Math.max(0, now - Date.parse(createdAt));
+    if (elapsed < 60_000)
+        return 'moments';
+    const minutes = Math.floor(elapsed / 60_000);
+    if (minutes < 60)
+        return `${minutes} minute${minutes === 1 ? '' : 's'}`;
+    const hours = Math.floor(elapsed / 3_600_000);
+    if (hours < 48)
+        return `${hours} hour${hours === 1 ? '' : 's'}`;
+    const days = Math.floor(elapsed / 86_400_000);
+    return `${days} day${days === 1 ? '' : 's'}`;
+}
+/** Return a birth notice's body rendered at delivery, or null for every other entry. */
+export function renderBirthAnnouncementBody(data, createdAt, now = Date.now()) {
+    if (data?.['birth_announcement'] !== BIRTH_ANNOUNCEMENT_MARKER || typeof data['body'] !== 'string')
+        return null;
+    return data['body'].replace(BIRTH_ANNOUNCEMENT_AGE_TOKEN, birthAnnouncementAge(createdAt, now));
+}

package/dist/shared/generated-context.d.ts

@@ -10,10 +10,14 @@ export declare const REVIEW_BOUNDARY_CUSTOM_TYPE = "crtr-review-boundary";
 export declare const STALL_REPROMPT: string;
 /** The daemon's parking mandate: the last turn of a conversation the unattended
  *  clock is concluding. Delivered live, wrapped in a `park` runtime card. It
- *  shares a CONTRACT with `node yield`'s pre-invocation guide (roadmap current,
- *  short and shrinking; context dir for in-progress material; memory only for
- *  gated permanent lessons) but not a string: yield is read by an agent choosing
- *  to refresh, this by an agent being told to conclude. */
+ *  governs both the node's durable inheritance and reader-facing output:
+ *  one update for subscribers and history, then a goodbye that does not narrate
+ *  the parking.
+ *
+ *  The durable inheritance shares a CONTRACT with `node yield`'s pre-invocation
+ *  guide (roadmap current, short and shrinking; context dir for in-progress
+ *  material; memory only for gated permanent lessons) but not a string: yield is
+ *  read by an agent choosing to refresh, this by an agent being told to conclude. */
 export declare const PARK_SUMMARY_PROMPT: string;
 /** Static recovery prompts shared by the broker producer and display classifier. */
 export declare const AUTH_FAULT_RECOVERY_BODY = "Provider credentials were just updated (a new login landed). Your previous turn stopped on a provider authentication failure. Continue from where you left off and retry the work that failed.";

package/dist/shared/generated-context.js

@@ -15,15 +15,21 @@ export const STALL_REPROMPT = "You've stopped but you're not waiting on anyone a
     "Pipe the result to `crtr push final` through a single-quoted heredoc if the work is done, or use `crtr human send` if you are blocked or need the user.";
 /** The daemon's parking mandate: the last turn of a conversation the unattended
  *  clock is concluding. Delivered live, wrapped in a `park` runtime card. It
- *  shares a CONTRACT with `node yield`'s pre-invocation guide (roadmap current,
- *  short and shrinking; context dir for in-progress material; memory only for
- *  gated permanent lessons) but not a string: yield is read by an agent choosing
- *  to refresh, this by an agent being told to conclude. */
-export const PARK_SUMMARY_PROMPT = 'This conversation has been idle with nothing waiting on it, so it is being concluded. This is your last turn — do these four things now, then stop.\n\n'
-    + '1. Bring your roadmap current. It lives at `$CRTR_CONTEXT_DIR/roadmap.md`, and it is the document a fresh cycle reads to know where things stand: what was done, what is still open, and what someone picking this up needs. Write one now if you never had one. Keep it short and shrinking — strategy and present state only, deleting completed items rather than marking them done.\n\n'
-    + '2. Save anything else worth keeping. In-progress task material — what has happened, identifiers, in-flight state — goes to one or more files in your context directory. A permanent lesson worth remembering indefinitely goes to node memory (`crtr memory write -h`), gated deliberately: transcript state does not belong in memory.\n\n'
-    + '3. Push one regular report to your subscribers summarizing where things stand: `crtr push update`. NOT `crtr push final` — this concludes the conversation, it does not finish a mandate.\n\n'
-    + '4. Stop. A later message reopens you on a fresh context window grounded in your goal and that roadmap, so what you leave behind now is what you get back.';
+ *  governs both the node's durable inheritance and reader-facing output:
+ *  one update for subscribers and history, then a goodbye that does not narrate
+ *  the parking.
+ *
+ *  The durable inheritance shares a CONTRACT with `node yield`'s pre-invocation
+ *  guide (roadmap current, short and shrinking; context dir for in-progress
+ *  material; memory only for gated permanent lessons) but not a string: yield is
+ *  read by an agent choosing to refresh, this by an agent being told to conclude. */
+export const PARK_SUMMARY_PROMPT = 'This conversation has been idle with nothing left to wake it, so it is being concluded. This is your last turn. Use it to leave a trustworthy inheritance, not to restart or broaden the work. Do these six things now, then stop.\n\n'
+    + '1. Establish current truth. Check only state that may have changed outside the transcript and matters to resuming—such as the working tree, a remote run, or an external decision. Do not start new work; perform only a quick check needed to avoid recording an unverified claim. If no mandate or work ever began, say that plainly and keep every artifact minimal.\n\n'
+    + '2. Rewrite `$CRTR_CONTEXT_DIR/roadmap.md` for a fresh context window. This is the only handoff document a later fresh cycle receives in full. Preserve the current goal and exit criteria when they still apply, then state the present outcome; what remains or is blocked; decisions or questions still open; exact recovery handles for in-flight state; and the first safe move on return. Keep strategy and present state, not a transcript recap. Delete stale and completed steps instead of marking them done; the roadmap should stay short and shrink. Write a minimal one now if none exists.\n\n'
+    + '3. Put supporting material in your context directory only when the roadmap would become bulky without it. Rewrite existing living documents rather than leave superseded versions. Name every supporting file the next cycle must read from the roadmap and say what it is for—the revive shows filenames but does not inject their contents. Task state, identifiers, and recovery detail belong here, not in memory.\n\n'
+    + '4. Use memory only for a non-obvious, reusable lesson that should survive this task and is not already recorded. Read `crtr memory write -h`, find before writing, and choose the narrowest scope that will reach the next agent who needs it. Do not put a conversation recap, task status, recovery handles, or facts already captured in code or docs into memory.\n\n'
+    + '5. Push exactly one regular update with `crtr push update --tier deferred`, never `crtr push final`. Write it for subscribers and history, not as a second roadmap. Its first line must stand alone as the current outcome, blocker, or decision that matters; then include only unfinished work, a needed decision, and concrete handles a subscriber may need. This concludes the conversation; it does not finish the mandate.\n\n'
+    + '6. End with a short sign-off to the reader in second person: say you are putting your notes in order and pausing here until they come back, and mention anything genuinely worth their attention, such as unfinished work or an open question. Keep all visible text this turn—including the update\'s first line—about their work, not crouter\'s machinery: do not mention roadmap or context paths, filing a report, parking, idling, residency, or node ids. Then stop. A later message reopens you on a fresh context window grounded in your goal and roadmap, so the inheritance you leave now is what you get back.';
 /** Static recovery prompts shared by the broker producer and display classifier. */
 export const AUTH_FAULT_RECOVERY_BODY = 'Provider credentials were just updated (a new login landed). Your previous turn stopped on a provider authentication failure. Continue from where you left off and retry the work that failed.';
 export const CONNECTION_FAULT_RECOVERY_BODY = 'The network connection is back online. Your previous turn stopped on a connection error (the network was down). Continue from where you left off and retry the work that failed.';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/crouter",
-  "version": "0.3.249",
+  "version": "0.3.251",
   "description": "crtr — agent runtime with memory, plugins, and marketplaces",
   "type": "module",
   "main": "dist/index.js",
@@ -83,10 +83,10 @@
     "dev": "tsx --conditions=crtr-src src/cli.ts",
     "link": "npm link",
     "prepublishOnly": "npm run build",
-    "test": "CRTR_NO_DAEMON_AUTOSTART=1 node --conditions=crtr-src --import tsx/esm --test --test-force-exit --test-concurrency=$(node -p 'Math.max(4, require(`node:os`).availableParallelism() - 1)') --test-timeout=10000 'src/**/__tests__/*.test.ts'",
-    "test:integration": "CRTR_NO_DAEMON_AUTOSTART=1 node --conditions=crtr-src --import tsx/esm --test --test-concurrency=$(node -p 'Math.min(8, Math.max(2, require(`node:os`).availableParallelism() - 1))') --test-timeout=60000 'src/**/__tests__/integration/*.test.ts'",
+    "test": "CRTR_NO_DAEMON_AUTOSTART=1 node --conditions=crtr-src --import tsx/esm --import ./scripts/test-env-scrub.mjs --test --test-force-exit --test-concurrency=$(node -p 'Math.max(4, require(`node:os`).availableParallelism() - 1)') --test-timeout=10000 'src/**/__tests__/*.test.ts'",
+    "test:integration": "CRTR_NO_DAEMON_AUTOSTART=1 node --conditions=crtr-src --import tsx/esm --import ./scripts/test-env-scrub.mjs --test --test-concurrency=$(node -p 'Math.min(8, Math.max(2, require(`node:os`).availableParallelism() - 1))') --test-timeout=60000 'src/**/__tests__/integration/*.test.ts'",
     "test:seam": "npm run build && npm run test:seam:built",
-    "test:seam:built": "CRTR_NO_DAEMON_AUTOSTART=1 node --test --test-concurrency=4 --test-timeout=180000 'dist/**/__tests__/seam/*.test.js'",
+    "test:seam:built": "CRTR_NO_DAEMON_AUTOSTART=1 node --import ./scripts/test-env-scrub.mjs --test --test-concurrency=4 --test-timeout=180000 'dist/**/__tests__/seam/*.test.js'",
     "test:all": "npm test && npm run test:integration && npm run test:seam"
   },
   "overrides": {

package/runtime.lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@north-light/crouter",
-  "version": "0.3.249",
+  "version": "0.3.251",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@north-light/crouter",
-      "version": "0.3.249",
+      "version": "0.3.251",
       "hasInstallScript": true,
       "license": "MIT",
       "dependencies": {