@north-light/crouter 0.3.318 → 0.3.320

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

@@ -1,203 +1,14 @@
-// Passive mail is claimed only on natural input and acknowledged after settlement.
-// Formatting failures retain the SQL claim; refused turns release it for replay.
-import { envNodeId } from '../shared/env.js';
-import { existsSync, readFileSync } from 'node:fs';
-import { acknowledgeBrokerMail, claimBrokerMail, brokerExtensionState } from '../core/runtime/broker/daemon-ops.js';
-import { wasTurnRefused } from '../core/runtime/broker/extension-abort.js';
-import { emitEvent } from '../core/events/emit.js';
-import { reportPathFromRef } from '../core/runtime/broker-extension-render.js';
-import { parseCard } from '../shared/generated-context.js';
-// Per-entry body cap so a single fat report can't blow the context budget. The
-// full report stays on disk at `ref` if the agent needs more.
-const BODY_CAP = 4_000;
-// Report dereference — turn a passive pointer into the message text it carries.
-/** Strip the leading YAML frontmatter block a report is written with, returning
- *  just the body. Tolerant: no frontmatter → returns the input unchanged. */
-function stripFrontmatter(raw) {
-    if (!raw.startsWith('---\n'))
-        return raw;
-    const end = raw.indexOf('\n---\n', 4);
-    return end === -1 ? raw : raw.slice(end + 5);
-}
-/** The content for one accumulated entry: the dereferenced report body when the
- *  pointer carries a `ref`, else the entry's own label/data. Capped + trimmed. */
-function entryContent(e, reportNodes) {
-    if (e.ref !== undefined && e.ref !== '') {
-        // Push entries carry a canonical history handle. crtrd has already
-        // projected the sender set; use that metadata to validate the local path
-        // without importing the canvas history resolver. Direct-message spill refs
-        // remain absolute filesystem paths and keep their existing behavior.
-        const reportPath = reportPathFromRef(e.ref, reportNodes);
-        if (reportPath !== null) {
-            try {
-                const body = stripFrontmatter(readFileSync(reportPath, 'utf8')).trim();
-                if (body !== '') {
-                    return body.length > BODY_CAP
-                        ? `${body.slice(0, BODY_CAP)}\n… (truncated; read the full report with \`crtr canvas history read ${e.ref}\`)`
-                        : body;
-                }
-            }
-            catch {
-                /* fall through to the absolute spill-file path */
-            }
-        }
-        if (existsSync(e.ref)) {
-            try {
-                const body = stripFrontmatter(readFileSync(e.ref, 'utf8')).trim();
-                if (body !== '') {
-                    return body.length > BODY_CAP
-                        ? `${body.slice(0, BODY_CAP)}\n… (truncated; full report at ${e.ref})`
-                        : body;
-                }
-            }
-            catch {
-                /* fall through to the label */
-            }
-        }
-    }
-    const data = e.data?.['body'];
-    if (typeof data === 'string' && data.trim() !== '')
-        return data.trim();
-    return e.label;
-}
-/** Minimal XML attribute escaping for the values we interpolate. */
-function attr(s) {
-    return s
-        .replace(/&/g, '&')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
-}
-/**
- * Render drained passive entries (oldest first) into one XML pre-text block.
- * Each accumulated message is its own timestamped `<update>` element.
- */
-export function formatPassive(entries, reportNodes = new Map()) {
-    const blocks = entries
-        .map((e) => {
-        const from = attr(e.from ?? 'system');
-        const nameAttr = e.from_name !== undefined && e.from_name !== '' ? ` from_name="${attr(e.from_name)}"` : '';
-        const refAttr = e.ref !== undefined && e.ref !== '' ? ` ref="${attr(e.ref)}"` : '';
-        return (`<update from="${from}"${nameAttr} kind="${attr(e.kind)}" at="${attr(e.ts)}"${refAttr}>\n` +
-            `${entryContent(e, reportNodes)}\n` +
-            `</update>`);
-    })
-        .join('\n');
-    return (`<passive-subscription-backlog count="${entries.length}" ` +
-        `note="Reports accumulated from nodes you passively subscribe to while you were not actively listening. ` +
-        `Surfaced now because you were messaged. Oldest first.">\n` +
-        `${blocks}\n` +
-        `</passive-subscription-backlog>`);
-}
-const CARD_CLOSE = '</runtime>';
-/**
- * Place the backlog block on a message without displacing a runtime card.
- *
- * A runtime card is a WHOLE-message envelope: it opens at byte 0 and closes at
- * the last byte. The inbox watcher's own wake arrives through this same `input`
- * event, so prepending to it would push the envelope off byte 0 and every
- * reader would attribute the digest to the person. Inside the card, the backlog
- * becomes the body's first child instead.
- */
-export function placeBacklog(text, preText) {
-    if (text.trim() === '')
-        return preText;
-    const card = parseCard({ role: 'user', content: text });
-    if (card === null)
-        return `${preText}\n\n${text}`;
-    const bodyStart = text.length - card.body.length - CARD_CLOSE.length;
-    return `${text.slice(0, bodyStart)}${preText}\n${text.slice(bodyStart)}`;
-}
-// Extension
-export function registerCanvasPassiveContext(pi) {
-    const claims = new Map();
-    let pending;
-    let settlement;
-    function reportFailure(error) {
-        try {
-            emitEvent({ level: 'error', event: 'inbox.delivery.failed', outcome: 'failed', error, fields: { channel: 'passive' } });
-        }
-        catch {
-            // SQL claims and pending receipts remain authoritative if diagnostics fail.
-        }
-    }
-    async function settle(nodeId) {
-        if (settlement !== undefined)
-            return settlement;
-        if (pending === undefined) {
-            pending = [...claims.values()].filter((item) => item.injected).map(({ claim }) => ({
-                delivery_id: claim.delivery_id, attempts: claim.attempts,
-                disposition: wasTurnRefused() ? 'released' : 'acknowledged',
-            }));
-        }
-        if (pending.length === 0) {
-            pending = undefined;
-            return true;
-        }
-        const receipts = pending;
-        const attempt = (async () => {
-            try {
-                const result = await acknowledgeBrokerMail(nodeId, receipts);
-                if (result.action === 'hold')
-                    return false;
-                for (const receipt of receipts) {
-                    const confirmed = result.results.find((result) => result.delivery_id === receipt.delivery_id);
-                    if (confirmed?.outcome !== receipt.disposition && confirmed?.outcome !== 'stale')
-                        throw new Error(`passive mail settlement has no terminal outcome: ${receipt.delivery_id}`);
-                }
-                for (const receipt of receipts)
-                    claims.delete(receipt.delivery_id);
-                pending = undefined;
-                return true;
-            }
-            catch (error) {
-                reportFailure(error);
-                return false;
-            }
-        })().finally(() => { if (settlement === attempt)
-            settlement = undefined; });
-        settlement = attempt;
-        return attempt;
-    }
-    pi.on('input', async (event) => {
-        const nodeId = envNodeId();
-        if (nodeId === undefined || nodeId.trim() === '')
-            return;
-        try {
-            if (pending !== undefined && !await settle(nodeId))
-                return;
-            const result = await claimBrokerMail(nodeId, 'passive');
-            if (result.action === 'hold')
-                return;
-            for (const claim of result.deliveries) {
-                if (!claims.has(claim.delivery_id))
-                    claims.set(claim.delivery_id, { claim, injected: false });
-            }
-            const unsent = [...claims.values()].filter((item) => !item.injected);
-            if (unsent.length === 0)
-                return;
-            const state = await brokerExtensionState(nodeId);
-            const reportNodes = new Map(state.report_nodes.map((node) => [node.node_id, node]));
-            const text = placeBacklog(event.text, formatPassive(unsent.map(({ claim }) => claim.entry), reportNodes));
-            for (const item of unsent)
-                item.injected = true;
-            return { action: 'transform', text, images: event.images };
-        }
-        catch (error) {
-            // The original input proceeds; unformatted mail remains held and unacknowledged.
-            reportFailure(error);
-            return;
-        }
-    });
-    pi.on('agent_settled', async () => {
-        const nodeId = envNodeId();
-        if (nodeId !== undefined && nodeId !== '')
-            await settle(nodeId);
-    });
-    pi.on('session_shutdown', async (_event, ctx) => {
-        const nodeId = envNodeId();
-        if (nodeId !== undefined && nodeId !== '' && ctx?.hasPendingMessages?.() !== true)
-            await settle(nodeId);
-    });
-}
-export default registerCanvasPassiveContext;
+var $=Object.defineProperty;var f=(e,n)=>$(e,"name",{value:n,configurable:!0});import{envNodeId as h}from"../shared/env.js";import{existsSync as b,readFileSync as v}from"node:fs";import{acknowledgeBrokerMail as w,claimBrokerMail as k,brokerExtensionState as C}from"../core/runtime/broker/daemon-ops.js";import{wasTurnRefused as M}from"../core/runtime/broker/extension-abort.js";import{emitEvent as P}from"../core/events/emit.js";import{reportPathFromRef as S}from"../core/runtime/broker-extension-render.js";import{parseCard as j}from"../shared/generated-context.js";const y=4e3;function _(e){if(!e.startsWith(`---
+`))return e;const n=e.indexOf(`
+---
+`,4);return n===-1?e:e.slice(n+5)}f(_,"stripFrontmatter");function x(e,n){if(e.ref!==void 0&&e.ref!==""){const t=S(e.ref,n);if(t!==null)try{const i=_(v(t,"utf8")).trim();if(i!=="")return i.length>y?`${i.slice(0,y)}
+\u2026 (truncated; read the full report with \`crtr canvas history read ${e.ref}\`)`:i}catch{}if(b(e.ref))try{const i=_(v(e.ref,"utf8")).trim();if(i!=="")return i.length>y?`${i.slice(0,y)}
+\u2026 (truncated; full report at ${e.ref})`:i}catch{}}const r=e.data?.body;return typeof r=="string"&&r.trim()!==""?r.trim():e.label}f(x,"entryContent");function m(e){return e.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;")}f(m,"attr");function A(e,n=new Map){const r=e.map(t=>{const i=m(t.from??"system"),u=t.from_name!==void 0&&t.from_name!==""?` from_name="${m(t.from_name)}"`:"",o=t.ref!==void 0&&t.ref!==""?` ref="${m(t.ref)}"`:"";return`<update from="${i}"${u} kind="${m(t.kind)}" at="${m(t.ts)}"${o}>
+${x(t,n)}
+</update>`}).join(`
+`);return`<passive-subscription-backlog count="${e.length}" note="Reports accumulated from nodes you passively subscribe to while you were not actively listening. Surfaced now because you were messaged. Oldest first.">
+${r}
+</passive-subscription-backlog>`}f(A,"formatPassive");const B="</runtime>";function E(e,n){if(e.trim()==="")return n;const r=j({role:"user",content:e});if(r===null)return`${n}
+
+${e}`;const t=e.length-r.body.length-B.length;return`${e.slice(0,t)}${n}
+${e.slice(t)}`}f(E,"placeBacklog");function F(e){const n=new Map;let r,t;function i(o){try{P({level:"error",event:"inbox.delivery.failed",outcome:"failed",error:o,fields:{channel:"passive"}})}catch{}}f(i,"reportFailure");async function u(o){if(t!==void 0)return t;if(r===void 0&&(r=[...n.values()].filter(s=>s.injected).map(({claim:s})=>({delivery_id:s.delivery_id,attempts:s.attempts,disposition:M()?"released":"acknowledged"}))),r.length===0)return r=void 0,!0;const d=r,a=(async()=>{try{const s=await w(o,d);if(s.action==="hold")return!1;for(const l of d){const p=s.results.find(g=>g.delivery_id===l.delivery_id);if(p?.outcome!==l.disposition&&p?.outcome!=="stale")throw new Error(`passive mail settlement has no terminal outcome: ${l.delivery_id}`)}for(const l of d)n.delete(l.delivery_id);return r=void 0,!0}catch(s){return i(s),!1}})().finally(()=>{t===a&&(t=void 0)});return t=a,a}f(u,"settle"),e.on("input",async o=>{const d=h();if(!(d===void 0||d.trim()===""))try{if(r!==void 0&&!await u(d))return;const a=await k(d,"passive");if(a.action==="hold")return;for(const c of a.deliveries)n.has(c.delivery_id)||n.set(c.delivery_id,{claim:c,injected:!1});const s=[...n.values()].filter(c=>!c.injected);if(s.length===0)return;const l=await C(d),p=new Map(l.report_nodes.map(c=>[c.node_id,c])),g=E(o.text,A(s.map(({claim:c})=>c.entry),p));for(const c of s)c.injected=!0;return{action:"transform",text:g,images:o.images}}catch(a){i(a);return}}),e.on("agent_settled",async()=>{const o=h();o!==void 0&&o!==""&&await u(o)}),e.on("session_shutdown",async(o,d)=>{const a=h();a!==void 0&&a!==""&&d?.hasPendingMessages?.()!==!0&&await u(a)})}f(F,"registerCanvasPassiveContext");var Y=F;export{Y as default,A as formatPassive,E as placeBacklog,F as registerCanvasPassiveContext};

package/dist/pi-extensions/canvas-preview-result.js

@@ -1,72 +1,2 @@
-// canvas-preview-result.ts — private structured result transport for crtr bash calls.
-//
-// A crtr leaf returns a record, but the CLI normally renders that record to
-// stdout for the agent. stdout is model context, so the bash valve hands every
-// bash call a private file path in the child environment, crtr mirrors its
-// record there, and this hook attaches the record to Pi's ToolResult.details.
-// The attach viewer can render a structured preview without parsing the
-// agent-facing text.
-//
-// One bash call may run several crtr invocations, so the file is JSONL — one
-// record per invocation, in order. Two fields are attached: `crtrPreview` is
-// the LAST record, the single-object shape every already-persisted transcript
-// and the inline command card were written against; `crtrPreviews` is the full
-// list, for consumers that must see every invocation in the call.
-import { envNodeId } from '../shared/env.js';
-import { existsSync, readFileSync, rmSync } from 'node:fs';
-import { previewResultPath } from '../core/preview-result-path.js';
-function isPreviewRecord(value) {
-    if (value === null || typeof value !== 'object' || typeof value['path'] !== 'string')
-        return false;
-    const record = value;
-    return (record.result !== undefined && record.result !== null && typeof record.result === 'object' && !Array.isArray(record.result))
-        || (Array.isArray(record.jsonl) && record.jsonl.every((item) => item !== null && typeof item === 'object' && !Array.isArray(item)))
-        || (record.error !== undefined && record.error !== null && typeof record.error === 'object' && !Array.isArray(record.error));
-}
-/** Every valid record in the mirror file. A single-object file (every record
- * written before the channel became JSONL) parses as one line, so historical
- * transcripts and a mid-upgrade broker read identically. One malformed line is
- * skipped rather than discarding the invocations around it. */
-function readPreviewRecords(path) {
-    const records = [];
-    for (const line of readFileSync(path, 'utf8').split('\n')) {
-        if (line.trim() === '')
-            continue;
-        try {
-            const record = JSON.parse(line);
-            if (isPreviewRecord(record))
-                records.push(record);
-        }
-        catch { /* one unreadable record never costs the others */ }
-    }
-    return records;
-}
-/** Loaded into every canvas broker. Plain Pi sessions have no node id and
- * deliberately receive no filesystem transport. */
-export function registerCanvasPreviewResult(pi) {
-    if (envNodeId() === undefined || envNodeId() === '')
-        return;
-    pi.on('tool_result', (event) => {
-        if (event.toolName !== 'bash')
-            return;
-        const path = previewResultPath(event.toolCallId);
-        if (!existsSync(path))
-            return;
-        try {
-            const records = readPreviewRecords(path);
-            const last = records.at(-1);
-            if (last === undefined)
-                return;
-            return { details: { ...(event.details ?? {}), crtrPreview: last, crtrPreviews: records } };
-        }
-        catch {
-            // A malformed side-channel record is not agent-visible output and must
-            // not change the bash call's actual result.
-            return;
-        }
-        finally {
-            rmSync(path, { force: true });
-        }
-    });
-}
-export default registerCanvasPreviewResult;
+var c=Object.defineProperty;var n=(e,r)=>c(e,"name",{value:r,configurable:!0});import{envNodeId as i}from"../shared/env.js";import{existsSync as f,readFileSync as l,rmSync as u}from"node:fs";import{previewResultPath as a}from"../core/preview-result-path.js";function d(e){if(e===null||typeof e!="object"||typeof e.path!="string")return!1;const r=e;return r.result!==void 0&&r.result!==null&&typeof r.result=="object"&&!Array.isArray(r.result)||Array.isArray(r.jsonl)&&r.jsonl.every(t=>t!==null&&typeof t=="object"&&!Array.isArray(t))||r.error!==void 0&&r.error!==null&&typeof r.error=="object"&&!Array.isArray(r.error)}n(d,"isPreviewRecord");function y(e){const r=[];for(const t of l(e,"utf8").split(`
+`))if(t.trim()!=="")try{const o=JSON.parse(t);d(o)&&r.push(o)}catch{}return r}n(y,"readPreviewRecords");function p(e){i()===void 0||i()===""||e.on("tool_result",r=>{if(r.toolName!=="bash")return;const t=a(r.toolCallId);if(f(t))try{const o=y(t),s=o.at(-1);return s===void 0?void 0:{details:{...r.details??{},crtrPreview:s,crtrPreviews:o}}}catch{return}finally{u(t,{force:!0})}})}n(p,"registerCanvasPreviewResult");var w=p;export{w as default,p as registerCanvasPreviewResult};

package/dist/pi-extensions/canvas-prompt-scrub.js

@@ -1,54 +1,2 @@
-// canvas-prompt-scrub.ts — removes pi's self-referential prompt text before any
-// other consumer reads the system prompt.
-//
-// pi's prompt builder hardcodes two things a canvas node should not carry:
-//
-//  1. An opening sentence naming pi as the harness. A node's identity is the
-//     canvas persona crouter appends, not the engine it happens to run on.
-//  2. A "Pi documentation (read only ...):" block — a marker line plus bullets
-//     pointing at pi's README / docs / examples under node_modules. It maps
-//     topics to doc files, which makes the agent extrapolate a
-//     topic -> docs/<topic>.md pattern and surface pi's internals unprompted.
-//
-// ORDER IS THE POINT. This must be a canvas extension, not a package one:
-// crouter's canvas extensions load ahead of installed pi packages, and the
-// Claude subscription adapter is a package. That adapter also wants the docs
-// block gone (it is a third-party tell that costs a Claude subscription its
-// plan rate), but it removes the block by cutting from the marker to the next
-// boundary marker it knows — and a canvas prompt has none, so the cut runs to
-// the end of the prompt and takes crouter's appended canvas persona with it.
-// Scrubbing here leaves the adapter nothing to find, so the persona survives.
-// The companion guard is CRTR env that disables the adapter's re-injection;
-// without it the adapter rebuilds the block from its own fallback copy.
-//
-// Every rule below is anchored to pi's exact wording and degrades to a no-op if
-// pi rewords, so a pi upgrade can never break a turn here.
-import { envNodeId } from '../shared/env.js';
-const PI_IDENTITY = 'You are an expert coding assistant operating inside pi, a coding agent harness.';
-const NEUTRAL_IDENTITY = 'You are an expert coding assistant.';
-const PI_DOCS_MARKER = 'Pi documentation (read only';
-// The marker line plus its trailing "- ..." bullets, and any leading blank
-// lines so the surrounding prompt closes up cleanly.
-const PI_DOCS_BLOCK = /\n*^Pi documentation \(read only[^\n]*:(?:\n[ \t]*-[^\n]*)*/m;
-/** Strip pi's self-references from an assembled system prompt. */
-export function scrubPromptSelfReference(systemPrompt) {
-    let prompt = systemPrompt;
-    if (prompt.includes(PI_IDENTITY))
-        prompt = prompt.replace(PI_IDENTITY, NEUTRAL_IDENTITY);
-    if (prompt.includes(PI_DOCS_MARKER))
-        prompt = `${prompt.replace(PI_DOCS_BLOCK, '').trimEnd()}\n`;
-    return prompt;
-}
-/** Register the system-prompt scrub for a canvas node. */
-export function registerCanvasPromptScrub(pi) {
-    const nodeId = envNodeId();
-    if (nodeId === undefined || nodeId.trim() === '')
-        return;
-    pi.on('before_agent_start', (event) => {
-        const scrubbed = scrubPromptSelfReference(event.systemPrompt);
-        if (scrubbed === event.systemPrompt)
-            return;
-        return { systemPrompt: scrubbed };
-    });
-}
-export default registerCanvasPromptScrub;
+var i=Object.defineProperty;var t=(n,e)=>i(n,"name",{value:e,configurable:!0});import{envNodeId as a}from"../shared/env.js";const s="You are an expert coding assistant operating inside pi, a coding agent harness.",c="You are an expert coding assistant.",d="Pi documentation (read only",p=/\n*^Pi documentation \(read only[^\n]*:(?:\n[ \t]*-[^\n]*)*/m;function u(n){let e=n;return e.includes(s)&&(e=e.replace(s,c)),e.includes(d)&&(e=`${e.replace(p,"").trimEnd()}
+`),e}t(u,"scrubPromptSelfReference");function m(n){const e=a();e===void 0||e.trim()===""||n.on("before_agent_start",r=>{const o=u(r.systemPrompt);if(o!==r.systemPrompt)return{systemPrompt:o}})}t(m,"registerCanvasPromptScrub");var l=m;export{l as default,m as registerCanvasPromptScrub,u as scrubPromptSelfReference};