@north-light/crouter 0.3.318 → 0.3.319

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

@@ -1,405 +1,11 @@
-// canvas-recap.ts — pi extension for pi-native canvas agent nodes.
-//
-// A per-node recap, drawn faintly immediately above the editor border. When a
-// node has had NO new message (user or assistant) for IDLE_MS (60s by default),
-// it runs a stripped-down headless call on the conversation's current working
-// model and pins one concise, wrapped briefing above the editor, so a developer
-// returning to the conversation sees where it left off at a glance. `/recap`
-// generates that briefing immediately and refreshes the original generated
-// editor title from a conversation-wide sample. A shown card remains pinned as
-// the conversation advances and is replaced only when a newer recap succeeds.
-//
-//   generation is keyed off MESSAGES, not turns-of-work:
-//     • user `input`, assistant `message_update`, and assistant `turn_end` events
-//       reset the idle clock and mark any shown recap stale.
-//     • a single low-rate timer (no busy-loop) checks elapsed-since-last-message
-//       and, on crossing IDLE_MS, replaces a missing or stale recap once.
-//
-//   Brief input = the FIRST 5 and MOST RECENT 5 visible user/assistant messages
-//   (literal text only — for review companions, only messages after their durable
-//   boundary are visible), plus the node's roadmap file when one exists. Tool calls,
-//   tool results, thinking blocks, and extension-injected custom messages are
-//   excluded (only `message` entries with role user/assistant, and only their
-//   `text` content blocks). While an assistant response is streaming, its latest
-//   `message_update` snapshot is appended because it is not yet in the persisted
-//   entries. Long messages are truncated per-message so the opening request is
-//   never crowded out by a recent wall of text.
-//
-//   Placement: key `crtr-recap`, placement `aboveEditor`.
-//
-//   Surface gating: shows in BOTH the in-pane pi TUI (mode 'tui') and the
-//   headless broker → attach/web viewers (mode 'rpc', setWidget broadcasts to
-//   all surfaces). It does NOT gate on mode === 'tui' (that would kill the
-//   headless+attach path). It NO-OPs only when ui/setWidget is unavailable, and
-//   harmlessly in a true one-shot `pi -p` (the unref'd timer never fires before
-//   the process exits, and naming-style one-shots load with --no-extensions).
-//
-// INERT when CRTR_NODE_ID is absent (a plain pi session or legacy job agent).
-//
-// 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, envRecapIdleMs } from '../shared/env.js';
-import { brokerExtensionState } from '../core/runtime/broker/daemon-ops.js';
-import { generateRecap } from '../core/runtime/recap.js';
-import { writeNodeRecap } from '../core/canvas/node-recap.js';
-import { isReviewBoundary } from '../core/runtime/session-visibility.js';
-import { editorLabelForBrokerNode } from '../core/runtime/broker-extension-render.js';
-import { generateAndCommitRecapName, readRoadmap } from './broker-local.js';
-// Tuning constants
-/** No-new-message window before a recap is shown. 60s by default; override with
- *  CRTR_RECAP_IDLE_MS (for fast runtime verification). */
-function idleMs() {
-    return envRecapIdleMs();
-}
-/** How often the single low-rate timer checks elapsed-since-last-message. */
-const POLL_MS = 7_000;
-/** How many messages from each end of the conversation feed the brief model —
- *  the first N carry the original request, the last N carry where it left off. */
-const CONVO_EDGE_MESSAGES = 5;
-/** Per-message char cap — keeps one giant paste from crowding out the rest
- *  (10 messages × this ≈ the total budget the model needs for the gist). */
-const MESSAGE_CHAR_BUDGET = 1_200;
-const WIDGET_KEY = 'crtr-recap';
-// Module-level state — persists across /reload so the timer doesn't stack.
-/** The one live poll timer. Cleared and replaced on every re-registration. */
-let liveTimer;
-// Conversation extraction — literal user+assistant text ONLY.
-/** Pull the literal text out of a message's content (string or text blocks),
- *  dropping non-text blocks (thinking, toolCall, image). */
-function messageText(msg) {
-    const c = msg.content;
-    if (typeof c === 'string')
-        return c.trim();
-    if (!Array.isArray(c))
-        return '';
-    return c
-        .filter((b) => b !== null && typeof b === 'object' && b.type === 'text' && typeof b.text === 'string')
-        .map((b) => (b.text ?? '').trim())
-        .filter((t) => t !== '')
-        .join('\n')
-        .trim();
-}
-/** Return the full conversation for ordinary nodes, or only messages after this
- * review's first durable boundary. A missing review marker intentionally has no
- * recap input: inherited context must never become widget or naming text. */
-function recapEntries(sm, reviewId) {
-    let entries;
-    try {
-        entries = sm.getEntries();
-    }
-    catch {
-        return { entries: [], boundaryPresent: reviewId === undefined };
-    }
-    if (reviewId === undefined)
-        return { entries, boundaryPresent: true };
-    const markerIndex = entries.findIndex((entry) => isReviewBoundary(entry, reviewId));
-    return markerIndex === -1
-        ? { entries: [], boundaryPresent: false }
-        : { entries: entries.slice(markerIndex + 1), boundaryPresent: true };
-}
-/** Extract every literal user/assistant message in chronological order. */
-function conversationParts(sm, messageCharBudget, assistantPartial, reviewId) {
-    const { entries, boundaryPresent } = recapEntries(sm, reviewId);
-    const parts = [];
-    const append = (message) => {
-        const role = message.role;
-        if (role !== 'user' && role !== 'assistant')
-            return; // drop toolResult etc.
-        let text = messageText(message);
-        if (text === '')
-            return;
-        if (text.length > messageCharBudget)
-            text = `${text.slice(0, messageCharBudget)} …[truncated]`;
-        const part = `${role === 'user' ? 'User' : 'Agent'}: ${text}`;
-        // Some pi versions expose the in-progress assistant message through the
-        // session manager as well as message_update. Keep one latest snapshot.
-        if (parts.at(-1) !== part)
-            parts.push(part);
-    };
-    for (const e of entries) {
-        if (e.type !== 'message' || e.message === undefined)
-            continue;
-        append(e.message);
-    }
-    if (boundaryPresent && assistantPartial?.role === 'assistant')
-        append(assistantPartial);
-    return parts;
-}
-/** Concatenate the first and most-recent messages for the compact inactivity
- *  briefing. The opening request and current state are the useful recap inputs. */
-function buildConversation(sm, assistantPartial, reviewId) {
-    const parts = conversationParts(sm, MESSAGE_CHAR_BUDGET, assistantPartial, reviewId);
-    if (parts.length === 0)
-        return '';
-    if (parts.length <= CONVO_EDGE_MESSAGES * 2)
-        return parts.join('\n\n');
-    const omitted = parts.length - CONVO_EDGE_MESSAGES * 2;
-    return [
-        ...parts.slice(0, CONVO_EDGE_MESSAGES),
-        `[… ${omitted} message${omitted === 1 ? '' : 's'} omitted …]`,
-        ...parts.slice(parts.length - CONVO_EDGE_MESSAGES),
-    ].join('\n\n');
-}
-/** A bounded chronological sample spanning the whole conversation for title
- *  regeneration. It keeps the one-shot title request practical while giving new
- *  information from the middle and end equal weight with the opening request. */
-function buildNamingConversation(sm, assistantPartial, reviewId) {
-    const parts = conversationParts(sm, 600, assistantPartial, reviewId);
-    if (parts.length === 0)
-        return '';
-    const maxParts = 48;
-    if (parts.length <= maxParts)
-        return parts.join('\n\n');
-    const sampled = Array.from({ length: maxParts }, (_, index) => {
-        const sourceIndex = Math.round(index * (parts.length - 1) / (maxParts - 1));
-        return parts[sourceIndex];
-    });
-    return sampled.join('\n\n');
-}
-// Extension
-/**
- * Register the inactivity-recap chrome on `pi`.
- *
- * Returns immediately (inert) when CRTR_NODE_ID is absent — a plain pi session
- * or legacy job agent loads it as a no-op.
- */
-export function registerCanvasRecap(pi, recapGenerator = generateRecap, nameRegenerator) {
-    const nodeId = envNodeId();
-    if (nodeId === undefined || nodeId.trim() === '')
-        return; // not a canvas node
-    // Captured on session_start; used by the timer and the message handlers.
-    let ui;
-    let sessionManager;
-    let brokerNode;
-    /** Exact provider/model that most recently ran this conversation successfully.
-     *  The recap subprocess prefers it over a hard-pinned provider that may be in
-     *  cooldown (the failure mode that made the old recap silently disappear). */
-    let liveModel;
-    const captureLiveModel = (ctx) => {
-        const provider = ctx.model?.provider?.trim();
-        const id = ctx.model?.id?.trim();
-        if (provider && id)
-            liveModel = `${provider}/${id}`;
-    };
-    /** Wall-clock of the most recent user/assistant message. The idle clock. */
-    let lastMessageAt = Date.now();
-    /** Monotonic conversation activity version used to judge generation results. */
-    let activityVersion = 0;
-    /** Latest in-progress assistant message, which is absent from persisted entries. */
-    let liveAssistantPartial;
-    /** Whether a recap is currently shown and whether conversation activity has
-     *  made that recap eligible for replacement in the next idle window. */
-    let recapShown = false;
-    let recapStale = false;
-    /** A markerless review has no safe recap input until new activity occurs. */
-    let recapInputUnavailable = false;
-    /** True while a briefing generation is in flight (so we don't fire a second). */
-    let generating = false;
-    const canPaint = () => ui !== undefined && typeof ui.setWidget === 'function';
-    /** A manual recap is a model call that can take tens of seconds. Confirm its
-     * start immediately so selecting it from Alt+C is never mistaken for a dead
-     * menu action. The finished widget remains the durable completion signal. */
-    const notify = (message) => {
-        try {
-            ui?.notify?.(message, 'info');
-        }
-        catch { /* best-effort */ }
-    };
-    const clearRecap = () => {
-        if (!canPaint())
-            return;
-        try {
-            ui.setWidget(WIDGET_KEY, undefined, { placement: 'aboveEditor' });
-        }
-        catch { /* best-effort */ }
-    };
-    /** Render the briefing into the viewer's low-contrast above-editor slot.
-     *  The briefing arrives as the two-line `Goal:`/`State:` format — one widget
-     *  line each (the viewer wraps long lines itself). */
-    const showRecap = (briefing) => {
-        if (!canPaint() || briefing === '')
-            return;
-        const lines = briefing.split('\n').filter((l) => l.trim() !== '');
-        if (lines.length === 0)
-            return;
-        try {
-            ui.setWidget(WIDGET_KEY, lines, { placement: 'aboveEditor' });
-        }
-        catch { /* best-effort */ }
-    };
-    /** Conversation activity resets the idle clock. A shown recap remains useful
-     *  context while stale and stays pinned until a replacement succeeds. */
-    const onMessage = () => {
-        lastMessageAt = Date.now();
-        activityVersion += 1;
-        recapInputUnavailable = false;
-        if (recapShown)
-            recapStale = true;
-    };
-    /** Re-name only when the live title is still crouter's generated node label.
-     *  A different title came from a person and is left intact. */
-    const refreshAutomaticName = (conversation) => {
-        if (pi.getSessionName === undefined || pi.setSessionName === undefined)
-            return;
-        // Keep the injectable test seam independent of the daemon. The production
-        // regenerator below is the broker-state closure; it captures its own
-        // compare-and-set projection before asking the headless namer.
-        if (nameRegenerator !== undefined) {
-            const original = pi.getSessionName();
-            if (original === undefined)
-                return;
-            nameRegenerator(nodeId, conversation, () => pi.getSessionName?.() === original, (label) => {
-                try {
-                    pi.setSessionName?.(label);
-                }
-                catch { /* best-effort */ }
-            });
-            return;
-        }
-        void brokerExtensionState(nodeId).then(({ node }) => {
-            // `/rename` persists a person's explicit handle on the node as well as in
-            // the pi session. Such a handle remains authoritative even when its live
-            // session text exactly matches the generated editor label.
-            if (node.name.trim() !== '' && node.name !== node.kind)
-                return;
-            const original = editorLabelForBrokerNode(node);
-            if (pi.getSessionName?.() !== original)
-                return;
-            generateAndCommitRecapName(nodeId, conversation, {
-                name: node.name,
-                description: node.description ?? '',
-                title: node.title ?? '',
-                icon: node.icon ?? '',
-                kind: node.kind,
-            }, () => pi.getSessionName?.() === original, (label) => {
-                try {
-                    pi.setSessionName?.(label);
-                }
-                catch { /* best-effort */ }
-            });
-        }).catch(() => { });
-    };
-    /** Start one briefing generation. A manual request refreshes an untouched
-     *  generated title as a separate best-effort task from the broader conversation. */
-    const requestRecap = (manual) => {
-        if (!canPaint() || sessionManager === undefined || generating)
-            return;
-        const assistantPartial = liveAssistantPartial;
-        const reviewId = brokerNode?.review_binding?.review_id
-            ?? sessionManager.getEntries()
-                .map((entry) => entry.details?.reviewId)
-                .find((id) => typeof id === 'string');
-        const conversation = buildConversation(sessionManager, assistantPartial, reviewId);
-        if (conversation === '') {
-            recapInputUnavailable = true;
-            recapShown = false;
-            recapStale = false;
-            clearRecap();
-            return;
-        }
-        recapInputUnavailable = false;
-        const namingConversation = manual ? buildNamingConversation(sessionManager, assistantPartial, reviewId) : '';
-        const snapshotVersion = activityVersion;
-        generating = true;
-        if (manual) {
-            notify('Generating recap…');
-            refreshAutomaticName(namingConversation);
-        }
-        let roadmap;
-        try {
-            roadmap = readRoadmap(nodeId) ?? undefined;
-        }
-        catch { /* best-effort */ }
-        recapGenerator(conversation, (briefing) => {
-            generating = false;
-            // A manual recap belongs to its click-time snapshot and always paints.
-            // Automatic work paints only while its idle snapshot remains current.
-            if ((!manual && activityVersion !== snapshotVersion) || !canPaint())
-                return;
-            // Persist what we are about to paint. The widget dies with the broker; the
-            // file is what `crtr canvas browse` shows for a dormant node.
-            writeNodeRecap(nodeId, briefing);
-            recapShown = true;
-            recapStale = activityVersion !== snapshotVersion;
-            showRecap(briefing);
-            if (manual)
-                notify('Recap ready');
-        }, liveModel, roadmap);
-        // generateRecap is silent on failure (never calls back), so clear the
-        // in-flight flag after the timeout window even if no callback fires.
-        setTimeout(() => { generating = false; }, 30_000).unref?.();
-    };
-    // The prefix menu sends `/recap` into the focused viewer. As an extension
-    // command it never becomes a user message or starts an agent turn.
-    pi.registerCommand?.('recap', {
-        description: 'Generate a Goal/State recap and refresh the original generated session title',
-        handler: (_args, ctx) => {
-            ui = ctx.ui;
-            sessionManager = ctx.sessionManager;
-            captureLiveModel(ctx);
-            requestRecap(true);
-        },
-    });
-    // Events
-    pi.on('session_start', (_event, ctx) => {
-        ui = ctx.ui;
-        sessionManager = ctx.sessionManager;
-        captureLiveModel(ctx);
-        brokerNode = undefined;
-        void brokerExtensionState(nodeId).then((state) => {
-            brokerNode = state.node;
-        }).catch(() => { });
-        // Fresh session / hot-swap: start the idle clock now and drop any stale
-        // recap that bled through a /reload.
-        lastMessageAt = Date.now();
-        activityVersion = 0;
-        liveAssistantPartial = undefined;
-        recapShown = false;
-        recapStale = false;
-        recapInputUnavailable = false;
-        generating = false;
-        clearRecap();
-    });
-    pi.on('input', (_event, _ctx) => {
-        // Every user message (any source) is activity.
-        onMessage();
-    });
-    pi.on('message_update', (event, _ctx) => {
-        const message = event?.message;
-        if (message?.role === 'assistant')
-            liveAssistantPartial = message;
-        onMessage();
-    });
-    pi.on('turn_end', (_event, ctx) => {
-        // The completed assistant message now lives in the session manager.
-        liveAssistantPartial = undefined;
-        captureLiveModel(ctx);
-        onMessage();
-    });
-    // The single low-rate idle poll.
-    if (liveTimer !== undefined)
-        clearInterval(liveTimer);
-    const timer = setInterval(() => {
-        try {
-            if (!canPaint() || sessionManager === undefined)
-                return;
-            if (recapInputUnavailable || (recapShown && !recapStale) || generating)
-                return;
-            if (Date.now() - lastMessageAt < idleMs())
-                return;
-            requestRecap(false);
-        }
-        catch {
-            /* timer is best-effort */
-        }
-    }, POLL_MS);
-    if (typeof timer.unref === 'function')
-        timer.unref();
-    liveTimer = timer;
-    pi.on('session_shutdown', () => {
-        clearInterval(timer);
-        if (liveTimer === timer)
-            liveTimer = undefined;
-    });
-}
-export default registerCanvasRecap;
+var L=Object.defineProperty;var a=(n,s)=>L(n,"name",{value:s,configurable:!0});import{envNodeId as W,envRecapIdleMs as O}from"../shared/env.js";import{brokerExtensionState as k}from"../core/runtime/broker/daemon-ops.js";import{generateRecap as U}from"../core/runtime/recap.js";import{writeNodeRecap as V}from"../core/canvas/node-recap.js";import{isReviewBoundary as B}from"../core/runtime/session-visibility.js";import{editorLabelForBrokerNode as q}from"../core/runtime/broker-extension-render.js";import{generateAndCommitRecapName as F,readRoadmap as H}from"./broker-local.js";function K(){return O()}a(K,"idleMs");const Y=7e3,A=5,z=1200,C="crtr-recap";let M;function J(n){const s=n.content;return typeof s=="string"?s.trim():Array.isArray(s)?s.filter(r=>r!==null&&typeof r=="object"&&r.type==="text"&&typeof r.text=="string").map(r=>(r.text??"").trim()).filter(r=>r!=="").join(`
+`).trim():""}a(J,"messageText");function Q(n,s){let r;try{r=n.getEntries()}catch{return{entries:[],boundaryPresent:s===void 0}}if(s===void 0)return{entries:r,boundaryPresent:!0};const t=r.findIndex(o=>B(o,s));return t===-1?{entries:[],boundaryPresent:!1}:{entries:r.slice(t+1),boundaryPresent:!0}}a(Q,"recapEntries");function D(n,s,r,t){const{entries:o,boundaryPresent:u}=Q(n,t),l=[],m=a(f=>{const p=f.role;if(p!=="user"&&p!=="assistant")return;let d=J(f);if(d==="")return;d.length>s&&(d=`${d.slice(0,s)} \u2026[truncated]`);const g=`${p==="user"?"User":"Agent"}: ${d}`;l.at(-1)!==g&&l.push(g)},"append");for(const f of o)f.type!=="message"||f.message===void 0||m(f.message);return u&&r?.role==="assistant"&&m(r),l}a(D,"conversationParts");function X(n,s,r){const t=D(n,z,s,r);if(t.length===0)return"";if(t.length<=A*2)return t.join(`
+
+`);const o=t.length-A*2;return[...t.slice(0,A),`[\u2026 ${o} message${o===1?"":"s"} omitted \u2026]`,...t.slice(t.length-A)].join(`
+
+`)}a(X,"buildConversation");function Z(n,s,r){const t=D(n,600,s,r);if(t.length===0)return"";const o=48;return t.length<=o?t.join(`
+
+`):Array.from({length:o},(l,m)=>{const f=Math.round(m*(t.length-1)/(o-1));return t[f]}).join(`
+
+`)}a(Z,"buildNamingConversation");function ee(n,s=U,r){const t=W();if(t===void 0||t.trim()==="")return;let o,u,l,m;const f=a(i=>{const e=i.model?.provider?.trim(),c=i.model?.id?.trim();e&&c&&(m=`${e}/${c}`)},"captureLiveModel");let p=Date.now(),d=0,g,v=!1,_=!1,S=!1,h=!1;const N=a(()=>o!==void 0&&typeof o.setWidget=="function","canPaint"),R=a(i=>{try{o?.notify?.(i,"info")}catch{}},"notify"),b=a(()=>{if(N())try{o.setWidget(C,void 0,{placement:"aboveEditor"})}catch{}},"clearRecap"),$=a(i=>{if(!N()||i==="")return;const e=i.split(`
+`).filter(c=>c.trim()!=="");if(e.length!==0)try{o.setWidget(C,e,{placement:"aboveEditor"})}catch{}},"showRecap"),I=a(()=>{p=Date.now(),d+=1,S=!1,v&&(_=!0)},"onMessage"),j=a(i=>{if(!(n.getSessionName===void 0||n.setSessionName===void 0)){if(r!==void 0){const e=n.getSessionName();if(e===void 0)return;r(t,i,()=>n.getSessionName?.()===e,c=>{try{n.setSessionName?.(c)}catch{}});return}k(t).then(({node:e})=>{if(e.name.trim()!==""&&e.name!==e.kind)return;const c=q(e);n.getSessionName?.()===c&&F(t,i,{name:e.name,description:e.description??"",title:e.title??"",icon:e.icon??"",kind:e.kind},()=>n.getSessionName?.()===c,w=>{try{n.setSessionName?.(w)}catch{}})}).catch(()=>{})}},"refreshAutomaticName"),P=a(i=>{if(!N()||u===void 0||h)return;const e=g,c=l?.review_binding?.review_id??u.getEntries().map(y=>y.details?.reviewId).find(y=>typeof y=="string"),w=X(u,e,c);if(w===""){S=!0,v=!1,_=!1,b();return}S=!1;const T=i?Z(u,e,c):"",x=d;h=!0,i&&(R("Generating recap\u2026"),j(T));let G;try{G=H(t)??void 0}catch{}s(w,y=>{h=!1,!(!i&&d!==x||!N())&&(V(t,y),v=!0,_=d!==x,$(y),i&&R("Recap ready"))},m,G),setTimeout(()=>{h=!1},3e4).unref?.()},"requestRecap");n.registerCommand?.("recap",{description:"Generate a Goal/State recap and refresh the original generated session title",handler:a((i,e)=>{o=e.ui,u=e.sessionManager,f(e),P(!0)},"handler")}),n.on("session_start",(i,e)=>{o=e.ui,u=e.sessionManager,f(e),l=void 0,k(t).then(c=>{l=c.node}).catch(()=>{}),p=Date.now(),d=0,g=void 0,v=!1,_=!1,S=!1,h=!1,b()}),n.on("input",(i,e)=>{I()}),n.on("message_update",(i,e)=>{const c=i?.message;c?.role==="assistant"&&(g=c),I()}),n.on("turn_end",(i,e)=>{g=void 0,f(e),I()}),M!==void 0&&clearInterval(M);const E=setInterval(()=>{try{if(!N()||u===void 0||S||v&&!_||h||Date.now()-p<K())return;P(!1)}catch{}},Y);typeof E.unref=="function"&&E.unref(),M=E,n.on("session_shutdown",()=>{clearInterval(E),M===E&&(M=void 0)})}a(ee,"registerCanvasRecap");var fe=ee;export{fe as default,ee as registerCanvasRecap};

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

@@ -1,63 +1,3 @@
-// canvas-review-boundary.ts — durable visible-transcript boundary for review companions.
-//
-// On session_start, a review companion appends one custom_message after its
-// inherited fork context and before canvas-context-intro appends fork bearings.
-// The display projection starts at this marker while the model keeps the full
-// inherited context.
-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 } from '../shared/generated-context.js';
-// Extension
-/**
- * Register the review boundary marker. Companion nodes receive one boundary
- * marker on session_start that separates inherited context from the visible
- * transcript. Ordinary nodes get nothing.
- */
-export function registerCanvasReviewBoundary(pi) {
-    pi.on('session_start', async (_event, ctx) => {
-        const nodeId = envNodeId();
-        if (!nodeId || nodeId.trim() === '')
-            return;
-        let node;
-        try {
-            node = (await brokerExtensionState(nodeId)).node;
-        }
-        catch {
-            return;
-        }
-        if (node.review_binding == null)
-            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 alreadyMarked = ctx.sessionManager
-            .getBranch()
-            .some((entry) => isReviewBoundary(entry, node.review_binding?.review_id));
-        if (alreadyMarked)
-            return;
-        const binding = node.review_binding;
-        const { review_id: reviewId, origin_node_id: originNodeId, target_file: targetFile } = binding;
-        const content = binding.kind === 'page_feedback'
-            ? [
-                `This conversation began from feedback on page ${reviewId}.`,
-                `Page source: ${targetFile}`,
-                `Origin node: ${originNodeId}`,
-                '',
-                "The person's visible transcript starts here. Everything above this marker is the origin node's work — inherited context they have not seen.",
-            ].join('\n')
-            : [
-                `Reviewed file: ${targetFile}`,
-                `Review ID: ${reviewId}`,
-                `Origin node: ${originNodeId}`,
-                '',
-                "The person's visible transcript starts here. Everything above this marker is inherited context they have not seen.",
-            ].join('\n');
-        pi.sendMessage({
-            customType: REVIEW_BOUNDARY_CUSTOM_TYPE,
-            content: formatCard('review-boundary', {}, content),
-            display: true,
-            details: { reviewId, originNodeId, targetFile, kind: binding.kind ?? 'review' },
-        });
-    });
-}
-export default registerCanvasReviewBoundary;
+var h=Object.defineProperty;var d=(e,a)=>h(e,"name",{value:a,configurable:!0});import{envNodeId as f}from"../shared/env.js";import{brokerExtensionState as m}from"../core/runtime/broker/daemon-ops.js";import{isReviewBoundary as w,REVIEW_BOUNDARY_CUSTOM_TYPE as _}from"../core/runtime/session-visibility.js";import{formatCard as b}from"../shared/generated-context.js";function l(e){e.on("session_start",async(a,v)=>{const i=f();if(!i||i.trim()==="")return;let n;try{n=(await m(i)).node}catch{return}if(n.review_binding==null||v.sessionManager.getBranch().some(g=>w(g,n.review_binding?.review_id)))return;const r=n.review_binding,{review_id:t,origin_node_id:o,target_file:s}=r,c=r.kind==="page_feedback"?[`This conversation began from feedback on page ${t}.`,`Page source: ${s}`,`Origin node: ${o}`,"","The person's visible transcript starts here. Everything above this marker is the origin node's work \u2014 inherited context they have not seen."].join(`
+`):[`Reviewed file: ${s}`,`Review ID: ${t}`,`Origin node: ${o}`,"","The person's visible transcript starts here. Everything above this marker is inherited context they have not seen."].join(`
+`);e.sendMessage({customType:_,content:b("review-boundary",{},c),display:!0,details:{reviewId:t,originNodeId:o,targetFile:s,kind:r.kind??"review"}})})}d(l,"registerCanvasReviewBoundary");var R=l;export{R as default,l as registerCanvasReviewBoundary};

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

@@ -1,77 +1,2 @@
-// canvas-stamp.ts — the sole writer of `crtr-stamp` entries.
-//
-// Two records land in the session jsonl. A SESSION stamp names the node and the
-// crtr release that own the file, appended at session start only when the
-// latest one on disk disagrees — which covers a fresh session, a fork (whose
-// copied history still carries the source node's stamp), a new cycle, and a
-// runtime upgrade mid-node, without a rule per case. A MESSAGE stamp records
-// where one user message came from, joined to it by the message's own
-// timestamp.
-//
-// Every user message is stamped; an origin appears only when a delivery seam
-// announced one (absence means unknown, never a guess). An assistant message is
-// stamped only when an `ext` contribution is pending, so an ordinary turn costs
-// no line.
-//
-// Ordering note: pi runs message_end handlers BEFORE it persists the finalized
-// message, so the stamp is written as that message's structural parent. The
-// join is by `msgTs`, so tree position carries no meaning here.
-import { envNodeId } from '../shared/env.js';
-import { crtrVersion } from '../shared/crtr-version.js';
-import { claimMessageAnnouncement, drainStampExt, hasPendingStampExt, } from '../core/runtime/stamp/channel.js';
-import { CRTR_STAMP_CUSTOM_TYPE, latestSessionStamp, STAMP_SCHEMA_VERSION, } from '../core/runtime/stamp/protocol.js';
-/** Plain text of a message's content (string or content blocks). */
-function messageText(content) {
-    if (typeof content === 'string')
-        return content;
-    if (Array.isArray(content)) {
-        return content
-            .filter((block) => typeof block === 'object' && block !== null && typeof block.text === 'string')
-            .map((block) => block.text)
-            .join('\n');
-    }
-    return '';
-}
-function envelope(kind, payload) {
-    const ext = drainStampExt();
-    return {
-        v: STAMP_SCHEMA_VERSION,
-        kind,
-        payload,
-        ...(ext === undefined ? {} : { ext }),
-    };
-}
-/** Register the stamp writer. */
-export function registerCanvasStamp(pi) {
-    pi.on('session_start', (_event, ctx) => {
-        const node = envNodeId();
-        if (node === undefined || node.trim() === '')
-            return;
-        const crtr = crtrVersion();
-        const latest = latestSessionStamp(ctx.sessionManager.getEntries());
-        if (latest !== null && latest.payload.node === node && latest.payload.crtr === crtr)
-            return;
-        pi.appendEntry(CRTR_STAMP_CUSTOM_TYPE, envelope('session', { node, crtr }));
-    });
-    pi.on('message_end', (event) => {
-        const message = event?.message;
-        if (message === undefined || message === null)
-            return;
-        if (typeof message.timestamp !== 'number')
-            return;
-        const msgTs = message.timestamp;
-        if (message.role === 'user') {
-            const announcement = claimMessageAnnouncement(messageText(message.content));
-            pi.appendEntry(CRTR_STAMP_CUSTOM_TYPE, envelope('message', {
-                msgTs,
-                ...(announcement === null ? {} : announcement),
-            }));
-            return;
-        }
-        // Any other message earns a line only for a pending contribution.
-        if (!hasPendingStampExt())
-            return;
-        pi.appendEntry(CRTR_STAMP_CUSTOM_TYPE, envelope('message', { msgTs }));
-    });
-}
-export default registerCanvasStamp;
+var u=Object.defineProperty;var o=(e,n)=>u(e,"name",{value:n,configurable:!0});import{envNodeId as f}from"../shared/env.js";import{crtrVersion as p}from"../shared/crtr-version.js";import{claimMessageAnnouncement as d,drainStampExt as l,hasPendingStampExt as g}from"../core/runtime/stamp/channel.js";import{CRTR_STAMP_CUSTOM_TYPE as i,latestSessionStamp as c,STAMP_SCHEMA_VERSION as y}from"../core/runtime/stamp/protocol.js";function S(e){return typeof e=="string"?e:Array.isArray(e)?e.filter(n=>typeof n=="object"&&n!==null&&typeof n.text=="string").map(n=>n.text).join(`
+`):""}o(S,"messageText");function m(e,n){const t=l();return{v:y,kind:e,payload:n,...t===void 0?{}:{ext:t}}}o(m,"envelope");function E(e){e.on("session_start",(n,t)=>{const r=f();if(r===void 0||r.trim()==="")return;const s=p(),a=c(t.sessionManager.getEntries());a!==null&&a.payload.node===r&&a.payload.crtr===s||e.appendEntry(i,m("session",{node:r,crtr:s}))}),e.on("message_end",n=>{const t=n?.message;if(t==null||typeof t.timestamp!="number")return;const r=t.timestamp;if(t.role==="user"){const s=d(S(t.content));e.appendEntry(i,m("message",{msgTs:r,...s===null?{}:s}));return}g()&&e.appendEntry(i,m("message",{msgTs:r}))})}o(E,"registerCanvasStamp");var v=E;export{v as default,E as registerCanvasStamp};