@north-light/crouter 0.3.317 → 0.3.319

package/dist/daemon/api/handlers/broker-ops.js

@@ -1,447 +1 @@
-// Broker-originated canvas operations. The broker sends Pi lifecycle facts;
-// crtrd validates and commits their durable effects while the handler stays
-// strictly canvas-write-only — no broker launch, kill, or view.sock round trip.
-import { canonicalSessionFile, findNodeBySessionFile, getNode, isWarmSpare, listNodeIdentities, recordSettledTurn, setPresence, subscriptionsOf, updateNode } from '../../../core/canvas/canvas.js';
-import { recordExecutionPid } from '../../../core/canvas/executions.js';
-import { bindSession, readLiveSession, transferSession } from '../../../core/canvas/sessions.js';
-import { isSafeNodeId } from '../../../core/canvas/paths.js';
-import { isPidAlive } from '../../../core/canvas/pid.js';
-import { editorLabel } from '../../../core/canvas/labels.js';
-import { assembleNodeSubject } from '../../../core/substrate/subject.js';
-import { withCanvasWrite } from '../../../core/canvas/db.js';
-import { notFound, usage } from '../../../core/errors.js';
-import { hasUnseenWakeMail } from '../../../core/canvas/deliveries.js';
-import { clearYieldMessage } from '../../../core/runtime/kickoff.js';
-import { transition } from '../../../core/runtime/lifecycle.js';
-import { focusOf, tearDownNode } from '../../../core/runtime/placement.js';
-import { hasAttachedBrokerViewers } from '../../../core/runtime/broker/client-registry.js';
-import { evaluateStop } from '../../../core/runtime/stop-guard.js';
-import { clearFault, recordFault } from '../../../core/canvas/recovery.js';
-import { updateModelRecipe } from '../../../core/runtime/model-swap.js';
-import { completeCompanionRequestedSubmit } from '../../review/finish.js';
-import { emitEvent } from '../../../core/events/emit.js';
-import { consumePendingPark, recordPendingParkActivity } from '../../park-pending.js';
-import { shouldParkAfterSummary } from '../../park-activity.js';
-import { requireCurrentExecution } from './broker-recovery.js';
-function objectBody(body, operation) {
-    if (typeof body !== 'object' || body === null || Array.isArray(body)) {
-        throw usage(`${operation} requires a JSON body`);
-    }
-    return body;
-}
-function parseSessionBoundBody(body) {
-    const value = objectBody(body, 'broker session-bound');
-    if (typeof value['executionId'] !== 'string' || value['executionId'] === '') {
-        throw usage('executionId must be a non-empty string');
-    }
-    if (typeof value['piSessionId'] !== 'string' || value['piSessionId'] === '') {
-        throw usage('piSessionId must be a non-empty string');
-    }
-    if (value['sessionFile'] !== null && typeof value['sessionFile'] !== 'string') {
-        throw usage('sessionFile must be a string or null');
-    }
-    if (!Number.isSafeInteger(value['pid']) || value['pid'] <= 0) {
-        throw usage('pid must be a positive safe integer');
-    }
-    if (value['reason'] !== null && typeof value['reason'] !== 'string') {
-        throw usage('reason must be a string or null');
-    }
-    if (!Array.isArray(value['reviewBoundaryIds'])
-        || !value['reviewBoundaryIds'].every((id) => typeof id === 'string')) {
-        throw usage('reviewBoundaryIds must be an array of strings');
-    }
-    return value;
-}
-function parseSettleBody(body) {
-    const value = objectBody(body, 'broker settle');
-    if (typeof value['stopReason'] !== 'string')
-        throw usage('stopReason must be a string');
-    for (const field of ['backgroundJobsRunning', 'pushedFinal', 'requestedHumanReply']) {
-        if (typeof value[field] !== 'boolean')
-            throw usage(`${field} must be a boolean`);
-    }
-    return value;
-}
-function parseParkCompleteBody(body) {
-    const value = objectBody(body, 'broker park-complete');
-    if (value['outcome'] !== 'completed' && value['outcome'] !== 'failed') {
-        throw usage('outcome must be completed or failed');
-    }
-    return value;
-}
-function parseModelCommitBody(body) {
-    const value = objectBody(body, 'broker model');
-    if (typeof value['spec'] !== 'string' || value['spec'].trim() === '')
-        throw usage('spec must be a non-empty string');
-    if (value['pinnedOverride'] !== undefined && typeof value['pinnedOverride'] !== 'boolean') {
-        throw usage('pinnedOverride must be a boolean when present');
-    }
-    if (typeof value['userSelected'] !== 'boolean')
-        throw usage('userSelected must be a boolean');
-    return value;
-}
-function requireNode(nodeId) {
-    const node = getNode(nodeId);
-    if (node === null)
-        throw notFound(`unknown node: ${nodeId}`, { received: nodeId });
-    return node;
-}
-function extensionNode(node) {
-    return {
-        node_id: node.node_id,
-        name: node.name,
-        ...(node.description === undefined ? {} : { description: node.description }),
-        ...(node.title === undefined ? {} : { title: node.title }),
-        ...(node.icon === undefined ? {} : { icon: node.icon }),
-        kind: node.kind,
-        mode: node.mode,
-        lifecycle: node.lifecycle,
-        status: node.status,
-        cwd: node.cwd,
-        parent: node.parent ?? null,
-        fork_from: node.fork_from ?? null,
-        profile_id: node.profile_id ?? null,
-        ...(node.managed_worktree === undefined ? {} : { managed_worktree: node.managed_worktree === null ? null : {
-                state: node.managed_worktree.state,
-                ...(node.managed_worktree.cleanup === undefined ? {} : { cleanup: node.managed_worktree.cleanup }),
-                path: node.managed_worktree.path,
-                branch: node.managed_worktree.branch,
-                base_ref: node.managed_worktree.base_ref,
-                base_sha: node.managed_worktree.base_sha,
-            } }),
-        ...(node.review_binding === undefined ? {} : { review_binding: node.review_binding ?? null }),
-        intent: node.intent ?? null,
-        ...(node.persona_ack === undefined ? {} : { persona_ack: node.persona_ack }),
-        created: node.created,
-    };
-}
-function extensionState(nodeId) {
-    const node = requireNode(nodeId);
-    const ancestors = [];
-    const seen = new Set([nodeId]);
-    let parentId = node.parent ?? null;
-    while (parentId !== null && parentId !== '' && !seen.has(parentId)) {
-        seen.add(parentId);
-        const parent = getNode(parentId);
-        if (parent === null)
-            break;
-        ancestors.unshift(extensionNode(parent));
-        parentId = parent.parent ?? null;
-    }
-    const children = subscriptionsOf(nodeId)
-        .map((subscription) => getNode(subscription.node_id))
-        .filter((child) => child !== null && child.kind !== 'human')
-        .sort((a, b) => (a.status === b.status ? 0 : a.status === 'active' ? -1 : b.status === 'active' ? 1 : 0))
-        .map(extensionNode);
-    const source = typeof node.fork_source_file === 'string'
-        ? findNodeBySessionFile(node.fork_source_file)
-        : null;
-    const subject = assembleNodeSubject(nodeId);
-    if (subject === null)
-        throw notFound(`unknown node: ${nodeId}`, { received: nodeId });
-    return {
-        node: extensionNode(node),
-        warm_spare: isWarmSpare(nodeId),
-        ancestors,
-        children,
-        fork_source: source === null ? null : extensionNode(source),
-        subject,
-        report_nodes: listNodeIdentities(),
-    };
-}
-function samePersona(a, b) {
-    return a?.kind === b.kind && a?.mode === b.mode && a?.lifecycle === b.lifecycle;
-}
-function parseGeneratedNameBody(body) {
-    const value = objectBody(body, 'broker generated-name');
-    if (value['kind'] !== 'initial' && value['kind'] !== 'recap')
-        throw usage('kind must be initial or recap');
-    if (typeof value['description'] !== 'string' || typeof value['title'] !== 'string' || typeof value['icon'] !== 'string') {
-        throw usage('description, title, and icon must be strings');
-    }
-    if (value['kind'] === 'initial') {
-        return value;
-    }
-    const expected = value['expected'];
-    if (typeof expected !== 'object' || expected === null || Array.isArray(expected)
-        || ['name', 'description', 'title', 'icon', 'kind'].some((key) => typeof expected[key] !== 'string')) {
-        throw usage('recap expected must contain name, description, title, icon, and kind strings');
-    }
-    return value;
-}
-function parsePersonaAckBody(body) {
-    const value = objectBody(body, 'broker persona-ack');
-    const parse = (key) => {
-        const persona = value[key];
-        if (typeof persona !== 'object' || persona === null || Array.isArray(persona)
-            || typeof persona['kind'] !== 'string'
-            || (persona['mode'] !== 'base' && persona['mode'] !== 'orchestrator')
-            || (persona['lifecycle'] !== 'terminal' && persona['lifecycle'] !== 'resident')) {
-            throw usage(`${key} must be a persona state`);
-        }
-        return persona;
-    };
-    return { expected_execution_id: value['expected_execution_id'], from: parse('from'), to: parse('to') };
-}
-function handleSessionBound(ctx) {
-    const nodeId = ctx.params['id'];
-    const request = parseSessionBoundBody(ctx.body);
-    const sessionFile = request.sessionFile === null ? null : canonicalSessionFile(request.sessionFile);
-    const result = withCanvasWrite(() => {
-        const before = requireNode(nodeId);
-        if (recordExecutionPid(request.executionId, nodeId, request.pid) === 'shutdown') {
-            return { action: 'shutdown' };
-        }
-        const reviewId = before.review_binding?.review_id;
-        if (reviewId !== undefined && !request.reviewBoundaryIds.includes(reviewId)) {
-            return { action: 'shutdown' };
-        }
-        if (request.reason === 'new' && before.parent == null)
-            return { action: 'relaunch_root' };
-        if (request.reason !== 'new' && before.fork_from != null && before.pi_session_id == null && sessionFile === null) {
-            return { action: 'shutdown' };
-        }
-        const owner = sessionFile === null ? null : findNodeBySessionFile(sessionFile);
-        if (owner !== null && owner.node_id !== nodeId) {
-            if (isPidAlive(owner.pi_pid)) {
-                recordFault(nodeId, {
-                    link: 'daemon→node',
-                    op: 'session-file-ownership',
-                    kind: 'protocol',
-                    retry: { disposition: 'fatal' },
-                    message: `refusing to bind ${sessionFile}: it is owned by live node ${owner.node_id}`,
-                });
-                return { action: 'shutdown' };
-            }
-            const source = readLiveSession(owner.node_id);
-            if (source === null || transferSession({
-                fromNodeId: owner.node_id,
-                fromBindingId: source.bindingId,
-                toNodeId: nodeId,
-                executionId: request.executionId,
-                sessionId: request.piSessionId,
-                transcriptPath: sessionFile,
-            }) !== 'transferred')
-                return { action: 'shutdown' };
-        }
-        else if (bindSession(nodeId, {
-            executionId: request.executionId,
-            sessionId: request.piSessionId,
-            transcriptPath: sessionFile,
-        }) === 'shutdown')
-            return { action: 'shutdown' };
-        if (request.reason !== 'new') {
-            clearYieldMessage(nodeId);
-            if (before.intent === 'refresh')
-                transition(nodeId, 'revive');
-        }
-        return { action: 'none' };
-    });
-    return { status: 200, body: result };
-}
-/** Commit the complete broker-settlement policy while holding one canvas write
- * boundary. This handler intentionally never invokes the broker that called it:
- * the returned directive is the only Pi-side consequence. */
-function settleBroker(nodeId, request) {
-    const node = getNode(nodeId);
-    if (node === null) {
-        // A command may have recorded its Pi-local completion marker just as an
-        // external close removes the row. There is no daemon write to perform, but
-        // preserving the marker's fail-safe consequence avoids leaving an orphaned
-        // broker alive while never fabricating a replacement canvas row.
-        if (request.pushedFinal)
-            return { action: 'shutdown' };
-        if (request.requestedHumanReply)
-            return { action: 'stay_dormant' };
-        throw notFound(`unknown node: ${nodeId}`, { received: nodeId });
-    }
-    recordSettledTurn(nodeId, new Date().toISOString());
-    if (request.stopReason === 'quit') {
-        if ((node.status === 'active' || node.status === 'idle') && node.intent === null) {
-            transition(nodeId, 'finish');
-            clearFault(nodeId);
-            if (focusOf(nodeId) !== null)
-                tearDownNode(nodeId);
-            setPresence(nodeId, { pane: null, tmux_session: null, window: null });
-        }
-        return { action: 'shutdown' };
-    }
-    // Interrupted runs remain live for re-steering. A refresh intentionally
-    // aborts its own turn, so it is the one non-natural stop that exits.
-    if (request.stopReason !== 'stop' && request.stopReason !== 'length') {
-        clearFault(nodeId, { link: 'daemon→node' });
-        return node.intent === 'refresh' ? { action: 'shutdown' } : { action: 'stay_dormant' };
-    }
-    const signals = { pushedFinal: request.pushedFinal, requestedHumanReply: request.requestedHumanReply };
-    // Two current-state outcomes: terminal broker consequences, not Pi decisions.
-    if (signals.pushedFinal || node.status === 'done') {
-        clearFault(nodeId);
-        if (focusOf(nodeId) !== null)
-            tearDownNode(nodeId);
-        setPresence(nodeId, { pane: null, tmux_session: null, window: null });
-        return { action: 'shutdown' };
-    }
-    if (signals.requestedHumanReply) {
-        clearFault(nodeId);
-        return { action: 'stay_dormant' };
-    }
-    if (node.intent === 'refresh') {
-        clearFault(nodeId);
-        return { action: 'shutdown' };
-    }
-    const decision = evaluateStop(nodeId, signals, request.backgroundJobsRunning);
-    clearFault(nodeId);
-    if (decision.action === 'reprompt')
-        return { action: 'reprompt', prompt: decision.message };
-    if (decision.reason === 'finished') {
-        return hasUnseenWakeMail(nodeId) ? { action: 'stay_dormant' } : { action: 'shutdown' };
-    }
-    if (decision.reason !== 'awaiting' && decision.reason !== 'scheduled') {
-        return { action: 'stay_dormant' };
-    }
-    if (focusOf(nodeId) !== null
-        || hasAttachedBrokerViewers(nodeId)
-        || hasUnseenWakeMail(nodeId))
-        return { action: 'stay_dormant' };
-    transition(nodeId, 'release');
-    return { action: 'shutdown' };
-}
-function handleSettle(ctx) {
-    const nodeId = ctx.params['id'];
-    const request = parseSettleBody(ctx.body);
-    requireCurrentExecution(nodeId, request.expected_execution_id);
-    const directive = withCanvasWrite(() => settleBroker(nodeId, request));
-    // A review companion that just went quiet releases any submit the human left
-    // waiting on it. A reprompt is not going quiet, so it waits for the turn that
-    // reprompt starts. This never blocks the directive: the completion delivers
-    // an approval and retires this very broker, and the broker is owed its answer
-    // first.
-    if (directive.action !== 'reprompt')
-        void completeCompanionRequestedSubmit(nodeId);
-    return { status: 200, body: directive };
-}
-/** The shadow parking turn is the sole good-path enactor for its pending marker.
- * The ordinary main-session settle path remains independent so user activity
- * cannot erase the marker before this completion re-evaluates the obligation. */
-function handleParkComplete(ctx) {
-    const nodeId = ctx.params['id'];
-    const request = parseParkCompleteBody(ctx.body);
-    requireCurrentExecution(nodeId, request.expected_execution_id);
-    const directive = withCanvasWrite(() => {
-        const pending = consumePendingPark(nodeId);
-        if (pending === undefined)
-            return { action: 'stay_dormant' };
-        const node = requireNode(nodeId);
-        if (!shouldParkAfterSummary(nodeId, node, pending))
-            return { action: 'stay_dormant' };
-        clearFault(nodeId);
-        transition(nodeId, 'park');
-        if (focusOf(nodeId) !== null)
-            tearDownNode(nodeId);
-        setPresence(nodeId, { pane: null, tmux_session: null, window: null });
-        emitEvent({
-            level: request.outcome === 'completed' ? 'info' : 'warn',
-            event: 'broker.park.complete',
-            ...(isSafeNodeId(nodeId) ? { node_id: nodeId } : {}),
-            outcome: request.outcome === 'completed' ? 'succeeded' : 'failed',
-        });
-        return { action: 'shutdown' };
-    });
-    return { status: 200, body: directive };
-}
-/** Record an accepted main-engine input before Pi begins driving it. This shares
- * the canvas-write boundary with park completion, so a pending shadow turn can
- * never terminalize a viewer or live-delivery input that won admission. */
-function handleParkActivity(ctx) {
-    const nodeId = ctx.params['id'];
-    requireCurrentExecution(nodeId, objectBody(ctx.body, 'broker park-activity')['expected_execution_id']);
-    const result = withCanvasWrite(() => ({
-        activity: recordPendingParkActivity(nodeId) ? 'recorded' : 'none',
-    }));
-    return { status: 200, body: result };
-}
-function handleModelCommit(ctx) {
-    const nodeId = ctx.params['id'];
-    const request = parseModelCommitBody(ctx.body);
-    requireCurrentExecution(nodeId, request.expected_execution_id);
-    const updated = withCanvasWrite(() => updateModelRecipe(requireNode(nodeId), request.spec, request.pinnedOverride, request.userSelected));
-    return { status: 200, body: { modelOverride: updated.model_override } };
-}
-function handleExtensionState(ctx) {
-    return { status: 200, body: extensionState(ctx.params['id']) };
-}
-/** The only generated-name writer brokers may invoke. It is a compare-and-swap
- * over the automatic label snapshot, so a human rename or newer name result
- * wins rather than being overwritten by an older headless process. */
-function handleGeneratedName(ctx) {
-    const nodeId = ctx.params['id'];
-    const request = parseGeneratedNameBody(ctx.body);
-    requireCurrentExecution(nodeId, request.expected_execution_id);
-    const result = withCanvasWrite(() => {
-        const node = requireNode(nodeId);
-        if (request.kind === 'initial') {
-            if ((node.description ?? '').trim() !== '')
-                return { applied: false };
-            const updated = updateNode(nodeId, {
-                description: request.description,
-                ...(request.title.trim() === '' ? {} : { title: request.title }),
-                ...(request.icon.trim() === '' ? {} : { icon: request.icon }),
-            });
-            return {
-                applied: true,
-                editorLabel: editorLabel(updated),
-                description: updated.description ?? '',
-                title: updated.title ?? '',
-                icon: updated.icon ?? '',
-            };
-        }
-        const expected = request.expected;
-        if (node.name !== expected.name || (node.description ?? '') !== expected.description
-            || (node.title ?? '') !== expected.title
-            || (node.icon ?? '') !== expected.icon || node.kind !== expected.kind)
-            return { applied: false };
-        const updated = updateNode(nodeId, {
-            description: request.description,
-            title: request.title.trim() === '' ? undefined : request.title,
-            icon: request.icon.trim() === '' ? undefined : request.icon,
-        });
-        return {
-            applied: true,
-            editorLabel: editorLabel(updated),
-            description: updated.description ?? '',
-            title: updated.title ?? '',
-            icon: updated.icon ?? '',
-        };
-    });
-    return { status: 200, body: result };
-}
-/** Ack after the matching baseline or transition context is durable. The
- * expected pair prevents a stale broker from acknowledging a later change. */
-function handlePersonaAck(ctx) {
-    const nodeId = ctx.params['id'];
-    const request = parsePersonaAckBody(ctx.body);
-    requireCurrentExecution(nodeId, request.expected_execution_id);
-    const result = withCanvasWrite(() => {
-        const node = requireNode(nodeId);
-        const current = { kind: node.kind, mode: node.mode, lifecycle: node.lifecycle };
-        // A pre-kind ack reads its kind as the node's current one, matching how the
-        // broker resolved the `from` it is acknowledging.
-        const ack = node.persona_ack;
-        const acknowledged = ack === undefined ? current : { kind: ack.kind ?? node.kind, mode: ack.mode, lifecycle: ack.lifecycle };
-        if (!samePersona(current, request.to) || !samePersona(acknowledged, request.from))
-            return { applied: false };
-        updateNode(nodeId, { persona_ack: request.to });
-        return { applied: true };
-    });
-    return { status: 200, body: result };
-}
-export const brokerOperationRoutes = [
-    { method: 'POST', pattern: '/v1/nodes/:id/broker/session-bound', handler: handleSessionBound },
-    { method: 'POST', pattern: '/v1/nodes/:id/broker/settle', handler: handleSettle },
-    { method: 'POST', pattern: '/v1/nodes/:id/broker/park-complete', handler: handleParkComplete },
-    { method: 'POST', pattern: '/v1/nodes/:id/broker/park-activity', handler: handleParkActivity },
-    { method: 'POST', pattern: '/v1/nodes/:id/broker/model', handler: handleModelCommit },
-    { method: 'GET', pattern: '/v1/nodes/:id/broker/extension-state', handler: handleExtensionState },
-    { method: 'POST', pattern: '/v1/nodes/:id/broker/generated-name', handler: handleGeneratedName },
-    { method: 'POST', pattern: '/v1/nodes/:id/broker/persona-ack', handler: handlePersonaAck },
-];
+var A=Object.defineProperty;var o=(e,t)=>A(e,"name",{value:t,configurable:!0});import{canonicalSessionFile as N,findNodeBySessionFile as P,getNode as k,isWarmSpare as R,listNodeIdentities as q,recordSettledTurn as T,setPresence as _,subscriptionsOf as $,updateNode as g}from"../../../core/canvas/canvas.js";import{recordExecutionPid as C}from"../../../core/canvas/executions.js";import{bindSession as j,readLiveSession as I,transferSession as E}from"../../../core/canvas/sessions.js";import{isSafeNodeId as H}from"../../../core/canvas/paths.js";import{isPidAlive as M}from"../../../core/canvas/pid.js";import{editorLabel as B}from"../../../core/canvas/labels.js";import{assembleNodeSubject as L}from"../../../core/substrate/subject.js";import{withCanvasWrite as l}from"../../../core/canvas/db.js";import{notFound as v,usage as a}from"../../../core/errors.js";import{hasUnseenWakeMail as O}from"../../../core/canvas/deliveries.js";import{clearYieldMessage as G}from"../../../core/runtime/kickoff.js";import{transition as y}from"../../../core/runtime/lifecycle.js";import{focusOf as b,tearDownNode as S}from"../../../core/runtime/placement.js";import{hasAttachedBrokerViewers as J}from"../../../core/runtime/broker/client-registry.js";import{evaluateStop as W}from"../../../core/runtime/stop-guard.js";import{clearFault as p,recordFault as D}from"../../../core/canvas/recovery.js";import{updateModelRecipe as U}from"../../../core/runtime/model-swap.js";import{completeCompanionRequestedSubmit as V}from"../../review/finish.js";import{emitEvent as Y}from"../../../core/events/emit.js";import{consumePendingPark as z,recordPendingParkActivity as K}from"../../park-pending.js";import{shouldParkAfterSummary as Q}from"../../park-activity.js";import{requireCurrentExecution as m}from"./broker-recovery.js";function f(e,t){if(typeof e!="object"||e===null||Array.isArray(e))throw a(`${t} requires a JSON body`);return e}o(f,"objectBody");function X(e){const t=f(e,"broker session-bound");if(typeof t.executionId!="string"||t.executionId==="")throw a("executionId must be a non-empty string");if(typeof t.piSessionId!="string"||t.piSessionId==="")throw a("piSessionId must be a non-empty string");if(t.sessionFile!==null&&typeof t.sessionFile!="string")throw a("sessionFile must be a string or null");if(!Number.isSafeInteger(t.pid)||t.pid<=0)throw a("pid must be a positive safe integer");if(t.reason!==null&&typeof t.reason!="string")throw a("reason must be a string or null");if(!Array.isArray(t.reviewBoundaryIds)||!t.reviewBoundaryIds.every(n=>typeof n=="string"))throw a("reviewBoundaryIds must be an array of strings");return t}o(X,"parseSessionBoundBody");function Z(e){const t=f(e,"broker settle");if(typeof t.stopReason!="string")throw a("stopReason must be a string");for(const n of["backgroundJobsRunning","pushedFinal","requestedHumanReply"])if(typeof t[n]!="boolean")throw a(`${n} must be a boolean`);return t}o(Z,"parseSettleBody");function ee(e){const t=f(e,"broker park-complete");if(t.outcome!=="completed"&&t.outcome!=="failed")throw a("outcome must be completed or failed");return t}o(ee,"parseParkCompleteBody");function te(e){const t=f(e,"broker model");if(typeof t.spec!="string"||t.spec.trim()==="")throw a("spec must be a non-empty string");if(t.pinnedOverride!==void 0&&typeof t.pinnedOverride!="boolean")throw a("pinnedOverride must be a boolean when present");if(typeof t.userSelected!="boolean")throw a("userSelected must be a boolean");return t}o(te,"parseModelCommitBody");function h(e){const t=k(e);if(t===null)throw v(`unknown node: ${e}`,{received:e});return t}o(h,"requireNode");function w(e){return{node_id:e.node_id,name:e.name,...e.description===void 0?{}:{description:e.description},...e.title===void 0?{}:{title:e.title},...e.icon===void 0?{}:{icon:e.icon},kind:e.kind,mode:e.mode,lifecycle:e.lifecycle,status:e.status,cwd:e.cwd,parent:e.parent??null,fork_from:e.fork_from??null,profile_id:e.profile_id??null,...e.managed_worktree===void 0?{}:{managed_worktree:e.managed_worktree===null?null:{state:e.managed_worktree.state,...e.managed_worktree.cleanup===void 0?{}:{cleanup:e.managed_worktree.cleanup},path:e.managed_worktree.path,branch:e.managed_worktree.branch,base_ref:e.managed_worktree.base_ref,base_sha:e.managed_worktree.base_sha}},...e.review_binding===void 0?{}:{review_binding:e.review_binding??null},intent:e.intent??null,...e.persona_ack===void 0?{}:{persona_ack:e.persona_ack},created:e.created}}o(w,"extensionNode");function ne(e){const t=h(e),n=[],r=new Set([e]);let i=t.parent??null;for(;i!==null&&i!==""&&!r.has(i);){r.add(i);const c=k(i);if(c===null)break;n.unshift(w(c)),i=c.parent??null}const s=$(e).map(c=>k(c.node_id)).filter(c=>c!==null&&c.kind!=="human").sort((c,x)=>c.status===x.status?0:c.status==="active"?-1:x.status==="active"?1:0).map(w),u=typeof t.fork_source_file=="string"?P(t.fork_source_file):null,d=L(e);if(d===null)throw v(`unknown node: ${e}`,{received:e});return{node:w(t),warm_spare:R(e),ancestors:n,children:s,fork_source:u===null?null:w(u),subject:d,report_nodes:q()}}o(ne,"extensionState");function F(e,t){return e?.kind===t.kind&&e?.mode===t.mode&&e?.lifecycle===t.lifecycle}o(F,"samePersona");function ie(e){const t=f(e,"broker generated-name");if(t.kind!=="initial"&&t.kind!=="recap")throw a("kind must be initial or recap");if(typeof t.description!="string"||typeof t.title!="string"||typeof t.icon!="string")throw a("description, title, and icon must be strings");if(t.kind==="initial")return t;const n=t.expected;if(typeof n!="object"||n===null||Array.isArray(n)||["name","description","title","icon","kind"].some(r=>typeof n[r]!="string"))throw a("recap expected must contain name, description, title, icon, and kind strings");return t}o(ie,"parseGeneratedNameBody");function re(e){const t=f(e,"broker persona-ack"),n=o(r=>{const i=t[r];if(typeof i!="object"||i===null||Array.isArray(i)||typeof i.kind!="string"||i.mode!=="base"&&i.mode!=="orchestrator"||i.lifecycle!=="terminal"&&i.lifecycle!=="resident")throw a(`${r} must be a persona state`);return i},"parse");return{expected_execution_id:t.expected_execution_id,from:n("from"),to:n("to")}}o(re,"parsePersonaAckBody");function oe(e){const t=e.params.id,n=X(e.body),r=n.sessionFile===null?null:N(n.sessionFile);return{status:200,body:l(()=>{const s=h(t);if(C(n.executionId,t,n.pid)==="shutdown")return{action:"shutdown"};const u=s.review_binding?.review_id;if(u!==void 0&&!n.reviewBoundaryIds.includes(u))return{action:"shutdown"};if(n.reason==="new"&&s.parent==null)return{action:"relaunch_root"};if(n.reason!=="new"&&s.fork_from!=null&&s.pi_session_id==null&&r===null)return{action:"shutdown"};const d=r===null?null:P(r);if(d!==null&&d.node_id!==t){if(M(d.pi_pid))return D(t,{link:"daemon\u2192node",op:"session-file-ownership",kind:"protocol",retry:{disposition:"fatal"},message:`refusing to bind ${r}: it is owned by live node ${d.node_id}`}),{action:"shutdown"};const c=I(d.node_id);if(c===null||E({fromNodeId:d.node_id,fromBindingId:c.bindingId,toNodeId:t,executionId:n.executionId,sessionId:n.piSessionId,transcriptPath:r})!=="transferred")return{action:"shutdown"}}else if(j(t,{executionId:n.executionId,sessionId:n.piSessionId,transcriptPath:r})==="shutdown")return{action:"shutdown"};return n.reason!=="new"&&(G(t),s.intent==="refresh"&&y(t,"revive")),{action:"none"}})}}o(oe,"handleSessionBound");function se(e,t){const n=k(e);if(n===null){if(t.pushedFinal)return{action:"shutdown"};if(t.requestedHumanReply)return{action:"stay_dormant"};throw v(`unknown node: ${e}`,{received:e})}if(T(e,new Date().toISOString()),t.stopReason==="quit")return(n.status==="active"||n.status==="idle")&&n.intent===null&&(y(e,"finish"),p(e),b(e)!==null&&S(e),_(e,{pane:null,tmux_session:null,window:null})),{action:"shutdown"};if(t.stopReason!=="stop"&&t.stopReason!=="length")return p(e,{link:"daemon\u2192node"}),n.intent==="refresh"?{action:"shutdown"}:{action:"stay_dormant"};const r={pushedFinal:t.pushedFinal,requestedHumanReply:t.requestedHumanReply};if(r.pushedFinal||n.status==="done")return p(e),b(e)!==null&&S(e),_(e,{pane:null,tmux_session:null,window:null}),{action:"shutdown"};if(r.requestedHumanReply)return p(e),{action:"stay_dormant"};if(n.intent==="refresh")return p(e),{action:"shutdown"};const i=W(e,r,t.backgroundJobsRunning);return p(e),i.action==="reprompt"?{action:"reprompt",prompt:i.message}:i.reason==="finished"?O(e)?{action:"stay_dormant"}:{action:"shutdown"}:i.reason!=="awaiting"&&i.reason!=="scheduled"?{action:"stay_dormant"}:b(e)!==null||J(e)||O(e)?{action:"stay_dormant"}:(y(e,"release"),{action:"shutdown"})}o(se,"settleBroker");function ae(e){const t=e.params.id,n=Z(e.body);m(t,n.expected_execution_id);const r=l(()=>se(t,n));return r.action!=="reprompt"&&V(t),{status:200,body:r}}o(ae,"handleSettle");function de(e){const t=e.params.id,n=ee(e.body);return m(t,n.expected_execution_id),{status:200,body:l(()=>{const i=z(t);if(i===void 0)return{action:"stay_dormant"};const s=h(t);return Q(t,s,i)?(p(t),y(t,"park"),b(t)!==null&&S(t),_(t,{pane:null,tmux_session:null,window:null}),Y({level:n.outcome==="completed"?"info":"warn",event:"broker.park.complete",...H(t)?{node_id:t}:{},outcome:n.outcome==="completed"?"succeeded":"failed"}),{action:"shutdown"}):{action:"stay_dormant"}})}}o(de,"handleParkComplete");function ue(e){const t=e.params.id;return m(t,f(e.body,"broker park-activity").expected_execution_id),{status:200,body:l(()=>({activity:K(t)?"recorded":"none"}))}}o(ue,"handleParkActivity");function ce(e){const t=e.params.id,n=te(e.body);return m(t,n.expected_execution_id),{status:200,body:{modelOverride:l(()=>U(h(t),n.spec,n.pinnedOverride,n.userSelected)).model_override}}}o(ce,"handleModelCommit");function le(e){return{status:200,body:ne(e.params.id)}}o(le,"handleExtensionState");function pe(e){const t=e.params.id,n=ie(e.body);return m(t,n.expected_execution_id),{status:200,body:l(()=>{const i=h(t);if(n.kind==="initial"){if((i.description??"").trim()!=="")return{applied:!1};const d=g(t,{description:n.description,...n.title.trim()===""?{}:{title:n.title},...n.icon.trim()===""?{}:{icon:n.icon}});return{applied:!0,editorLabel:B(d),description:d.description??"",title:d.title??"",icon:d.icon??""}}const s=n.expected;if(i.name!==s.name||(i.description??"")!==s.description||(i.title??"")!==s.title||(i.icon??"")!==s.icon||i.kind!==s.kind)return{applied:!1};const u=g(t,{description:n.description,title:n.title.trim()===""?void 0:n.title,icon:n.icon.trim()===""?void 0:n.icon});return{applied:!0,editorLabel:B(u),description:u.description??"",title:u.title??"",icon:u.icon??""}})}}o(pe,"handleGeneratedName");function fe(e){const t=e.params.id,n=re(e.body);return m(t,n.expected_execution_id),{status:200,body:l(()=>{const i=h(t),s={kind:i.kind,mode:i.mode,lifecycle:i.lifecycle},u=i.persona_ack,d=u===void 0?s:{kind:u.kind??i.kind,mode:u.mode,lifecycle:u.lifecycle};return!F(s,n.to)||!F(d,n.from)?{applied:!1}:(g(t,{persona_ack:n.to}),{applied:!0})})}}o(fe,"handlePersonaAck");const Ie=[{method:"POST",pattern:"/v1/nodes/:id/broker/session-bound",handler:oe},{method:"POST",pattern:"/v1/nodes/:id/broker/settle",handler:ae},{method:"POST",pattern:"/v1/nodes/:id/broker/park-complete",handler:de},{method:"POST",pattern:"/v1/nodes/:id/broker/park-activity",handler:ue},{method:"POST",pattern:"/v1/nodes/:id/broker/model",handler:ce},{method:"GET",pattern:"/v1/nodes/:id/broker/extension-state",handler:le},{method:"POST",pattern:"/v1/nodes/:id/broker/generated-name",handler:pe},{method:"POST",pattern:"/v1/nodes/:id/broker/persona-ack",handler:fe}];export{Ie as brokerOperationRoutes};