@north-light/crouter 0.3.318 → 0.3.320

package/dist/core/runtime/broker/rebind.js

@@ -1,318 +1 @@
-import { mkdirSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { jobDir } from '../../canvas/paths.js';
-import { emitEvent } from '../../events/emit.js';
-import { operationIdContext } from '../../events/operation-id.js';
-import { installPersonaTransitionGate } from '../broker-persona-guidance.js';
-import { abortSessionFromExtension } from './extension-abort.js';
-import { brokerRecovery, mutateBrokerFault, mutateBrokerProviderRetry } from './daemon-ops.js';
-const MAX_ADMITTED_REPLACEMENTS = 2;
-const REPLACEMENT_DEADLINE_MS = 30_000;
-const REPLACEMENT_DEADLINE_EXCEEDED = Symbol('replacement-deadline-exceeded');
-const TRAILING_THINKING_PLACEHOLDER = '(interrupted)';
-const TRAILING_THINKING_GUARD = Symbol.for('crtr.trailing-thinking-guard');
-/** The last block an Anthropic request will actually carry: the serializer
- *  drops whitespace-only text and signature-less empty thinking. */
-function lastSerializedBlock(content) {
-    for (let i = content.length - 1; i >= 0; i--) {
-        const block = content[i];
-        if (block === undefined)
-            continue;
-        if (block.type === 'text') {
-            if (block.text.trim().length === 0)
-                continue;
-            return block;
-        }
-        if (block.type === 'thinking') {
-            const signature = block.thinkingSignature;
-            const hasSignature = typeof signature === 'string' && signature.trim().length > 0;
-            if (block.redacted !== true && block.thinking.trim().length === 0 && !hasSignature)
-                continue;
-            return block;
-        }
-        return block;
-    }
-    return undefined;
-}
-function guardTrailingThinking(messages) {
-    return messages.map((message) => {
-        if (message.role !== 'assistant')
-            return message;
-        if (lastSerializedBlock(message.content)?.type !== 'thinking')
-            return message;
-        return { ...message, content: [...message.content, { type: 'text', text: TRAILING_THINKING_PLACEHOLDER }] };
-    });
-}
-/** Crouter aborts live streams (watchdog, extension abort, viewer esc), which
- *  persists assistant turns that end on a thinking block. Anthropic rejects a
- *  request whose final assistant block is `thinking`, and pi-ai's serializer
- *  has no guard for it, so every later turn re-fails on embedded history. */
-function installTrailingThinkingGuard(agent) {
-    const inner = agent.convertToLlm;
-    if (inner[TRAILING_THINKING_GUARD] === true)
-        return;
-    const wrapped = (messages) => {
-        const converted = inner(messages);
-        return converted instanceof Promise ? converted.then(guardTrailingThinking) : guardTrailingThinking(converted);
-    };
-    wrapped[TRAILING_THINKING_GUARD] = true;
-    agent.convertToLlm = wrapped;
-}
-/** Owns session subscription replacement, its serialization lane, and replacement admission policy. */
-export class RebindDriver {
-    deps;
-    sessionValue;
-    servicesValue;
-    unsubscribe;
-    installed;
-    nextSubscriptionGeneration = 0;
-    rebindTail = Promise.resolve();
-    latestRebindRequest = 0;
-    replacementTail = Promise.resolve();
-    admittedReplacements = 0;
-    agentRunActiveValue = false;
-    shutdownRequested = false;
-    constructor(deps) {
-        this.deps = deps;
-        this.sessionValue = deps.session;
-        this.servicesValue = deps.services;
-    }
-    session() { return this.sessionValue; }
-    services() { return this.servicesValue; }
-    installedGeneration() { return this.installed; }
-    isAgentRunActive() { return this.agentRunActiveValue; }
-    requestShutdown() {
-        if (!this.agentRunActiveValue) {
-            this.deps.disposeAndExit('shutdown-hook');
-            return;
-        }
-        this.shutdownRequested = true;
-    }
-    setRebindSession() {
-        this.deps.runtime?.setRebindSession((candidateSession) => this.enqueueRebind(candidateSession, this.deps.runtime.services));
-    }
-    enqueueRebind(candidateSession, candidateServices) {
-        const ticket = ++this.latestRebindRequest;
-        const task = this.rebindTail.then(async () => {
-            if (ticket !== this.latestRebindRequest)
-                return;
-            // A replacement changes the conversation coordinate. The initial bind has
-            // no prior generation and must retain a crash-surviving pending episode;
-            // every later rebind explicitly marks the old session's episode invalid.
-            if (this.installed !== undefined) {
-                if (typeof this.sessionValue.sessionFile === 'string' && this.sessionValue.sessionFile !== '') {
-                    await mutateBrokerProviderRetry(this.deps.nodeId, { op: 'invalidate', session_id: this.sessionValue.sessionManager.getSessionId() });
-                }
-                // A daemon-owned auto marker belongs to the outgoing session whether
-                // that session has a durable path or not. Retaining it lets the
-                // replacement inherit an old anchor, attempts, and backoff; fatal and
-                // manual markers stay visible.
-                const fault = (await brokerRecovery(this.deps.nodeId)).fault;
-                if (fault?.link === 'pi→provider' && fault.retry.disposition === 'auto' && fault.retry.by === 'daemon') {
-                    await mutateBrokerFault(this.deps.nodeId, { op: 'clear', link: 'pi→provider', preserve_episode: true });
-                }
-            }
-            this.installed?.executingTools.clear();
-            this.removeInstalledSubscription();
-            this.deps.setActiveSession(candidateSession);
-            this.deps.projection().reset();
-            this.deps.faultRetry().reset();
-            this.agentRunActiveValue = false;
-            this.deps.onSessionRebind();
-            this.deps.toolGroups.resetForSession();
-            await candidateSession.bindExtensions({
-                uiContext: this.deps.uiContext(),
-                mode: 'rpc',
-                abortHandler: () => abortSessionFromExtension(candidateSession, () => {
-                    const generation = this.installed;
-                    if (generation?.session === candidateSession)
-                        generation.stagedRefreshAbort = true;
-                }),
-                shutdownHandler: () => this.requestShutdown(),
-            });
-            if (ticket !== this.latestRebindRequest)
-                return;
-            this.removeInstalledSubscription();
-            this.sessionValue = candidateSession;
-            this.servicesValue = candidateServices;
-            // Queue modes 'all': at each drain point pi injects EVERY queued steering/
-            // follow-up message in one drain, instead of the default one-at-a-time
-            // (which held a second queued message back a whole assistant response).
-            // Set directly on the public `session.agent` fields — exactly what pi's
-            // own syncQueueModesFromSettings() does minus the shared settings.json
-            // write. Applied here so boot AND every rebind/replacement get it; pi
-            // resets the modes from settings only inside reload(), which re-applies
-            // them at its call site (frame-dispatch). Structurally guarded: the
-            // fake-engine fixture has no `.agent`.
-            const agent = candidateSession.agent;
-            if (agent) {
-                installPersonaTransitionGate(this.deps.nodeId, {
-                    agent,
-                    sessionManager: candidateSession.sessionManager,
-                }, () => this.deps.faultRetry().notePersonaGateFailure());
-                agent.steeringMode = 'all';
-                agent.followUpMode = 'all';
-                installTrailingThinkingGuard(agent);
-            }
-            if (this.deps.cfg.editorName !== undefined && this.deps.cfg.editorName !== '') {
-                try {
-                    candidateSession.setSessionName(this.deps.cfg.editorName);
-                }
-                catch {
-                    /* non-fatal: naming is cosmetic */
-                }
-            }
-            const generation = {
-                id: ++this.nextSubscriptionGeneration,
-                session: candidateSession,
-                fallback: { blocked: false },
-                stagedProviderAgentEnd: null,
-                stagedWatchdogAbort: false,
-                stagedRefreshAbort: false,
-                stagedOverflowFailure: null,
-                executingTools: new Set(),
-            };
-            this.unsubscribe = this.sessionValue.subscribe((event) => {
-                if (!this.deps.projection().isCurrent(generation))
-                    return;
-                const ambientId = operationIdContext.current();
-                if (ambientId !== undefined) {
-                    this.executeSubscriptionCallback(generation, event);
-                    return;
-                }
-                const fallback = generation.fallback;
-                if (event.type === 'turn_start' && fallback.storedId !== undefined) {
-                    fallback.storedId = undefined;
-                    fallback.blocked = true;
-                    operationIdContext.fresh(() => {
-                        emitEvent({ level: 'warn', event: 'broker.turn.fallback_overlap', fields: { generation: generation.id, engine_event: event.type } });
-                        this.executeSubscriptionCallback(generation, event);
-                    });
-                    return;
-                }
-                if (event.type === 'turn_start' && !fallback.blocked) {
-                    operationIdContext.fresh((operationId) => {
-                        fallback.storedId = operationId;
-                        this.executeSubscriptionCallback(generation, event);
-                    });
-                    return;
-                }
-                const storedId = fallback.storedId;
-                if (storedId !== undefined && !fallback.blocked) {
-                    operationIdContext.run(storedId, () => {
-                        this.executeSubscriptionCallback(generation, event);
-                        if (event.type === 'agent_settled' && fallback.storedId === storedId)
-                            fallback.storedId = undefined;
-                    });
-                    return;
-                }
-                this.executeSubscriptionCallback(generation, event);
-            });
-            this.installed = generation;
-            this.deps.projection().rearmIfStreaming(generation);
-            this.captureSystemPrompt(candidateSession);
-        });
-        this.rebindTail = task.catch(() => undefined);
-        return task;
-    }
-    runReplacement(client, op, run) {
-        const runtime = this.deps.runtime;
-        if (runtime === undefined) {
-            this.deps.registry.sendFrame(client, { type: 'error', code: 'engine_error', message: 'session replacement unsupported at this engine pin' });
-            return;
-        }
-        if (this.admittedReplacements >= MAX_ADMITTED_REPLACEMENTS) {
-            operationIdContext.fresh(() => emitEvent({ level: 'warn', event: 'broker.session_replacement.rejected', outcome: 'skipped', fields: { op, reason: 'capacity', admitted: MAX_ADMITTED_REPLACEMENTS, cap: MAX_ADMITTED_REPLACEMENTS } }));
-            this.ackTo(client, op, false, `session replacement busy (${MAX_ADMITTED_REPLACEMENTS} active or queued)`);
-            return;
-        }
-        this.admittedReplacements++;
-        const task = this.replacementTail.then(async () => {
-            try {
-                await operationIdContext.fresh(async () => {
-                    const startedAt = process.hrtime.bigint();
-                    let timer;
-                    try {
-                        const deadline = new Promise((resolve) => { timer = setTimeout(() => resolve(REPLACEMENT_DEADLINE_EXCEEDED), REPLACEMENT_DEADLINE_MS); });
-                        const outcome = await Promise.race([run(runtime), deadline]);
-                        if (outcome === REPLACEMENT_DEADLINE_EXCEEDED) {
-                            emitEvent({ level: 'error', event: 'broker.session_replacement.timed_out', outcome: 'failed', duration_ms: Number(process.hrtime.bigint() - startedAt) / 1_000_000, fields: { op, deadline_ms: REPLACEMENT_DEADLINE_MS, mutation_outcome: 'indeterminate' } });
-                            this.ackTo(client, op, false, 'session replacement timed out; broker restarting because session state is indeterminate');
-                            this.deps.disposeAndExit('session-replacement-timeout', 1);
-                            return;
-                        }
-                        if (!outcome.cancelled)
-                            this.deps.reWelcomeAll();
-                        this.ackTo(client, op, !outcome.cancelled, outcome.cancelled ? outcome.detail ?? 'cancelled by extension' : undefined);
-                    }
-                    catch (err) {
-                        emitEvent({ level: 'error', event: 'broker.session_replacement.failed', outcome: 'failed', error: err, fields: { op, mutation_outcome: 'indeterminate' } });
-                        this.ackTo(client, op, false, 'session replacement failed; broker restarting because session state is indeterminate');
-                        this.deps.disposeAndExit('session-replacement-failed', 1);
-                    }
-                    finally {
-                        clearTimeout(timer);
-                    }
-                });
-            }
-            finally {
-                this.admittedReplacements--;
-            }
-        });
-        this.replacementTail = task.catch(() => undefined);
-    }
-    removeInstalledSubscription() {
-        this.unsubscribe?.();
-        this.unsubscribe = undefined;
-        this.installed = undefined;
-    }
-    captureSystemPrompt(candidateSession) {
-        try {
-            const dir = jobDir(this.deps.nodeId);
-            mkdirSync(dir, { recursive: true });
-            writeFileSync(join(dir, 'system-prompt.md'), candidateSession.systemPrompt, 'utf8');
-        }
-        catch {
-            /* non-fatal: diagnostic only */
-        }
-    }
-    executeSubscriptionCallback(generation, event) {
-        try {
-            if (event.type === 'agent_start')
-                this.agentRunActiveValue = true;
-            if (event.type === 'agent_end') {
-                generation.stagedProviderAgentEnd = event;
-                generation.stagedOverflowFailure = null;
-            }
-            if (event.type === 'compaction_end' && event.reason === 'overflow' && event.willRetry === false && typeof event.errorMessage === 'string')
-                generation.stagedOverflowFailure = { errorMessage: event.errorMessage };
-            if (event.type === 'agent_settled') {
-                this.agentRunActiveValue = false;
-                void this.publishAndScheduleProviderRecovery(generation);
-            }
-            this.deps.toolGroups.observeToolGroupEvent(event);
-            this.deps.projection().relayEvent(event, generation);
-        }
-        catch (err) {
-            emitEvent({ level: 'debug', event: 'broker.runtime.diagnostic', fields: { message: `event relay threw: ${String(err)}` } });
-        }
-    }
-    async publishAndScheduleProviderRecovery(generation) {
-        try {
-            await this.deps.faultRetry().publishSettledProviderFault(generation);
-            if (this.shutdownRequested) {
-                this.deps.disposeAndExit('shutdown-after-settle');
-                return;
-            }
-            await this.deps.faultRetry().schedule();
-        }
-        catch (error) {
-            emitEvent({ level: 'error', event: 'broker.daemon.operation.failed', node_id: this.deps.nodeId, error, fields: { operation: 'provider_fault_settlement' } });
-            if (this.shutdownRequested)
-                this.deps.disposeAndExit('shutdown-after-settle');
-        }
-    }
-    ackTo(client, op, ok = true, detail, id) {
-        this.deps.registry.sendFrame(client, { type: 'ack', for: op, ok, ...(detail !== undefined ? { detail } : {}), ...(id !== undefined ? { id } : {}) });
-    }
-}
+var R=Object.defineProperty;var l=(a,e)=>R(a,"name",{value:e,configurable:!0});import{mkdirSync as v,writeFileSync as _}from"node:fs";import{join as A}from"node:path";import{jobDir as E}from"../../canvas/paths.js";import{emitEvent as u}from"../../events/emit.js";import{operationIdContext as c}from"../../events/operation-id.js";import{installPersonaTransitionGate as I}from"../broker-persona-guidance.js";import{abortSessionFromExtension as T}from"./extension-abort.js";import{brokerRecovery as w,mutateBrokerFault as S,mutateBrokerProviderRetry as x}from"./daemon-ops.js";const f=2,m=3e4,b=Symbol("replacement-deadline-exceeded"),P="(interrupted)",g=Symbol.for("crtr.trailing-thinking-guard");function V(a){for(let e=a.length-1;e>=0;e--){const t=a[e];if(t!==void 0){if(t.type==="text"){if(t.text.trim().length===0)continue;return t}if(t.type==="thinking"){const n=t.thinkingSignature,r=typeof n=="string"&&n.trim().length>0;if(t.redacted!==!0&&t.thinking.trim().length===0&&!r)continue;return t}return t}}}l(V,"lastSerializedBlock");function y(a){return a.map(e=>e.role!=="assistant"||V(e.content)?.type!=="thinking"?e:{...e,content:[...e.content,{type:"text",text:P}]})}l(y,"guardTrailingThinking");function N(a){const e=a.convertToLlm;if(e[g]===!0)return;const t=l(n=>{const r=e(n);return r instanceof Promise?r.then(y):y(r)},"wrapped");t[g]=!0,a.convertToLlm=t}l(N,"installTrailingThinkingGuard");class O{static{l(this,"RebindDriver")}deps;sessionValue;servicesValue;unsubscribe;installed;nextSubscriptionGeneration=0;rebindTail=Promise.resolve();latestRebindRequest=0;replacementTail=Promise.resolve();admittedReplacements=0;agentRunActiveValue=!1;shutdownRequested=!1;constructor(e){this.deps=e,this.sessionValue=e.session,this.servicesValue=e.services}session(){return this.sessionValue}services(){return this.servicesValue}installedGeneration(){return this.installed}isAgentRunActive(){return this.agentRunActiveValue}requestShutdown(){if(!this.agentRunActiveValue){this.deps.disposeAndExit("shutdown-hook");return}this.shutdownRequested=!0}setRebindSession(){this.deps.runtime?.setRebindSession(e=>this.enqueueRebind(e,this.deps.runtime.services))}enqueueRebind(e,t){const n=++this.latestRebindRequest,r=this.rebindTail.then(async()=>{if(n!==this.latestRebindRequest)return;if(this.installed!==void 0){typeof this.sessionValue.sessionFile=="string"&&this.sessionValue.sessionFile!==""&&await x(this.deps.nodeId,{op:"invalidate",session_id:this.sessionValue.sessionManager.getSessionId()});const s=(await w(this.deps.nodeId)).fault;s?.link==="pi\u2192provider"&&s.retry.disposition==="auto"&&s.retry.by==="daemon"&&await S(this.deps.nodeId,{op:"clear",link:"pi\u2192provider",preserve_episode:!0})}if(this.installed?.executingTools.clear(),this.removeInstalledSubscription(),this.deps.setActiveSession(e),this.deps.projection().reset(),this.deps.faultRetry().reset(),this.agentRunActiveValue=!1,this.deps.onSessionRebind(),this.deps.toolGroups.resetForSession(),await e.bindExtensions({uiContext:this.deps.uiContext(),mode:"rpc",abortHandler:l(()=>T(e,()=>{const s=this.installed;s?.session===e&&(s.stagedRefreshAbort=!0)}),"abortHandler"),shutdownHandler:l(()=>this.requestShutdown(),"shutdownHandler")}),n!==this.latestRebindRequest)return;this.removeInstalledSubscription(),this.sessionValue=e,this.servicesValue=t;const d=e.agent;if(d&&(I(this.deps.nodeId,{agent:d,sessionManager:e.sessionManager},()=>this.deps.faultRetry().notePersonaGateFailure()),d.steeringMode="all",d.followUpMode="all",N(d)),this.deps.cfg.editorName!==void 0&&this.deps.cfg.editorName!=="")try{e.setSessionName(this.deps.cfg.editorName)}catch{}const o={id:++this.nextSubscriptionGeneration,session:e,fallback:{blocked:!1},stagedProviderAgentEnd:null,stagedWatchdogAbort:!1,stagedRefreshAbort:!1,stagedOverflowFailure:null,executingTools:new Set};this.unsubscribe=this.sessionValue.subscribe(s=>{if(!this.deps.projection().isCurrent(o))return;if(c.current()!==void 0){this.executeSubscriptionCallback(o,s);return}const i=o.fallback;if(s.type==="turn_start"&&i.storedId!==void 0){i.storedId=void 0,i.blocked=!0,c.fresh(()=>{u({level:"warn",event:"broker.turn.fallback_overlap",fields:{generation:o.id,engine_event:s.type}}),this.executeSubscriptionCallback(o,s)});return}if(s.type==="turn_start"&&!i.blocked){c.fresh(k=>{i.storedId=k,this.executeSubscriptionCallback(o,s)});return}const h=i.storedId;if(h!==void 0&&!i.blocked){c.run(h,()=>{this.executeSubscriptionCallback(o,s),s.type==="agent_settled"&&i.storedId===h&&(i.storedId=void 0)});return}this.executeSubscriptionCallback(o,s)}),this.installed=o,this.deps.projection().rearmIfStreaming(o),this.captureSystemPrompt(e)});return this.rebindTail=r.catch(()=>{}),r}runReplacement(e,t,n){const r=this.deps.runtime;if(r===void 0){this.deps.registry.sendFrame(e,{type:"error",code:"engine_error",message:"session replacement unsupported at this engine pin"});return}if(this.admittedReplacements>=f){c.fresh(()=>u({level:"warn",event:"broker.session_replacement.rejected",outcome:"skipped",fields:{op:t,reason:"capacity",admitted:f,cap:f}})),this.ackTo(e,t,!1,`session replacement busy (${f} active or queued)`);return}this.admittedReplacements++;const d=this.replacementTail.then(async()=>{try{await c.fresh(async()=>{const o=process.hrtime.bigint();let s;try{const p=new Promise(h=>{s=setTimeout(()=>h(b),m)}),i=await Promise.race([n(r),p]);if(i===b){u({level:"error",event:"broker.session_replacement.timed_out",outcome:"failed",duration_ms:Number(process.hrtime.bigint()-o)/1e6,fields:{op:t,deadline_ms:m,mutation_outcome:"indeterminate"}}),this.ackTo(e,t,!1,"session replacement timed out; broker restarting because session state is indeterminate"),this.deps.disposeAndExit("session-replacement-timeout",1);return}i.cancelled||this.deps.reWelcomeAll(),this.ackTo(e,t,!i.cancelled,i.cancelled?i.detail??"cancelled by extension":void 0)}catch(p){u({level:"error",event:"broker.session_replacement.failed",outcome:"failed",error:p,fields:{op:t,mutation_outcome:"indeterminate"}}),this.ackTo(e,t,!1,"session replacement failed; broker restarting because session state is indeterminate"),this.deps.disposeAndExit("session-replacement-failed",1)}finally{clearTimeout(s)}})}finally{this.admittedReplacements--}});this.replacementTail=d.catch(()=>{})}removeInstalledSubscription(){this.unsubscribe?.(),this.unsubscribe=void 0,this.installed=void 0}captureSystemPrompt(e){try{const t=E(this.deps.nodeId);v(t,{recursive:!0}),_(A(t,"system-prompt.md"),e.systemPrompt,"utf8")}catch{}}executeSubscriptionCallback(e,t){try{t.type==="agent_start"&&(this.agentRunActiveValue=!0),t.type==="agent_end"&&(e.stagedProviderAgentEnd=t,e.stagedOverflowFailure=null),t.type==="compaction_end"&&t.reason==="overflow"&&t.willRetry===!1&&typeof t.errorMessage=="string"&&(e.stagedOverflowFailure={errorMessage:t.errorMessage}),t.type==="agent_settled"&&(this.agentRunActiveValue=!1,this.publishAndScheduleProviderRecovery(e)),this.deps.toolGroups.observeToolGroupEvent(t),this.deps.projection().relayEvent(t,e)}catch(n){u({level:"debug",event:"broker.runtime.diagnostic",fields:{message:`event relay threw: ${String(n)}`}})}}async publishAndScheduleProviderRecovery(e){try{if(await this.deps.faultRetry().publishSettledProviderFault(e),this.shutdownRequested){this.deps.disposeAndExit("shutdown-after-settle");return}await this.deps.faultRetry().schedule()}catch(t){u({level:"error",event:"broker.daemon.operation.failed",node_id:this.deps.nodeId,error:t,fields:{operation:"provider_fault_settlement"}}),this.shutdownRequested&&this.deps.disposeAndExit("shutdown-after-settle")}}ackTo(e,t,n=!0,r,d){this.deps.registry.sendFrame(e,{type:"ack",for:t,ok:n,...r!==void 0?{detail:r}:{},...d!==void 0?{id:d}:{}})}}export{O as RebindDriver};

package/dist/core/runtime/broker/tool-groups.js

@@ -1,246 +1 @@
-import { existsSync, unlinkSync } from 'node:fs';
-import { join } from 'node:path';
-import { jobDir } from '../../canvas/paths.js';
-import { readConfig } from '../../config.js';
-import { emitEvent } from '../../events/emit.js';
-import { atomicWriteJson, readJsonIfExists } from '../../fs-utils.js';
-import { assistantVisibleText, isGroupBoundaryKind, isTrueUserMessage, normalizeToolGroupSummaryRecord, } from '../../../shared/tool-groups.js';
-import { generatedContextText, parseCard } from '../../../shared/generated-context.js';
-import { headlessToolGroupSummary, serializeToolGroup } from '../tool-group-summary.js';
-const PENDING_TOOL_SUMMARY_KEY_MAX_CHARS = 1_000;
-const PENDING_TOOL_SUMMARY_SEGMENT_MAX_CHARS = 10_000;
-function normalizePendingToolGroupSummary(value) {
-    if (value === null || typeof value !== 'object' || Array.isArray(value))
-        return null;
-    const record = value;
-    if (Object.keys(record).sort().join(',') !== 'key,segment,version')
-        return null;
-    if (record.version !== 1 || typeof record.key !== 'string' || typeof record.segment !== 'string')
-        return null;
-    if (record.key.length === 0 || record.key.length > PENDING_TOOL_SUMMARY_KEY_MAX_CHARS || record.segment.length === 0 || record.segment.length > PENDING_TOOL_SUMMARY_SEGMENT_MAX_CHARS)
-        return null;
-    return { version: 1, key: record.key, segment: record.segment };
-}
-/** Owns transcript tool-group state and its durable summary sidecars. */
-export class ToolGroupTracker {
-    broadcast;
-    toolSummariesPath;
-    pendingToolSummaryPath;
-    toolGroupSummaries = new Map();
-    summaryAttempted;
-    generatingToolGroups = new Map();
-    toolGroupsByCallId = new Map();
-    summaryTasks = new Set();
-    openToolGroup;
-    lastToolGroupBoundaryProse = '';
-    sawAssistantProse = false;
-    constructor(nodeId, broadcast) {
-        this.broadcast = broadcast;
-        this.toolSummariesPath = join(jobDir(nodeId), 'tool-summaries.json');
-        this.pendingToolSummaryPath = join(jobDir(nodeId), 'pending-tool-summary.json');
-        try {
-            const persisted = readJsonIfExists(this.toolSummariesPath);
-            for (const [key, summary] of Object.entries(normalizeToolGroupSummaryRecord(persisted)))
-                this.toolGroupSummaries.set(key, summary);
-        }
-        catch {
-            /* malformed sidecar merely withholds summaries */
-        }
-        this.summaryAttempted = new Set(this.toolGroupSummaries.keys());
-        this.resumePendingSummary();
-    }
-    summaries() {
-        return Object.fromEntries(this.toolGroupSummaries);
-    }
-    resetForSession() {
-        this.openToolGroup = undefined;
-        this.toolGroupsByCallId.clear();
-        this.sawAssistantProse = false;
-    }
-    finishOpenToolGroup(settleInterruptedTools = false) {
-        const group = this.openToolGroup;
-        this.openToolGroup = undefined;
-        if (group === undefined)
-            return;
-        group.closed = true;
-        if (settleInterruptedTools) {
-            for (const id of group.pendingToolIds)
-                this.toolGroupsByCallId.delete(id);
-            group.pendingToolIds.clear();
-        }
-        group.summarizeWhenSettled = readConfig('user').summarize_tool_calls;
-        this.generateSettledToolGroup(group);
-    }
-    observeToolGroupEvent(event) {
-        if (event.type === 'compaction_end' || (event.type === 'auto_retry_end' && event.success !== true)) {
-            this.finishOpenToolGroup();
-            return;
-        }
-        if (event.type === 'message_end') {
-            const message = event.message;
-            if (message !== null && typeof message === 'object') {
-                const item = message;
-                if (item.role === 'assistant' && (item.stopReason === 'aborted' || item.stopReason === 'error'))
-                    this.finishOpenToolGroup(true);
-            }
-            return;
-        }
-        if (event.type === 'tool_execution_start') {
-            const group = this.ensureOpenToolGroup();
-            const id = typeof event.toolCallId === 'string' ? event.toolCallId : '';
-            if (group.key === undefined && id !== '')
-                group.key = id;
-            if (id !== '') {
-                group.pendingToolIds.add(id);
-                this.toolGroupsByCallId.set(id, group);
-            }
-            group.toolCount += 1;
-            group.pieces.push({ type: 'tool', name: typeof event.toolName === 'string' ? event.toolName : 'tool', args: event.args });
-            return;
-        }
-        if (event.type === 'tool_execution_end') {
-            const id = typeof event.toolCallId === 'string' ? event.toolCallId : '';
-            const group = id === '' ? this.openToolGroup : this.toolGroupsByCallId.get(id);
-            if (group !== undefined) {
-                group.pieces.push({ type: 'result', name: typeof event.toolName === 'string' ? event.toolName : 'tool', result: event.result, isError: event.isError === true });
-                if (id !== '') {
-                    group.pendingToolIds.delete(id);
-                    this.toolGroupsByCallId.delete(id);
-                }
-                this.generateSettledToolGroup(group);
-            }
-            return;
-        }
-        if (event.type !== 'message_start' && event.type !== 'message_update')
-            return;
-        const message = event.message;
-        if (message === null || typeof message !== 'object')
-            return;
-        const item = message;
-        if (item.role === 'assistant') {
-            if (event.type === 'message_start')
-                this.sawAssistantProse = false;
-            const prose = assistantVisibleText(item);
-            if (!this.sawAssistantProse && prose.trim() !== '') {
-                this.sawAssistantProse = true;
-                this.visibleBoundary(prose);
-            }
-            return;
-        }
-        if (event.type !== 'message_start')
-            return;
-        if (item.role === 'compactionSummary' || item.role === 'branchSummary' || item.role === 'bashExecution' || item.role === 'status' || item.role === 'error' || item.customType === 'crtr-cycle-divider') {
-            this.finishOpenToolGroup();
-            return;
-        }
-        if (isTrueUserMessage(item)) {
-            this.visibleBoundary(generatedContextText(item));
-            return;
-        }
-        if (item.display === false)
-            return;
-        const text = generatedContextText(item);
-        const card = parseCard(item);
-        // A boundary card ends the preceding run and becomes the next group's
-        // context, exactly as a person's message does; the viewer reads the same
-        // set, so both sides fold at the same seams.
-        if (card !== null && isGroupBoundaryKind(card.kind)) {
-            this.visibleBoundary(text);
-            return;
-        }
-        const group = this.ensureOpenToolGroup();
-        if (text !== '')
-            group.pieces.push({ type: 'text', text });
-    }
-    persistPendingSummary() {
-        const pending = [...this.generatingToolGroups.values()].at(-1);
-        if (pending === undefined)
-            return;
-        try {
-            atomicWriteJson(this.pendingToolSummaryPath, pending);
-        }
-        catch (error) {
-            emitEvent({ level: 'warn', event: 'broker.runtime.diagnostic', fields: { message: `failed to persist pending tool summary: ${error instanceof Error ? error.message : String(error)}` } });
-        }
-    }
-    hasSummaryTasks() {
-        return this.summaryTasks.size > 0;
-    }
-    waitForSummaryTasks() {
-        return Promise.allSettled([...this.summaryTasks]);
-    }
-    ensureOpenToolGroup() {
-        if (this.openToolGroup === undefined) {
-            this.openToolGroup = { toolCount: 0, pieces: [], boundaryProse: this.lastToolGroupBoundaryProse, pendingToolIds: new Set(), closed: false, summarizeWhenSettled: false };
-        }
-        return this.openToolGroup;
-    }
-    visibleBoundary(prose) {
-        this.finishOpenToolGroup();
-        this.lastToolGroupBoundaryProse = prose;
-    }
-    clearPendingToolGroupSummary(input) {
-        try {
-            const persisted = normalizePendingToolGroupSummary(readJsonIfExists(this.pendingToolSummaryPath));
-            if (persisted?.key === input.key && persisted.segment === input.segment)
-                unlinkSync(this.pendingToolSummaryPath);
-        }
-        catch {
-            /* a stale handoff must not revoke the recap */
-        }
-    }
-    generateToolGroupSummary(input) {
-        const { key, segment } = input;
-        if (this.summaryAttempted.has(key) || this.generatingToolGroups.has(key))
-            return;
-        this.summaryAttempted.add(key);
-        this.generatingToolGroups.set(key, input);
-        let task;
-        task = headlessToolGroupSummary(segment)
-            .then((summary) => {
-            if (summary === null)
-                return;
-            this.toolGroupSummaries.set(key, summary);
-            try {
-                atomicWriteJson(this.toolSummariesPath, Object.fromEntries(this.toolGroupSummaries));
-            }
-            catch {
-                this.toolGroupSummaries.delete(key);
-                return;
-            }
-            this.clearPendingToolGroupSummary(input);
-            this.broadcast({ type: 'tool_group_summary', key, summary });
-        })
-            .catch(() => undefined)
-            .finally(() => {
-            this.generatingToolGroups.delete(key);
-            this.summaryTasks.delete(task);
-        });
-        this.summaryTasks.add(task);
-    }
-    generateSettledToolGroup(group) {
-        if (!group.closed || group.pendingToolIds.size > 0 || group.key === undefined || !group.summarizeWhenSettled)
-            return;
-        this.generateToolGroupSummary({ version: 1, key: group.key, segment: serializeToolGroup(group.boundaryProse, group.pieces) });
-    }
-    resumePendingSummary() {
-        try {
-            const pending = normalizePendingToolGroupSummary(readJsonIfExists(this.pendingToolSummaryPath));
-            if (pending === null) {
-                if (existsSync(this.pendingToolSummaryPath)) {
-                    unlinkSync(this.pendingToolSummaryPath);
-                    emitEvent({ level: 'warn', event: 'broker.startup.warning', fields: { stage: 'pending_tool_summary', message: 'removed an invalid pending tool summary' } });
-                }
-            }
-            else if (this.toolGroupSummaries.has(pending.key)) {
-                unlinkSync(this.pendingToolSummaryPath);
-            }
-            else {
-                this.generateToolGroupSummary(pending);
-            }
-        }
-        catch (error) {
-            emitEvent({ level: 'warn', event: 'broker.startup.warning', fields: { stage: 'pending_tool_summary', message: error instanceof Error ? error.message : String(error) } });
-        }
-    }
-}
+var T=Object.defineProperty;var l=(a,e)=>T(a,"name",{value:e,configurable:!0});import{existsSync as G,unlinkSync as u}from"node:fs";import{join as d}from"node:path";import{jobDir as y}from"../../canvas/paths.js";import{readConfig as S}from"../../config.js";import{emitEvent as m}from"../../events/emit.js";import{atomicWriteJson as h,readJsonIfExists as p}from"../../fs-utils.js";import{assistantVisibleText as k,isGroupBoundaryKind as P,isTrueUserMessage as _,normalizeToolGroupSummaryRecord as b}from"../../../shared/tool-groups.js";import{generatedContextText as f,parseCard as I}from"../../../shared/generated-context.js";import{headlessToolGroupSummary as w,serializeToolGroup as A}from"../tool-group-summary.js";const C=1e3,O=1e4;function g(a){if(a===null||typeof a!="object"||Array.isArray(a))return null;const e=a;return Object.keys(e).sort().join(",")!=="key,segment,version"||e.version!==1||typeof e.key!="string"||typeof e.segment!="string"||e.key.length===0||e.key.length>C||e.segment.length===0||e.segment.length>O?null:{version:1,key:e.key,segment:e.segment}}l(g,"normalizePendingToolGroupSummary");class U{static{l(this,"ToolGroupTracker")}broadcast;toolSummariesPath;pendingToolSummaryPath;toolGroupSummaries=new Map;summaryAttempted;generatingToolGroups=new Map;toolGroupsByCallId=new Map;summaryTasks=new Set;openToolGroup;lastToolGroupBoundaryProse="";sawAssistantProse=!1;constructor(e,o){this.broadcast=o,this.toolSummariesPath=d(y(e),"tool-summaries.json"),this.pendingToolSummaryPath=d(y(e),"pending-tool-summary.json");try{const t=p(this.toolSummariesPath);for(const[i,n]of Object.entries(b(t)))this.toolGroupSummaries.set(i,n)}catch{}this.summaryAttempted=new Set(this.toolGroupSummaries.keys()),this.resumePendingSummary()}summaries(){return Object.fromEntries(this.toolGroupSummaries)}resetForSession(){this.openToolGroup=void 0,this.toolGroupsByCallId.clear(),this.sawAssistantProse=!1}finishOpenToolGroup(e=!1){const o=this.openToolGroup;if(this.openToolGroup=void 0,o!==void 0){if(o.closed=!0,e){for(const t of o.pendingToolIds)this.toolGroupsByCallId.delete(t);o.pendingToolIds.clear()}o.summarizeWhenSettled=S("user").summarize_tool_calls,this.generateSettledToolGroup(o)}}observeToolGroupEvent(e){if(e.type==="compaction_end"||e.type==="auto_retry_end"&&e.success!==!0){this.finishOpenToolGroup();return}if(e.type==="message_end"){const s=e.message;if(s!==null&&typeof s=="object"){const r=s;r.role==="assistant"&&(r.stopReason==="aborted"||r.stopReason==="error")&&this.finishOpenToolGroup(!0)}return}if(e.type==="tool_execution_start"){const s=this.ensureOpenToolGroup(),r=typeof e.toolCallId=="string"?e.toolCallId:"";s.key===void 0&&r!==""&&(s.key=r),r!==""&&(s.pendingToolIds.add(r),this.toolGroupsByCallId.set(r,s)),s.toolCount+=1,s.pieces.push({type:"tool",name:typeof e.toolName=="string"?e.toolName:"tool",args:e.args});return}if(e.type==="tool_execution_end"){const s=typeof e.toolCallId=="string"?e.toolCallId:"",r=s===""?this.openToolGroup:this.toolGroupsByCallId.get(s);r!==void 0&&(r.pieces.push({type:"result",name:typeof e.toolName=="string"?e.toolName:"tool",result:e.result,isError:e.isError===!0}),s!==""&&(r.pendingToolIds.delete(s),this.toolGroupsByCallId.delete(s)),this.generateSettledToolGroup(r));return}if(e.type!=="message_start"&&e.type!=="message_update")return;const o=e.message;if(o===null||typeof o!="object")return;const t=o;if(t.role==="assistant"){e.type==="message_start"&&(this.sawAssistantProse=!1);const s=k(t);!this.sawAssistantProse&&s.trim()!==""&&(this.sawAssistantProse=!0,this.visibleBoundary(s));return}if(e.type!=="message_start")return;if(t.role==="compactionSummary"||t.role==="branchSummary"||t.role==="bashExecution"||t.role==="status"||t.role==="error"||t.customType==="crtr-cycle-divider"){this.finishOpenToolGroup();return}if(_(t)){this.visibleBoundary(f(t));return}if(t.display===!1)return;const i=f(t),n=I(t);if(n!==null&&P(n.kind)){this.visibleBoundary(i);return}const c=this.ensureOpenToolGroup();i!==""&&c.pieces.push({type:"text",text:i})}persistPendingSummary(){const e=[...this.generatingToolGroups.values()].at(-1);if(e!==void 0)try{h(this.pendingToolSummaryPath,e)}catch(o){m({level:"warn",event:"broker.runtime.diagnostic",fields:{message:`failed to persist pending tool summary: ${o instanceof Error?o.message:String(o)}`}})}}hasSummaryTasks(){return this.summaryTasks.size>0}waitForSummaryTasks(){return Promise.allSettled([...this.summaryTasks])}ensureOpenToolGroup(){return this.openToolGroup===void 0&&(this.openToolGroup={toolCount:0,pieces:[],boundaryProse:this.lastToolGroupBoundaryProse,pendingToolIds:new Set,closed:!1,summarizeWhenSettled:!1}),this.openToolGroup}visibleBoundary(e){this.finishOpenToolGroup(),this.lastToolGroupBoundaryProse=e}clearPendingToolGroupSummary(e){try{const o=g(p(this.pendingToolSummaryPath));o?.key===e.key&&o.segment===e.segment&&u(this.pendingToolSummaryPath)}catch{}}generateToolGroupSummary(e){const{key:o,segment:t}=e;if(this.summaryAttempted.has(o)||this.generatingToolGroups.has(o))return;this.summaryAttempted.add(o),this.generatingToolGroups.set(o,e);let i;i=w(t).then(n=>{if(n!==null){this.toolGroupSummaries.set(o,n);try{h(this.toolSummariesPath,Object.fromEntries(this.toolGroupSummaries))}catch{this.toolGroupSummaries.delete(o);return}this.clearPendingToolGroupSummary(e),this.broadcast({type:"tool_group_summary",key:o,summary:n})}}).catch(()=>{}).finally(()=>{this.generatingToolGroups.delete(o),this.summaryTasks.delete(i)}),this.summaryTasks.add(i)}generateSettledToolGroup(e){!e.closed||e.pendingToolIds.size>0||e.key===void 0||!e.summarizeWhenSettled||this.generateToolGroupSummary({version:1,key:e.key,segment:A(e.boundaryProse,e.pieces)})}resumePendingSummary(){try{const e=g(p(this.pendingToolSummaryPath));e===null?G(this.pendingToolSummaryPath)&&(u(this.pendingToolSummaryPath),m({level:"warn",event:"broker.startup.warning",fields:{stage:"pending_tool_summary",message:"removed an invalid pending tool summary"}})):this.toolGroupSummaries.has(e.key)?u(this.pendingToolSummaryPath):this.generateToolGroupSummary(e)}catch(e){m({level:"warn",event:"broker.startup.warning",fields:{stage:"pending_tool_summary",message:e instanceof Error?e.message:String(e)}})}}}export{U as ToolGroupTracker};

package/dist/core/runtime/broker/turn-admission.js

@@ -1,31 +1 @@
-export function createTurnAdmissionGate() {
-    let tail = Promise.resolve();
-    return {
-        admit(start) {
-            const previous = tail;
-            let resolveAdmission;
-            const admitted = new Promise((resolve) => {
-                resolveAdmission = resolve;
-            });
-            tail = previous.then(() => admitted);
-            return previous.then(() => {
-                let released = false;
-                const release = () => {
-                    if (released)
-                        return;
-                    released = true;
-                    resolveAdmission();
-                };
-                try {
-                    const attempt = start(release);
-                    void attempt.then(release, release);
-                    return attempt;
-                }
-                catch (error) {
-                    release();
-                    throw error;
-                }
-            });
-        },
-    };
-}
+var c=Object.defineProperty;var s=(e,o)=>c(e,"name",{value:o,configurable:!0});function d(){let e=Promise.resolve();return{admit(o){const i=e;let a;const l=new Promise(t=>{a=t});return e=i.then(()=>l),i.then(()=>{let t=!1;const r=s(()=>{t||(t=!0,a())},"release");try{const n=o(r);return n.then(r,r),n}catch(n){throw r(),n}})}}}s(d,"createTurnAdmissionGate");export{d as createTurnAdmissionGate};