@north-light/crouter 0.3.318 → 0.3.320

package/dist/core/runtime/broker/engine-drive.js

@@ -1,354 +1 @@
-import { emitEvent } from '../../events/emit.js';
-import { operationIdContext } from '../../events/operation-id.js';
-import { parkSummaryGraceMs } from '../../../shared/env.js';
-import { headlessTurn } from '../headless-pi.js';
-import { completeBrokerPark, recordBrokerParkActivity } from './daemon-ops.js';
-import { promptWithAdvertisedCommandInvocation } from '../advertised-command-invocation.js';
-import { heldDeferredInboxPromptJoin } from './held-deferred-inbox.js';
-import { announceMessageOrigin } from '../stamp/channel.js';
-import { chooseGuidanceDeliveryMode, promptWithNextTurnGuidance, resolveEngineRoute, resolveSteerCall, } from './engine-routing.js';
-export function createEngineDriver(deps) {
-    const { nodeId, registry, replies, session, dispatches, memoryRefs, authReloadGate, rebind, projection, toolGroups, turnAdmission, } = deps;
-    const { ackTo, engineErrorTo } = replies;
-    const errorRelay = (client) => {
-        let failure;
-        return {
-            relay: (err) => {
-                failure = err;
-                registry.sendFrame(client, {
-                    type: 'error',
-                    code: 'engine_error',
-                    message: String(err),
-                });
-            },
-            failure: () => failure,
-        };
-    };
-    // Hidden `crtr-memory-refs` guidance rides ALONGSIDE the human frame's own
-    // engine call, never rewriting `frame.text` — see MemoryRefGuidance /
-    // chooseGuidanceDeliveryMode. A failed SEND (as opposed to a failed
-    // resolve, handled above) is likewise logged-and-swallowed: it must never
-    // reach the error relay, which is reserved for the human call's own outcome.
-    const sendGuidance = (guidance, deliverAs) => session()
-        .sendCustomMessage({ customType: 'crtr-memory-refs', content: guidance, display: false }, { deliverAs })
-        .catch((err) => {
-        emitEvent({
-            level: 'warn',
-            event: 'broker.memory_refs.guidance_send_failed',
-            error: err,
-        });
-    });
-    let parkingSummaryInFlight = false;
-    const recordParkActivityBeforeInput = async () => {
-        if (!parkingSummaryInFlight)
-            return;
-        const result = await recordBrokerParkActivity(nodeId);
-        if (result.activity !== 'recorded') {
-            throw new Error('parking completion took priority before input admission');
-        }
-    };
-    const runParkTurn = (text) => {
-        parkingSummaryInFlight = true;
-        const liveSession = session();
-        const model = liveSession.model;
-        const source = liveSession.sessionManager;
-        const run = model === undefined || typeof model.provider !== 'string' || typeof model.id !== 'string'
-            ? Promise.resolve('failed')
-            : headlessTurn({
-                systemPrompt: liveSession.systemPrompt,
-                userPrompt: text,
-                modelSpec: `${model.provider}/${model.id}`,
-                timeoutMs: parkSummaryGraceMs(),
-                seedMessages: source.buildSessionContext().messages,
-                sessionId: source.getSessionId(),
-                toolPolicy: 'builtin',
-            });
-        void run
-            .catch(() => 'failed')
-            .then((outcome) => completeBrokerPark(nodeId, { outcome }))
-            .then((directive) => {
-            if (directive.action === 'shutdown')
-                rebind.requestShutdown();
-        })
-            .catch((error) => {
-            emitEvent({ level: 'error', event: 'broker.park.complete_failed', error });
-        })
-            .finally(() => {
-            parkingSummaryInFlight = false;
-        });
-    };
-    const drivePromptOrFollowUp = (client, frame, errors) => {
-        const relayError = errors.relay;
-        // Settle on the engine call's outcome: the failure is set by relayError
-        // before the caught promise resolves, so reading it after the chain is
-        // the call's verdict.
-        const settle = (p) => p.then(() => errors.failure());
-        const drive = (release) => {
-            // A prior prompt can be in asynchronous preflight while isStreaming is
-            // false. Admission waits for that preflight, then routes against the
-            // state it actually established instead of its stale snapshot.
-            const route = resolveEngineRoute(frame, session().isStreaming);
-            const promptOptions = route.call === 'prompt' ? route.options : undefined;
-            const guidance = memoryRefs.guidanceFor(frame.text);
-            const announceDelivery = () => {
-                if (frame.delivery?.origin === undefined)
-                    return;
-                announceMessageOrigin(frame.text, frame.delivery.origin);
-            };
-            const prompt = async () => {
-                // Both human surfaces converge at this admitted boundary. The watcher
-                // claims held deferred mail before the prompt body, but its cursor stays
-                // uncommitted until the resulting turn's agent_settled event.
-                if (route.call === 'prompt' && !session().isStreaming) {
-                    try {
-                        await heldDeferredInboxPromptJoin()?.(session());
-                    }
-                    catch {
-                        // The watcher emitted the failed durable delivery and retains it for
-                        // replay. A person's live prompt is not replayable, so it must run.
-                    }
-                }
-                announceDelivery();
-                await session().prompt(frame.text, { ...promptOptions, preflightResult: release });
-            };
-            if (guidance === null) {
-                if (route.call === 'prompt') {
-                    // A routed prompt STARTS a turn — including an idle follow_up
-                    // escalated by m-C — so it gets a fresh operation id. A true
-                    // (mid-stream) followUp rides the current turn's operation, like
-                    // steer.
-                    return settle(dispatches.track(operationIdContext.fresh(() => promptWithAdvertisedCommandInvocation(session(), frame.text, prompt).catch(relayError))));
-                }
-                // C1: pi's followUp() takes images as a POSITIONAL 2nd arg (`followUp(text, images?)`).
-                release();
-                return settle(session().followUp(frame.text, frame.images).catch(relayError));
-            }
-            const deliverAs = chooseGuidanceDeliveryMode(frame.type, route.call, session().isStreaming);
-            if (route.call === 'prompt') {
-                if (deliverAs === 'nextTurn') {
-                    // The ONLY ordering where guidance precedes the human call — pi's
-                    // prompt() reads+clears its pending-nextTurn queue synchronously
-                    // at call time, injecting it into the SAME turn as the new user
-                    // message. promptWithNextTurnGuidance queues the guidance and then
-                    // ATOMICALLY clears its own pending entry if prompt() settles
-                    // without ever reaching that drain (an early throw/return leaves
-                    // nothing stranded to leak into a later, unrelated turn).
-                    return settle(dispatches.track(promptWithNextTurnGuidance(session(), guidance, () => operationIdContext.fresh(() => promptWithAdvertisedCommandInvocation(session(), frame.text, prompt))).catch(relayError)));
-                }
-                return settle(dispatches.track(operationIdContext.fresh(() => promptWithAdvertisedCommandInvocation(session(), frame.text, prompt)
-                    .catch(relayError)
-                    .then(() => sendGuidance(guidance, deliverAs)))));
-            }
-            // deliverAs is always 'followUp' here per chooseGuidanceDeliveryMode's
-            // contract (a followUp routeCall never yields 'nextTurn').
-            release();
-            return settle(session()
-                .followUp(frame.text, frame.images)
-                .catch(relayError)
-                .then(() => sendGuidance(guidance, deliverAs)));
-        };
-        const dispatch = () => turnAdmission.admit((release) => {
-            // Do not make the normal path async: prompt admission and auth reload
-            // ordering depend on Pi seeing this call in the current stack.
-            if (!parkingSummaryInFlight)
-                return drive(release);
-            // This operation is the input-admission half of an in-flight parking
-            // summary: it completes before Pi receives the prompt, so completion
-            // cannot tear down a viewer or live delivery that won admission.
-            return recordParkActivityBeforeInput().then(() => drive(release), (error) => {
-                relayError(error);
-                return errors.failure();
-            });
-        });
-        // /login acknowledges before its asynchronous local refresh completes.
-        // An idle turn must not overtake that refresh and launch on the stale
-        // route; true mid-stream follow-ups keep their immediate queue behavior.
-        const authReload = session().isStreaming
-            ? undefined
-            : authReloadGate.inFlight();
-        if (authReload === undefined)
-            return dispatch();
-        const waitingGeneration = rebind.installedGeneration();
-        const waitingSession = session();
-        return authReload.then(() => {
-            if (rebind.installedGeneration() !== waitingGeneration ||
-                session() !== waitingSession) {
-                relayError(new Error('session changed while prompt waited for authentication reload'));
-                return errors.failure();
-            }
-            return dispatch();
-        });
-    };
-    /**
-     * `prompt { interrupt: true }` is one atomic viewer intention: end whatever
-     * is producing now, then start this as a new turn. A normal mid-stream
-     * prompt deliberately steers into pi's queue; the whip must not.
-     */
-    const driveInterruptPrompt = (client, frame, errors) => (async () => {
-        if (session().isBashRunning) {
-            session().abortBash();
-        }
-        else {
-            // A prompt can be in pi's async setup before isStreaming flips. Match
-            // the correlated interrupt's guard so a whip cannot silently miss it.
-            await dispatches.waitUntilAbortable();
-            if (session().isStreaming)
-                await session().abort();
-        }
-        return drivePromptOrFollowUp(client, {
-            type: 'prompt',
-            text: frame.text,
-            ...(frame.images !== undefined ? { images: frame.images } : {}),
-        }, errorRelay(client));
-    })().catch((err) => {
-        errors.relay(err);
-        return errors.failure();
-    });
-    /**
-     * A viewer submits ordinary text as `steer` while the agent is running,
-     * including a slash command injected by the tmux prefix menu. pi's steer()
-     * deliberately rejects registered extension commands because they cannot be
-     * queued; prompt() performs the command preflight first and executes it
-     * immediately even while streaming. It also expands a matching
-     * skill/template before applying the same steer behavior.
-     */
-    const driveSteer = (frame, errors) => {
-        const relayError = errors.relay;
-        const drive = (release) => {
-            if (resolveSteerCall(frame.text, session()) === 'prompt') {
-                return promptWithAdvertisedCommandInvocation(session(), frame.text, () => session().prompt(frame.text, {
-                    images: frame.images,
-                    streamingBehavior: 'steer',
-                    preflightResult: release,
-                }));
-            }
-            release();
-            const guidance = memoryRefs.guidanceFor(frame.text);
-            // C1: pi's steer() takes images as a POSITIONAL 2nd arg (`steer(text, images?)`).
-            if (guidance === null)
-                return session().steer(frame.text, frame.images);
-            return session()
-                .steer(frame.text, frame.images)
-                .then(() => sendGuidance(guidance, 'steer'));
-        };
-        void turnAdmission.admit((release) => {
-            if (!parkingSummaryInFlight)
-                return drive(release);
-            return recordParkActivityBeforeInput().then(() => drive(release), (error) => {
-                relayError(error);
-            });
-        }).catch(relayError);
-    };
-    /**
-     * esc/abort cancels whatever is live: a running `!` command (abortBash)
-     * takes precedence over the agent turn, mirroring pi interactive mode.
-     */
-    const driveAbort = (client, frame, errors) => {
-        if (session().isBashRunning) {
-            session().abortBash();
-            if (frame.id !== undefined)
-                ackTo(client, 'abort', true, 'bash', frame.id);
-            return;
-        }
-        if (frame.id === undefined) {
-            // A viewer's Esc — unchanged instant semantics, no ack.
-            void session().abort().catch(errors.relay);
-            return;
-        }
-        // An id-bearing abort (a one-shot daemon interrupt) must close the
-        // pre-turn window: a routed deliver whose prompt() is still in async
-        // setup reads as idle and abort() would silently miss it. If a prompt
-        // dispatch is pending, wait (bounded) for the run to become abortable
-        // — or for every dispatch to settle without one (an early return) —
-        // then abort and ack with what was actually interrupted.
-        void (async () => {
-            try {
-                await dispatches.waitUntilAbortable();
-                const detail = session().isStreaming ? 'turn' : 'idle';
-                await session().abort();
-                ackTo(client, 'abort', true, detail, frame.id);
-            }
-            catch (err) {
-                engineErrorTo(client, frame.id)(err);
-            }
-        })();
-    };
-    /**
-     * `!`/`!!` bash: run via session.executeBash (records a bashExecution context
-     * message, starts NO agent turn) and relay its lifecycle to ALL viewers as
-     * bash_start/bash_output/bash_end so each renders the live component.
-     * Serialized like pi's interactive mode — reject a second `!` while one is
-     * already running rather than racing _bashAbortController.
-     */
-    const driveBash = (client, frame, errors) => {
-        const command = frame.command;
-        if (command.trim() === '')
-            return;
-        if (session().isBashRunning) {
-            registry.sendFrame(client, {
-                type: 'error',
-                code: 'bash_busy',
-                message: 'A bash command is already running',
-            });
-            return;
-        }
-        const exclude = frame.excludeFromContext === true;
-        // Order before any held assistant message_update, so a `!` run mid-stream
-        // never renders ahead of the update it follows.
-        projection.flush();
-        // The live bash component is a visible transcript boundary, even though
-        // its persisted bashExecution message arrives later via the session.
-        toolGroups.finishOpenToolGroup();
-        registry.broadcast({
-            type: 'bash_start',
-            command,
-            excludeFromContext: exclude,
-        });
-        void session()
-            .executeBash(command, (chunk) => registry.broadcast({ type: 'bash_output', chunk }), { excludeFromContext: exclude })
-            .then((result) => {
-            registry.broadcast({
-                type: 'bash_end',
-                exitCode: result.exitCode,
-                cancelled: result.cancelled,
-                truncated: result.truncated,
-                fullOutputPath: result.fullOutputPath,
-            });
-        })
-            .catch(errors.relay);
-    };
-    /**
-     * Drive the engine for one client frame. For a prompt/follow_up frame this
-     * returns a promise that settles with the engine call's OUTCOME — `undefined`
-     * when the call succeeded, the rejection value when it did not — so a caller
-     * that must report success (the `deliver` ack) can read it instead of assuming
-     * the dispatch worked. Every other frame type keeps the fire-and-forget shape
-     * and returns `undefined`.
-     */
-    return (client, frame) => {
-        if ((frame.type === 'prompt' || frame.type === 'follow_up')
-            && frame.delivery?.origin?.type === 'runtime'
-            && frame.delivery.origin.kind === 'park') {
-            runParkTurn(frame.text);
-            return undefined;
-        }
-        const errors = errorRelay(client);
-        switch (frame.type) {
-            case 'prompt':
-                return frame.interrupt === true
-                    ? driveInterruptPrompt(client, frame, errors)
-                    : drivePromptOrFollowUp(client, frame, errors);
-            case 'follow_up':
-                return drivePromptOrFollowUp(client, frame, errors);
-            case 'steer':
-                driveSteer(frame, errors);
-                return undefined;
-            case 'abort':
-                driveAbort(client, frame, errors);
-                return undefined;
-            case 'bash':
-                driveBash(client, frame, errors);
-                return undefined;
-        }
-    };
-}
+var z=Object.defineProperty;var s=(y,h)=>z(y,"name",{value:h,configurable:!0});import{emitEvent as R}from"../../events/emit.js";import{operationIdContext as k}from"../../events/operation-id.js";import{parkSummaryGraceMs as H}from"../../../shared/env.js";import{headlessTurn as K}from"../headless-pi.js";import{completeBrokerPark as L,recordBrokerParkActivity as Q}from"./daemon-ops.js";import{promptWithAdvertisedCommandInvocation as g}from"../advertised-command-invocation.js";import{heldDeferredInboxPromptJoin as V}from"./held-deferred-inbox.js";import{announceMessageOrigin as X}from"../stamp/channel.js";import{chooseGuidanceDeliveryMode as Y,promptWithNextTurnGuidance as Z,resolveEngineRoute as tt,resolveSteerCall as et}from"./engine-routing.js";function pt(y){const{nodeId:h,registry:u,replies:A,session:r,dispatches:l,memoryRefs:S,authReloadGate:I,rebind:f,projection:E,toolGroups:T,turnAdmission:P}=y,{ackTo:B,engineErrorTo:M}=A,_=s(e=>{let t;return{relay:s(n=>{t=n,u.sendFrame(e,{type:"error",code:"engine_error",message:String(n)})},"relay"),failure:s(()=>t,"failure")}},"errorRelay"),v=s((e,t)=>r().sendCustomMessage({customType:"crtr-memory-refs",content:e,display:!1},{deliverAs:t}).catch(n=>{R({level:"warn",event:"broker.memory_refs.guidance_send_failed",error:n})}),"sendGuidance");let p=!1;const C=s(async()=>{if(!p)return;if((await Q(h)).activity!=="recorded")throw new Error("parking completion took priority before input admission")},"recordParkActivityBeforeInput"),O=s(e=>{p=!0;const t=r(),n=t.model,o=t.sessionManager;(n===void 0||typeof n.provider!="string"||typeof n.id!="string"?Promise.resolve("failed"):K({systemPrompt:t.systemPrompt,userPrompt:e,modelSpec:`${n.provider}/${n.id}`,timeoutMs:H(),seedMessages:o.buildSessionContext().messages,sessionId:o.getSessionId(),toolPolicy:"builtin"})).catch(()=>"failed").then(i=>L(h,{outcome:i})).then(i=>{i.action==="shutdown"&&f.requestShutdown()}).catch(i=>{R({level:"error",event:"broker.park.complete_failed",error:i})}).finally(()=>{p=!1})},"runParkTurn"),x=s((e,t,n)=>{const o=n.relay,a=s(c=>c.then(()=>n.failure()),"settle"),i=s(c=>{const d=tt(t,r().isStreaming),J=d.call==="prompt"?d.options:void 0,m=S.guidanceFor(t.text),N=s(()=>{t.delivery?.origin!==void 0&&X(t.text,t.delivery.origin)},"announceDelivery"),b=s(async()=>{if(d.call==="prompt"&&!r().isStreaming)try{await V()?.(r())}catch{}N(),await r().prompt(t.text,{...J,preflightResult:c})},"prompt");if(m===null)return d.call==="prompt"?a(l.track(k.fresh(()=>g(r(),t.text,b).catch(o)))):(c(),a(r().followUp(t.text,t.images).catch(o)));const w=Y(t.type,d.call,r().isStreaming);return d.call==="prompt"?a(w==="nextTurn"?l.track(Z(r(),m,()=>k.fresh(()=>g(r(),t.text,b))).catch(o)):l.track(k.fresh(()=>g(r(),t.text,b).catch(o).then(()=>v(m,w))))):(c(),a(r().followUp(t.text,t.images).catch(o).then(()=>v(m,w))))},"drive"),F=s(()=>P.admit(c=>p?C().then(()=>i(c),d=>(o(d),n.failure())):i(c)),"dispatch"),G=r().isStreaming?void 0:I.inFlight();if(G===void 0)return F();const j=f.installedGeneration(),q=r();return G.then(()=>f.installedGeneration()!==j||r()!==q?(o(new Error("session changed while prompt waited for authentication reload")),n.failure()):F())},"drivePromptOrFollowUp"),U=s((e,t,n)=>(async()=>(r().isBashRunning?r().abortBash():(await l.waitUntilAbortable(),r().isStreaming&&await r().abort()),x(e,{type:"prompt",text:t.text,...t.images!==void 0?{images:t.images}:{}},_(e))))().catch(o=>(n.relay(o),n.failure())),"driveInterruptPrompt"),D=s((e,t)=>{const n=t.relay,o=s(a=>{if(et(e.text,r())==="prompt")return g(r(),e.text,()=>r().prompt(e.text,{images:e.images,streamingBehavior:"steer",preflightResult:a}));a();const i=S.guidanceFor(e.text);return i===null?r().steer(e.text,e.images):r().steer(e.text,e.images).then(()=>v(i,"steer"))},"drive");P.admit(a=>p?C().then(()=>o(a),i=>{n(i)}):o(a)).catch(n)},"driveSteer"),W=s((e,t,n)=>{if(r().isBashRunning){r().abortBash(),t.id!==void 0&&B(e,"abort",!0,"bash",t.id);return}if(t.id===void 0){r().abort().catch(n.relay);return}(async()=>{try{await l.waitUntilAbortable();const o=r().isStreaming?"turn":"idle";await r().abort(),B(e,"abort",!0,o,t.id)}catch(o){M(e,t.id)(o)}})()},"driveAbort"),$=s((e,t,n)=>{const o=t.command;if(o.trim()==="")return;if(r().isBashRunning){u.sendFrame(e,{type:"error",code:"bash_busy",message:"A bash command is already running"});return}const a=t.excludeFromContext===!0;E.flush(),T.finishOpenToolGroup(),u.broadcast({type:"bash_start",command:o,excludeFromContext:a}),r().executeBash(o,i=>u.broadcast({type:"bash_output",chunk:i}),{excludeFromContext:a}).then(i=>{u.broadcast({type:"bash_end",exitCode:i.exitCode,cancelled:i.cancelled,truncated:i.truncated,fullOutputPath:i.fullOutputPath})}).catch(n.relay)},"driveBash");return(e,t)=>{if((t.type==="prompt"||t.type==="follow_up")&&t.delivery?.origin?.type==="runtime"&&t.delivery.origin.kind==="park"){O(t.text);return}const n=_(e);switch(t.type){case"prompt":return t.interrupt===!0?U(e,t,n):x(e,t,n);case"follow_up":return x(e,t,n);case"steer":D(t,n);return;case"abort":W(e,t,n);return;case"bash":$(e,t,n);return}}}s(pt,"createEngineDriver");export{pt as createEngineDriver};

package/dist/core/runtime/broker/engine-routing.js

@@ -1,211 +1 @@
-import { randomUUID } from 'node:crypto';
-import { emitEvent } from '../../events/emit.js';
-/**
- * Route a writable client's `prompt`/`follow_up` frame against the LIVE session
- * state. The client picks its frame type off a possibly-STALE `isStreaming`
- * snapshot, so the broker is authoritative and the client's choice is a HINT:
- *
- *  - m-B (streaming-safe prompt): a `prompt` arriving mid-stream needs
- *    PromptOptions.streamingBehavior ("Required if streaming"; prompt() throws
- *    without it). "steer" mirrors pi interactive-mode's own
- *    Enter-while-streaming submit (`prompt(text, { streamingBehavior: "steer" })`).
- *  - m-C (idle-safe follow_up): pi's followUp() only enqueues into a RUNNING
- *    agent loop — on an idle session nothing ever drains the queue and the text
- *    is silently lost. An idle `follow_up` therefore runs as a prompt now.
- *
- * driveEngine calls this synchronously with `session.isStreaming`, so the
- * routed state cannot go stale between the check and the engine call.
- * C1: images ride as a field on PromptOptions (pi: `prompt(text, { images })`).
- */
-export function resolveEngineRoute(frame, isStreaming) {
-    if (frame.type === 'follow_up' && isStreaming)
-        return { call: 'followUp' };
-    const options = {};
-    if (frame.images !== undefined)
-        options.images = frame.images;
-    if (isStreaming)
-        options.streamingBehavior = 'steer';
-    return { call: 'prompt', options };
-}
-/**
- * True iff `text` would be consumed by pi's OWN leading-name preflight before
- * `session.prompt/steer/followUp` ever sees it as prose — an extension command
- * (`session.extensionRunner.getCommand`), a `/skill:name` skill, or a `/name`
- * prompt template (mirrors `_tryExecuteExtensionCommand` / `_expandSkillCommand`
- * / `expandPromptTemplate` in the pinned SDK verbatim, including the exact
- * name-parsing substrings). Inline memory-reference guidance must NEVER fire
- * for these — the leading token routes to the engine's own command surface,
- * not prose referencing a memory doc. Each lookup is independently wrapped so
- * an engine missing one accessor (the fake, or a degraded session) degrades
- * that check to "not a match" rather than aborting the whole classification —
- * matching `buildCommandList`'s existing "no live extensionRunner" tolerance.
- */
-export function isLeadingEngineCommand(text, session) {
-    if (text.startsWith('/')) {
-        const spaceIndex = text.indexOf(' ');
-        const commandName = spaceIndex === -1 ? text.slice(1) : text.slice(1, spaceIndex);
-        try {
-            if (session.extensionRunner?.getCommand(commandName))
-                return true;
-        }
-        catch {
-            /* engine without a live extensionRunner (e.g. the fake) — not a match */
-        }
-    }
-    if (text.startsWith('/skill:')) {
-        const spaceIndex = text.indexOf(' ');
-        const skillName = spaceIndex === -1 ? text.slice(7) : text.slice(7, spaceIndex);
-        try {
-            if (session.resourceLoader?.getSkills().skills.some((s) => s.name === skillName))
-                return true;
-        }
-        catch {
-            /* engine without a live resourceLoader — not a match */
-        }
-    }
-    if (text.startsWith('/')) {
-        const match = text.match(/^\/([^\s]+)(?:\s+([\s\S]*))?$/);
-        const templateName = match?.[1];
-        if (templateName !== undefined) {
-            try {
-                if (session.promptTemplates?.some((t) => t.name === templateName))
-                    return true;
-            }
-            catch {
-                /* engine without a live promptTemplates getter — not a match */
-            }
-        }
-    }
-    return false;
-}
-/** A `steer` frame normally maps directly to pi's steer queue. Engine commands,
- * skills, and templates must instead pass through prompt()'s leading-command
- * preflight; with streamingBehavior:'steer', ordinary expanded text still lands
- * in the same queue. */
-export function resolveSteerCall(text, session) {
-    return isLeadingEngineCommand(text, session) ? 'prompt' : 'steer';
-}
-/**
- * Enumerate every leading-token STRING this session's engine would
- * independently consume as a leading command/skill/template dispatch BEFORE
- * inline memory-reference guidance ever applies — the read-op sibling of
- * `isLeadingEngineCommand`'s point-lookup, gathered as a full enumeration for
- * viewer-side suppression instead of a per-submission membership check. Same
- * three sources, same shape of the leading match `isLeadingEngineCommand`
- * checks (bare extension-command invocation names and prompt-template names,
- * `skill:<name>` for skills), so `/${token}` round-trips through
- * `isLeadingEngineCommand(text, session)` for every emitted token (locked by
- * a test). Kept STRICTLY separate from `buildCommandList` (command
- * completion) and the ref inventory (`RefMeta` rows) — this is neither.
- */
-export function engineLeadingCommandTokens(session) {
-    const out = [];
-    try {
-        for (const c of session.extensionRunner?.getRegisteredCommands() ?? [])
-            out.push(c.invocationName);
-    }
-    catch {
-        /* engine without a live extensionRunner (e.g. the fake) — none */
-    }
-    try {
-        for (const s of session.resourceLoader?.getSkills().skills ?? [])
-            out.push(`skill:${s.name}`);
-    }
-    catch {
-        /* engine without a live resourceLoader — none */
-    }
-    try {
-        for (const t of session.promptTemplates ?? [])
-            out.push(t.name);
-    }
-    catch {
-        /* engine without a live promptTemplates getter — none */
-    }
-    return out;
-}
-/**
- * Choose how the hidden `crtr-memory-refs` guidance custom message rides
- * alongside a human frame's own engine call (design Flow B). Pure over the
- * frame's routing outcome — never reads live session state itself, so a
- * caller can decide the delivery mode from the exact same `route`
- * `resolveEngineRoute` already computed for the human call.
- *
- *  - `steer` frame              -> 'steer' (always; no route call exists).
- *  - a TRUE mid-stream follow_up (`routeCall === 'followUp'`) -> 'followUp'.
- *  - every other `prompt`/`follow_up` routed as `routeCall === 'prompt'`:
- *    idle -> 'nextTurn' (the ONLY case guidance precedes the human call —
- *    pi's `prompt()` reads+clears its pending-nextTurn queue synchronously
- *    into the SAME turn as the new user message); streaming (m-B
- *    steer-while-streaming) -> 'steer', never 'nextTurn' (that would attach
- *    to a later, unrelated turn).
- */
-export function chooseGuidanceDeliveryMode(frameType, routeCall, isStreaming) {
-    if (frameType === 'steer')
-        return 'steer';
-    if (routeCall === 'followUp')
-        return 'followUp';
-    return isStreaming ? 'steer' : 'nextTurn';
-}
-/**
- * Deliver a `nextTurn` guidance custom message ATOMICALLY around the idle-
- * prompt call it's meant to ride alongside. Pi's `_pendingNextTurnMessages`
- * queue (the only public seam for `deliverAs:'nextTurn'`) is drained ONLY deep
- * inside `session.prompt()`, well after several await points — extension-
- * command interception, the `input` extension transform, a streaming reroute,
- * model/auth validation, pre-turn compaction — that can return or throw BEFORE
- * the drain ever runs. `sendCustomMessage`'s nextTurn branch pushes
- * synchronously and unconditionally, so any of those early exits strands the
- * pushed guidance in the queue to attach itself to whichever LATER, unrelated
- * prompt happens to reach the drain first.
- *
- * There is no public SDK seam to observe or cancel a pending nextTurn message
- * (`_pendingNextTurnMessages` is TS-`private` only — a plain runtime field, not
- * `#private`), so this reaches into that one field and removes EXACTLY the
- * entry this call pushed, identified by object identity via a locally-
- * generated marker riding the message's own `details` field (never surfaced to
- * the model, and irrelevant if the message WAS consumed normally — `details`
- * is just carried through like any other field once folded into a real turn).
- * Runs UNCONDITIONALLY after the human call settles, success or failure/early-
- * return alike — a "successful" `prompt()` promise can just as easily be an
- * early return that skipped the drain (an intercepted extension command, an
- * `input` transform, a streaming reroute) as a genuine consumed turn, so only
- * checking `.catch` is not enough.
- */
-export async function promptWithNextTurnGuidance(session, guidance, runPrompt) {
-    // Must survive Pi's structured-clone step when the queued custom message is
-    // folded into the turn. A Symbol reaches that step in `details` and aborts
-    // the real prompt with "could not be cloned" before the provider runs.
-    const marker = `crtr-memory-refs-pending:${randomUUID()}`;
-    let queued = false;
-    try {
-        await session.sendCustomMessage({ customType: 'crtr-memory-refs', content: guidance, display: false, details: marker }, { deliverAs: 'nextTurn' });
-        queued = true;
-    }
-    catch (err) {
-        emitEvent({
-            level: 'warn',
-            event: 'broker.memory_refs.guidance_send_failed',
-            error: err,
-        });
-    }
-    try {
-        await runPrompt();
-    }
-    finally {
-        if (queued)
-            clearOwnPendingNextTurnGuidance(session, marker);
-    }
-}
-/** Splice out exactly the pending-nextTurn entry `marker` identifies (object-
- *  identity match on `details`), if it is still present — a no-op (and safe)
- *  if `session.prompt()` already drained it normally, or if the session/field
- *  shape doesn't match (defensive against an engine without the field, e.g. a
- *  future SDK bump or a structurally-different test double). */
-function clearOwnPendingNextTurnGuidance(session, marker) {
-    const pending = session._pendingNextTurnMessages;
-    if (!Array.isArray(pending))
-        return;
-    const idx = pending.findIndex((m) => m?.details === marker);
-    if (idx !== -1)
-        pending.splice(idx, 1);
-}
+var a=Object.defineProperty;var i=(e,n)=>a(e,"name",{value:n,configurable:!0});import{randomUUID as c}from"node:crypto";import{emitEvent as l}from"../../events/emit.js";function g(e,n){if(e.type==="follow_up"&&n)return{call:"followUp"};const r={};return e.images!==void 0&&(r.images=e.images),n&&(r.streamingBehavior="steer"),{call:"prompt",options:r}}i(g,"resolveEngineRoute");function u(e,n){if(e.startsWith("/")){const r=e.indexOf(" "),t=r===-1?e.slice(1):e.slice(1,r);try{if(n.extensionRunner?.getCommand(t))return!0}catch{}}if(e.startsWith("/skill:")){const r=e.indexOf(" "),t=r===-1?e.slice(7):e.slice(7,r);try{if(n.resourceLoader?.getSkills().skills.some(o=>o.name===t))return!0}catch{}}if(e.startsWith("/")){const t=e.match(/^\/([^\s]+)(?:\s+([\s\S]*))?$/)?.[1];if(t!==void 0)try{if(n.promptTemplates?.some(o=>o.name===t))return!0}catch{}}return!1}i(u,"isLeadingEngineCommand");function h(e,n){return u(e,n)?"prompt":"steer"}i(h,"resolveSteerCall");function y(e){const n=[];try{for(const r of e.extensionRunner?.getRegisteredCommands()??[])n.push(r.invocationName)}catch{}try{for(const r of e.resourceLoader?.getSkills().skills??[])n.push(`skill:${r.name}`)}catch{}try{for(const r of e.promptTemplates??[])n.push(r.name)}catch{}return n}i(y,"engineLeadingCommandTokens");function k(e,n,r){return e==="steer"?"steer":n==="followUp"?"followUp":r?"steer":"nextTurn"}i(k,"chooseGuidanceDeliveryMode");async function x(e,n,r){const t=`crtr-memory-refs-pending:${c()}`;let o=!1;try{await e.sendCustomMessage({customType:"crtr-memory-refs",content:n,display:!1,details:t},{deliverAs:"nextTurn"}),o=!0}catch(s){l({level:"warn",event:"broker.memory_refs.guidance_send_failed",error:s})}try{await r()}finally{o&&m(e,t)}}i(x,"promptWithNextTurnGuidance");function m(e,n){const r=e._pendingNextTurnMessages;if(!Array.isArray(r))return;const t=r.findIndex(o=>o?.details===n);t!==-1&&r.splice(t,1)}i(m,"clearOwnPendingNextTurnGuidance");export{k as chooseGuidanceDeliveryMode,y as engineLeadingCommandTokens,u as isLeadingEngineCommand,x as promptWithNextTurnGuidance,g as resolveEngineRoute,h as resolveSteerCall};