@north-light/crouter 0.3.318 → 0.3.320

package/dist/daemon/api/handlers/nodes.js

@@ -1,939 +1 @@
-// Node resource + lifecycle handlers (spec §6.2, §7.7). Create, list, detail,
-// the read endpoints (snapshot/transcript/context/artifacts), the lifecycle
-// verbs (revive/close/recycle/demote/promote/yield/wait + revive-all), and the
-// config PATCH. Each relocates the sanctioned core primitive behind the API
-// caller and projects through map.ts (or an inlined server-side projection where
-// map.ts carries no projector — it is frozen under concurrency).
-//
-// `{id}` is the target node.
-import { envProfileId } from '../../../shared/env.js';
-import { existsSync, readdirSync, statSync } from 'node:fs';
-import { basename, isAbsolute, resolve } from 'node:path';
-import { appendSituationalContext, formatSituationalProse } from '../../../core/runtime/situational-context.js';
-import { closeNode } from '../../../core/runtime/close.js';
-import { reviveNode } from '../../../core/runtime/revive.js';
-import { nowIso } from '../../../core/fs-utils.js';
-import { assertLaunchModelRegistered, forkNode, spawnChildPrepared } from '../../../core/runtime/spawn.js';
-import { childrenOf, getNode, listNodes, subscribersOf, subscriptionsOf, setMessageWait, updateNode } from '../../../core/canvas/canvas.js';
-import { subtreeIds } from '../../../core/canvas/nav-model.js';
-import { withCanvasWrite } from '../../../core/canvas/db.js';
-import { unbindSession } from '../../../core/canvas/sessions.js';
-import { ticketCountsForNodes } from '../../../core/canvas/attention.js';
-import { contextDir, reportsDir } from '../../../core/canvas/paths.js';
-import { nodeArtifacts } from '../../../core/canvas/history.js';
-import { readNodeMessagesPage, readNodeSession, readNodeSnapshot, transcriptMarkdown } from '../../../core/runtime/node-read.js';
-import { assembleNodeSubject } from '../../../core/substrate/subject.js';
-import { reviveAll } from '../../../core/runtime/revive-all.js';
-import { promoteAsync, requestYieldAsync, reshapeNodeAsync } from '../../../core/runtime/promote.js';
-import { recycleNode } from '../../../core/runtime/recycle.js';
-import { relaunchRoot } from '../../../core/runtime/reset.js';
-import { assertReopenGate } from '../../../core/runtime/reopen.js';
-import { writeYieldMessage, readGoal } from '../../../core/runtime/kickoff.js';
-import { hasRoadmap, seedRoadmap } from '../../../core/runtime/roadmap.js';
-import { renameWindow } from '../../../core/runtime/placement.js';
-import { buildLaunchSpecAsync, isProviderPinnedModelToken, normalizeModel, readMergedLaunchConfigAsync } from '../../../core/runtime/launch.js';
-import { modelRequestFromConfig } from '../../../core/model-routes.js';
-import { BrokerUnreachableError } from '../../../core/runtime/broker-request.js';
-import { isBrokerLive, persistDormantModel, setModelLive } from '../../../core/runtime/model-swap.js';
-import { boundFleet } from '../../../core/runtime/fleet.js';
-import { writeOutputSchema } from '../../../core/runtime/structured-output.js';
-import { OUTCOME_PAYLOAD_MAX_BYTES } from '../../../core/canvas/types.js';
-import { HUMAN_ACTION_NAME_PATTERN } from '../../../core/human/action-binding.js';
-import { resolveHumanAction } from '../../../core/human-actions.js';
-import { parseDurationMs } from '../../../core/wake.js';
-import { claimWarmNode, refillWarmPool, warmPoolEnabled } from '../../../core/runtime/warm-pool.js';
-import { resolveLaunchTarget } from '../../../core/runtime/launch-target.js';
-import { fullName } from '../../../core/canvas/labels.js';
-import { reportsForNode } from './reports.js';
-import { getCron } from '../../../core/canvas/crons.js';
-import { cronWakeOrigin } from '../../../core/runtime/bearings.js';
-import { boundDaemonControl } from '../../control.js';
-import { notFound, usage } from '../../../core/errors.js';
-import { toCloseResultDTO, toNodeDetailDTO, toNodeSummaryDTO, toReviveResultDTO } from '../map.js';
-import { ApiError } from '../../../api/index.js';
-import { InputError } from '../../../core/io.js';
-// Shared helpers
-function requireMeta(id) {
-    const meta = getNode(id);
-    if (meta === null)
-        throw notFound(`unknown node: ${id}`, { received: id });
-    return meta;
-}
-/** Gather a node's spine + subscription edges (map.ts stays a pure projection,
- *  so the db reach lives here). Children = rows whose parent is this node,
- *  read via the indexed `idx_nodes_parent` point query — never a full scan. */
-function edgesFor(id) {
-    return {
-        subscribesTo: subscriptionsOf(id),
-        subscribers: subscribersOf(id),
-        children: childrenOf(id),
-    };
-}
-/** Re-read a node fresh and project its detail DTO (post-action response). */
-function detailOf(id) {
-    const meta = requireMeta(id);
-    return toNodeDetailDTO(meta, edgesFor(id));
-}
-/** Count context + report files under a node (the context-roster `files`). */
-function countFiles(id) {
-    let n = 0;
-    for (const dir of [contextDir(id), reportsDir(id)]) {
-        try {
-            n += readdirSync(dir).length;
-        }
-        catch {
-            /* dir absent — zero */
-        }
-    }
-    return n;
-}
-// POST /v1/nodes — create immediately (201)
-/** Validate + narrow the create body (spec §6.2). */
-function parseCreateBody(body) {
-    if (typeof body !== 'object' || body === null) {
-        throw usage('a node create requires a JSON body');
-    }
-    const b = body;
-    if (b['kind'] !== undefined && (typeof b['kind'] !== 'string' || b['kind'].trim() === '')) {
-        throw usage('kind must be a non-empty string when provided');
-    }
-    if (b['description'] !== undefined && (typeof b['description'] !== 'string' || b['description'].trim() === '')) {
-        throw usage('description must be a non-empty string when provided');
-    }
-    if (b['creator'] !== undefined && (typeof b['creator'] !== 'string' || b['creator'].trim() === '')) {
-        throw usage('creator must be a non-empty node id when provided');
-    }
-    const rootLifecycle = b['root_lifecycle'];
-    if (rootLifecycle !== undefined &&
-        rootLifecycle !== 'resident' &&
-        rootLifecycle !== 'terminal') {
-        throw usage("root_lifecycle must be 'resident' or 'terminal'");
-    }
-    return b;
-}
-function parseDeadline(raw) {
-    if (raw === undefined)
-        return undefined;
-    const durationMs = parseDurationMs(raw);
-    const deadlineAt = durationMs === null ? null : new Date(Date.now() + durationMs);
-    if (durationMs === null || !Number.isFinite(durationMs) || durationMs <= 0 || deadlineAt === null || !Number.isFinite(deadlineAt.getTime())) {
-        throw new ApiError(422, 'invalid_deadline', '`deadline` must be a positive representable duration');
-    }
-    return deadlineAt.toISOString();
-}
-function parseOutcomeDelivery(raw) {
-    if (raw === undefined)
-        return undefined;
-    if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
-        throw new ApiError(400, 'invalid_request', '`outcome_delivery` must be an object');
-    }
-    if (typeof raw.action !== 'string' || !HUMAN_ACTION_NAME_PATTERN.test(raw.action)) {
-        throw new ApiError(400, 'invalid_request', '`outcome_delivery.action` must be a declared action name');
-    }
-    if (raw.payload !== undefined) {
-        let serialized;
-        try {
-            serialized = JSON.stringify(raw.payload);
-        }
-        catch {
-            throw new ApiError(400, 'invalid_request', '`outcome_delivery.payload` must be JSON-serializable');
-        }
-        if (serialized === undefined) {
-            throw new ApiError(400, 'invalid_request', '`outcome_delivery.payload` must be JSON-serializable');
-        }
-        if (Buffer.byteLength(serialized, 'utf8') > OUTCOME_PAYLOAD_MAX_BYTES) {
-            throw new ApiError(413, 'payload_too_large', `serialized payload exceeds ${OUTCOME_PAYLOAD_MAX_BYTES} bytes`);
-        }
-    }
-    return raw;
-}
-function resolveOutcomeDelivery(request, cwd) {
-    const resolution = resolveHumanAction(request.action, cwd);
-    if (!('kind' in resolution)) {
-        return {
-            actionName: request.action,
-            argv: resolution.argv,
-            cwd: resolution.cwd,
-            configOrigin: resolution.configOrigin,
-            ...(request.payload === undefined ? {} : { payload: request.payload }),
-        };
-    }
-    if (resolution.kind === 'unknown_action') {
-        throw new ApiError(422, 'unknown_action', `no action named ${request.action} is declared from ${cwd}`);
-    }
-    throw new ApiError(422, 'invalid_action', `${request.action} is declared in ${resolution.configOrigin} but unusable: ${resolution.reason}`, { reason: resolution.reason, configOrigin: resolution.configOrigin });
-}
-/** Build the immediate spawn recipe. */
-function buildRecipe(req, parent, cwd) {
-    const recipe = {
-        kind: req.kind,
-        cwd,
-        prompt: req.prompt ?? '',
-    };
-    if (req.mode !== undefined)
-        recipe.mode = req.mode;
-    if (req.name !== undefined)
-        recipe.name = req.name;
-    if (req.description !== undefined)
-        recipe.description = req.description;
-    if (parent !== undefined)
-        recipe.parent = parent;
-    if (req.creator !== undefined)
-        recipe.creator = req.creator;
-    if (req.root === true)
-        recipe.root = true;
-    if (req.root_lifecycle !== undefined) {
-        recipe.rootLifecycle = req.root_lifecycle;
-    }
-    if (req.worktree === true || typeof req.worktree === 'string')
-        recipe.worktree = true;
-    if (typeof req.worktree === 'string')
-        recipe.worktreeBase = req.worktree;
-    if (req.worktree !== undefined)
-        recipe.worktreeCwd = resolve(req.pin_cwd ?? req.cwd ?? cwd);
-    if (req.fork_from !== undefined)
-        recipe.forkFrom = req.fork_from;
-    if (req.model !== undefined)
-        recipe.model = req.model;
-    if (req.profile !== undefined)
-        recipe.profile = req.profile;
-    if (req.situational_context !== undefined)
-        recipe.situationalContext = req.situational_context;
-    if (req.node_id !== undefined)
-        recipe.nodeId = req.node_id;
-    return recipe;
-}
-/** The warm-pool request this create is asking for, or null when it carries
- *  something a pre-booted spare cannot honor. A spare is a bare root with no
- *  kickoff, so anything that shapes the node AT BIRTH — a prompt to run, a
- *  forked conversation, a managed worktree, a model override, a caller-pinned
- *  node id, a spine parent — disqualifies it. `kind`, `mode`, `name`,
- *  `situational_context` and `output_schema` are all applied at claim time and
- *  so do not. A terminal
- *  root is not warm-compatible: every spare is resident. */
-function warmRequestFor(req, cwd, profileId) {
-    if (!warmPoolEnabled())
-        return null;
-    if (req.prefer_warm !== true)
-        return null;
-    if (req.root !== true || req.parent != null)
-        return null;
-    if (req.root_lifecycle === 'terminal')
-        return null;
-    if ((req.prompt ?? '') !== '')
-        return null;
-    // An explicit override freezes the requested model before the first turn;
-    // applying it to a live spare would switch models after its broker already
-    // launched its default route.
-    if (req.model !== undefined)
-        return null;
-    if (req.fork_from !== undefined || req.worktree !== undefined || req.node_id !== undefined)
-        return null;
-    return {
-        kind: req.kind,
-        mode: (req.mode ?? 'base'),
-        cwd,
-        profileId,
-        model: req.model ?? null,
-        situationalContext: req.situational_context ?? null,
-        name: req.name ?? null,
-        creator: req.creator ?? null,
-    };
-}
-export { resolveCreateKind } from '../../../core/runtime/launch-target.js';
-function requestFromLaunch(launch) {
-    const intent = launch.modelIntent === undefined
-        ? undefined
-        : `${launch.modelIntent.family}/${launch.modelIntent.strength}`;
-    return modelRequestFromConfig(launch.model, intent, launch.modelExact === true);
-}
-async function assertNodeModelChangeRegistered(meta, target, registry) {
-    const launch = (await buildLaunchSpecAsync(target.kind, target.mode, {
-        lifecycle: target.lifecycle,
-        hasManager: meta.parent !== null,
-        model: target.model,
-        modelOverride: true,
-        cwd: meta.cwd,
-        profileId: meta.profile_id ?? null,
-    })).launch;
-    await assertLaunchModelRegistered(requestFromLaunch(launch), { cwd: meta.cwd, profileId: meta.profile_id ?? null }, registry);
-}
-export async function handleCreate(ctx, deps = {}) {
-    const req = parseCreateBody(ctx.body);
-    const deadline = parseDeadline(req.deadline);
-    const outcomeDelivery = parseOutcomeDelivery(req.outcome_delivery);
-    // `no_kickoff` needs no dedicated recipe field: an empty prompt IS the
-    // no-kickoff mechanism (spawnChild runs no launch turn on prompt===''), and
-    // buildRecipe already defaults `prompt` to ''. The CLI keeps every no_kickoff
-    // guards (root-only / no-prompt / no-orchestrator).
-    const parent = req.parent ?? undefined;
-    // Immediate spawn (201). A managed child needs a parent; a root does not.
-    if (parent == null && req.root !== true) {
-        throw usage('a node create requires a parent (or root: true for an independent root)');
-    }
-    // Parse BEFORE spawning: a malformed schema must not leave behind a live,
-    // schema-less node that was told to submit a structured result.
-    let schema = null;
-    if (req.output_schema !== undefined) {
-        try {
-            schema = JSON.parse(req.output_schema);
-        }
-        catch {
-            throw usage('output_schema must be a JSON schema string');
-        }
-    }
-    // Resolve and validate the exact launch recipe before the warm pool can claim
-    // a spare (or the cold path can create a worktree/node). The registry belongs
-    // to this daemon, never to the possibly-remote CLI caller.
-    const { profileId, kind, cwd, launch } = await resolveLaunchTarget(req, { validateKind: assertKindServer });
-    const resolvedReq = { ...req, kind };
-    const resolvedOutcomeDelivery = outcomeDelivery === undefined ? undefined : resolveOutcomeDelivery(outcomeDelivery, cwd);
-    await assertLaunchModelRegistered(requestFromLaunch(launch), { cwd, profileId }, deps.modelRegistry);
-    let warmRefill = null;
-    {
-        // --- Warm path: hand out an already-booted spare instead of paying a full
-        //     engine boot. A miss is not a failure — it falls through to the cold
-        //     spawn below and mints the spare that serves the NEXT create. ---
-        const warm = warmRequestFor(resolvedReq, cwd, profileId);
-        if (warm !== null) {
-            const claimed = await claimWarmNode(warm, {
-                ...(deadline === undefined ? {} : { deadlineAt: deadline }),
-                ...(resolvedOutcomeDelivery === undefined ? {} : { outcomeDelivery: resolvedOutcomeDelivery }),
-            }, schema === null ? undefined : (nodeId) => writeOutputSchema(nodeId, 'terminal', schema));
-            if (claimed !== null) {
-                refillWarmPool(warm);
-                return { status: 201, body: detailOf(claimed) };
-            }
-            warmRefill = warm;
-        }
-        const recipe = buildRecipe(resolvedReq, parent, cwd);
-        if (deadline !== undefined)
-            recipe.deadlineAt = deadline;
-        if (resolvedOutcomeDelivery !== undefined)
-            recipe.outcomeDelivery = resolvedOutcomeDelivery;
-        recipe.readiness = req.root === true ? 'await' : 'launch';
-        const result = await spawnChildPrepared(recipe, schema === null ? undefined : (nodeId) => writeOutputSchema(nodeId, 'terminal', schema), () => {
-            if (warmRefill !== null)
-                refillWarmPool(warmRefill);
-        });
-        return { status: 201, body: detailOf(result.node.node_id) };
-    }
-}
-// GET /v1/nodes — list (filters) ; GET /v1/nodes/{id} — detail
-function singleQueryValue(ctx, name) {
-    const values = ctx.query.getAll(name);
-    if (values.length > 1)
-        throw usage(`${name} must appear at most once`);
-    return values[0];
-}
-function optionalBoolean(value, name) {
-    if (value === undefined)
-        return undefined;
-    if (value === '1' || value === 'true')
-        return true;
-    if (value === '0' || value === 'false')
-        return false;
-    throw usage(`${name} must be true or false`);
-}
-function oneOf(value, name, allowed) {
-    if (value === undefined)
-        return undefined;
-    if (allowed.includes(value))
-        return value;
-    throw usage(`${name} must be one of: ${allowed.join(', ')}`);
-}
-function parseListQuery(ctx) {
-    const allowed = new Set([
-        'status', 'lifecycle', 'kind', 'mode', 'profile_id', 'profile_prefix',
-        'parent', 'top_level', 'under', 'hanging', 'include',
-    ]);
-    for (const [name] of ctx.query) {
-        if (!allowed.has(name))
-            throw usage(`unknown nodes query parameter: ${name}`);
-    }
-    const status = oneOf(singleQueryValue(ctx, 'status'), 'status', ['active', 'idle', 'done', 'dead', 'canceled']);
-    const lifecycle = oneOf(singleQueryValue(ctx, 'lifecycle'), 'lifecycle', ['terminal', 'resident']);
-    const kind = singleQueryValue(ctx, 'kind');
-    const mode = oneOf(singleQueryValue(ctx, 'mode'), 'mode', ['base', 'orchestrator']);
-    const profileId = singleQueryValue(ctx, 'profile_id');
-    const profilePrefix = singleQueryValue(ctx, 'profile_prefix');
-    const parent = singleQueryValue(ctx, 'parent');
-    const topLevel = optionalBoolean(singleQueryValue(ctx, 'top_level'), 'top_level');
-    const under = singleQueryValue(ctx, 'under');
-    const hanging = optionalBoolean(singleQueryValue(ctx, 'hanging'), 'hanging');
-    const include = oneOf(singleQueryValue(ctx, 'include'), 'include', ['activity']);
-    if (parent !== undefined && topLevel === true) {
-        throw usage('parent and top_level=true cannot be combined');
-    }
-    return {
-        ...(status !== undefined ? { status } : {}),
-        ...(lifecycle !== undefined ? { lifecycle } : {}),
-        ...(kind !== undefined ? { kind } : {}),
-        ...(mode !== undefined ? { mode } : {}),
-        ...(profileId !== undefined ? { profile_id: profileId } : {}),
-        ...(profilePrefix !== undefined ? { profile_prefix: profilePrefix } : {}),
-        ...(parent !== undefined ? { parent } : {}),
-        ...(topLevel !== undefined ? { top_level: topLevel } : {}),
-        ...(under !== undefined ? { under } : {}),
-        ...(hanging !== undefined ? { hanging } : {}),
-        ...(include !== undefined ? { include: include } : {}),
-    };
-}
-export function handleList(ctx) {
-    const query = parseListQuery(ctx);
-    let rows = query.status !== undefined ? listNodes({ status: query.status }) : listNodes();
-    if (query.lifecycle !== undefined)
-        rows = rows.filter((row) => row.lifecycle === query.lifecycle);
-    if (query.kind !== undefined)
-        rows = rows.filter((row) => row.kind === query.kind);
-    if (query.mode !== undefined)
-        rows = rows.filter((row) => row.mode === query.mode);
-    if (query.profile_id !== undefined)
-        rows = rows.filter((row) => row.profile_id === query.profile_id);
-    if (query.profile_prefix !== undefined)
-        rows = rows.filter((row) => row.profile_id?.startsWith(query.profile_prefix));
-    if (query.parent !== undefined)
-        rows = rows.filter((row) => row.parent === query.parent);
-    if (query.top_level === true)
-        rows = rows.filter((row) => row.parent === null);
-    if (query.under !== undefined) {
-        const scope = new Set(subtreeIds(query.under));
-        rows = rows.filter((row) => scope.has(row.node_id));
-    }
-    if (query.hanging === true) {
-        rows = rows.filter((row) => row.parent !== null && getNode(row.parent) === null);
-    }
-    const counts = query.include === 'activity'
-        ? ticketCountsForNodes(rows.map((row) => row.node_id))
-        : null;
-    const body = rows.map((row) => {
-        const node = toNodeSummaryDTO(row);
-        if (counts !== null) {
-            const reports = reportsForNode(row.node_id);
-            node.activity = {
-                latest_report: reports[0] ?? null,
-                final_report: row.final_report === null
-                    ? null
-                    : reports.find((report) => basename(report.path) === row.final_report) ?? null,
-                pending_human_count: counts[row.node_id] ?? 0,
-            };
-        }
-        return node;
-    });
-    return { status: 200, body };
-}
-function handleDetail(ctx) {
-    const id = ctx.params['id'];
-    requireMeta(id);
-    return { status: 200, body: detailOf(id) };
-}
-// Read endpoints (snapshot / transcript / context / artifacts)
-async function handleSnapshot(ctx) {
-    const id = ctx.params['id'];
-    requireMeta(id);
-    const read = await readNodeSnapshot(id);
-    const body = {
-        node_id: id,
-        snapshot: {
-            messages: read.snapshot.messages,
-            ...(read.snapshot.messageIds === undefined ? {} : { messageIds: read.snapshot.messageIds }),
-            messageVisibility: read.snapshot.messageVisibility,
-            turnVisibility: read.snapshot.turnVisibility,
-            stats: read.snapshot.stats,
-            state: read.snapshot.state,
-            display: read.snapshot.display,
-            ...(read.snapshot.queued === undefined ? {} : { queued: read.snapshot.queued }),
-            ...(read.snapshot.toolGroupSummaries === undefined
-                ? {}
-                : { toolGroupSummaries: read.snapshot.toolGroupSummaries }),
-            ...(read.snapshot.workingActivity === undefined ? {} : { workingActivity: read.snapshot.workingActivity }),
-        },
-        commands: read.commands.map((c) => ({ name: c.name, description: c.description, source: c.source })),
-        captured_at: nowIso(),
-    };
-    return { status: 200, body };
-}
-async function handleSubject(ctx) {
-    const id = ctx.params['id'];
-    const subject = assembleNodeSubject(id);
-    if (subject === null)
-        throw notFound(`unknown node: ${id}`, { received: id });
-    return { status: 200, body: subject };
-}
-function parseMessagesQuery(ctx) {
-    for (const [field] of ctx.query) {
-        if (field !== 'cursor' && field !== 'limit')
-            throw usage(`unknown messages query parameter: ${field}`);
-    }
-    const cursors = ctx.query.getAll('cursor');
-    const limits = ctx.query.getAll('limit');
-    if (cursors.length > 1)
-        throw usage('cursor must appear at most once');
-    if (limits.length > 1)
-        throw usage('limit must appear at most once');
-    if (limits.length === 0)
-        return cursors.length === 0 ? {} : { cursor: cursors[0] };
-    const rawLimit = limits[0];
-    const limit = Number(rawLimit);
-    if (!Number.isSafeInteger(limit) || rawLimit === '') {
-        throw usage('limit must be an integer from 1 through 500');
-    }
-    return cursors.length === 0 ? { limit } : { cursor: cursors[0], limit };
-}
-/** Offline, backward-paged read of the cycle-flattened visible history. */
-async function handleMessages(ctx) {
-    const id = ctx.params['id'];
-    const read = await readNodeMessagesPage(id, parseMessagesQuery(ctx));
-    const body = {
-        node_id: id,
-        messages: read.messages,
-        ...(read.messageIds === undefined ? {} : { message_ids: read.messageIds }),
-        message_visibility: read.messageVisibility,
-        next_cursor: read.nextCursor,
-        captured_at: nowIso(),
-    };
-    return { status: 200, body };
-}
-/** The faithful export read: raw `.jsonl` bytes + assembled system prompt.
- *  `/snapshot` reconstructs a cycle-flattened `AgentMessage[]` for renderers and
- *  drops what a renderer cannot show; this drops nothing. */
-function handleSession(ctx) {
-    const id = ctx.params['id'];
-    requireMeta(id);
-    const read = readNodeSession(id);
-    const body = {
-        node_id: id,
-        session_file: read.sessionFile,
-        session_jsonl: read.sessionJsonl,
-        system_prompt: read.systemPrompt,
-        captured_at: nowIso(),
-    };
-    return { status: 200, body };
-}
-async function handleTranscript(ctx) {
-    const id = ctx.params['id'];
-    requireMeta(id);
-    const body = { node_id: id, markdown: await transcriptMarkdown(id) };
-    return { status: 200, body };
-}
-function handleContext(ctx) {
-    const id = ctx.params['id'];
-    requireMeta(id);
-    // The roster of context roots this node can read: its own dir plus each
-    // publisher it subscribes to (the shared-document store, spec §Reports).
-    const roots = [
-        { node_id: id, label: getNode(id)?.name ?? id, dir: contextDir(id), self: true, files: countFiles(id) },
-    ];
-    for (const ref of subscriptionsOf(id)) {
-        roots.push({
-            node_id: ref.node_id,
-            label: getNode(ref.node_id)?.name ?? ref.node_id,
-            dir: contextDir(ref.node_id),
-            self: false,
-            files: countFiles(ref.node_id),
-        });
-    }
-    return { status: 200, body: { node_id: id, roots } };
-}
-function handleArtifacts(ctx) {
-    const id = ctx.params['id'];
-    requireMeta(id);
-    // Optional corpus narrowing (spec §6.2). Absent → the default report/doc/
-    // roadmap set; `inbox` is opt-in and only reachable via an explicit type.
-    const type = ctx.query.get('type');
-    const artifacts = nodeArtifacts(id, type !== null ? [type] : undefined).map((a) => ({
-        ref: a.ref,
-        source: a.source === 'report' && a.reportKind !== undefined ? `report:${a.reportKind}` : a.source,
-        ts: a.ts,
-        title: a.title,
-    }));
-    const body = { node_id: id, artifacts };
-    return { status: 200, body };
-}
-// Lifecycle verbs
-export async function handleFork(ctx) {
-    const result = await forkNode(ctx.params['id']);
-    return { status: 201, body: detailOf(result.node.node_id) };
-}
-async function handleRevive(ctx) {
-    const id = ctx.params['id'];
-    requireMeta(id);
-    const body = ctx.body;
-    const resume = body?.resume ?? true;
-    const reopen = body?.reopen ?? false;
-    // Reopen gate, enforced server-side (the latch clear is a canvas write the CLI
-    // caller cannot reach): --reopen CAS-clears a spent `final_report`; the
-    // no-reopen path refuses a still-latched node (`node_finalized`). reviveNode
-    // keeps its own belt-and-suspenders latch guard under the launch lock.
-    assertReopenGate(id, reopen);
-    // Wake provenance (only a FRESH revive has a kickoff to carry it): a cron run
-    // forwards its `CRTR_CRON_ID`, so the revived node is told a CLOCK woke it
-    // rather than a message. A cron id that no longer resolves (canceled or
-    // consumed mid-run) simply yields no block — prose, never an error.
-    const cron = !resume && body?.cron_id !== undefined ? getCron(body.cron_id) : null;
-    const result = await reviveNode(id, {
-        resume,
-        // An explicit revive is a caller asking for this node NOW; at the cap it
-        // gets the refusal naming it rather than a silent nothing-happened.
-        capacity: 'refuse',
-        ...(cron !== null ? { wakeReason: cronWakeOrigin(cron, 'schedule_revive') } : {}),
-    });
-    const status = (getNode(id)?.status ?? 'active');
-    return { status: 200, body: toReviveResultDTO(id, result, status) };
-}
-async function handleRelaunchRoot(ctx) {
-    const id = ctx.params['id'];
-    const result = await relaunchRoot(id);
-    return { status: 200, body: { newNodeId: result?.newNodeId ?? null } };
-}
-function handleClose(ctx) {
-    const id = ctx.params['id'];
-    requireMeta(id);
-    // closeNode always computes the cascade + spared set itself; the DTO `cascade`
-    // opt-out has no primitive knob in this version (documented Stage-A limit).
-    // `finish` selects the root disposition: finalize to `done` (browse `x`) vs the
-    // default cancel.
-    const body = ctx.body;
-    if (body?.caller_pid !== undefined && (!Number.isInteger(body.caller_pid) || body.caller_pid <= 0)) {
-        throw usage('caller_pid must be a positive integer when provided');
-    }
-    const daemon = boundDaemonControl();
-    const result = closeNode(id, {
-        rootEvent: body?.finish === true ? 'finish' : 'cancel',
-        callerPid: body?.caller_pid,
-        ...(daemon === null ? {} : { registerDetached: daemon.registerDetached }),
-    });
-    return { status: 200, body: toCloseResultDTO(result) };
-}
-async function handleRecycle(ctx) {
-    const id = ctx.params['id'];
-    requireMeta(id);
-    // The server has no tmux pane, so recycle's destructive pane re-exec is a
-    // Stage-B local concern; the server half runs pane-less and returns
-    // `recycled:false` without a destructive op.
-    const result = await recycleNode(id);
-    return {
-        status: 200,
-        body: {
-            recycled: result.recycled,
-            finalized: result.finalized,
-            new_root: result.newRoot,
-            delivered: result.delivered,
-        },
-    };
-}
-async function handleDemote(ctx) {
-    const id = ctx.params['id'];
-    requireMeta(id);
-    // Use the canonical reshape primitive to ensure modelExact, provider
-    // pin/intent, and default-name migration are all preserved.
-    await reshapeNodeAsync(id, { lifecycle: 'terminal' });
-    return { status: 200, body: detailOf(id) };
-}
-export async function handlePromote(ctx, deps = {}) {
-    const id = ctx.params['id'];
-    const meta = requireMeta(id);
-    const req = ctx.body ?? {};
-    if (req.model !== undefined) {
-        await assertNodeModelChangeRegistered(meta, {
-            kind: req.kind ?? meta.kind,
-            mode: 'orchestrator',
-            lifecycle: req.resident === true ? 'resident' : meta.lifecycle,
-            model: req.model,
-        }, deps.modelRegistry);
-    }
-    const result = await promoteAsync(id, {
-        ...(req.kind !== undefined ? { kind: req.kind } : {}),
-        ...(req.resident === true ? { resident: true } : {}),
-        ...(req.model !== undefined ? { model: req.model } : {}),
-    });
-    const dto = toNodeDetailDTO(result.meta, edgesFor(id));
-    // Surface the promote-only roadmap/goal facts the primitive returns beyond the
-    // node meta (the CLI renders roadmap_written/roadmap_path/goal_path).
-    dto.roadmap_written = result.roadmapWritten;
-    dto.roadmap_path = result.roadmapPath;
-    dto.goal_path = result.goalPath;
-    return { status: 200, body: dto };
-}
-export async function handleYield(ctx, deps = {}) {
-    const id = ctx.params['id'];
-    const meta = requireMeta(id);
-    const req = ctx.body ?? {};
-    if (req.model !== undefined) {
-        await assertNodeModelChangeRegistered(meta, {
-            kind: req.kind ?? meta.kind,
-            mode: req.promote === true ? 'orchestrator' : meta.mode,
-            lifecycle: meta.lifecycle,
-            model: req.model,
-        }, deps.modelRegistry);
-    }
-    const note = req.note ?? 'Refresh: continue against your roadmap or goal.';
-    writeYieldMessage(id, note);
-    const result = await requestYieldAsync(id, {
-        ...(req.promote === true ? { promote: true } : {}),
-        ...(req.kind !== undefined ? { kind: req.kind } : {}),
-        ...(req.model !== undefined ? { model: req.model } : {}),
-    });
-    return { status: 200, body: toNodeDetailDTO(result.meta, edgesFor(id)) };
-}
-function handleWait(ctx) {
-    const id = ctx.params['id'];
-    requireMeta(id);
-    const req = ctx.body;
-    if (req === undefined || typeof req.controller !== 'string' || req.controller.trim() === '') {
-        throw usage('a wait requires a controller node id');
-    }
-    const controller = getNode(req.controller);
-    if (controller === null)
-        throw notFound(`unknown controller: ${req.controller}`, { received: req.controller });
-    if (controller.status !== 'active' && controller.status !== 'idle') {
-        // A dead controller can never settle the wait — reject as unprocessable.
-        // ApiError (not a plain literal) so its message survives `toErrorBody`'s
-        // String(err) on the wire.
-        throw new ApiError(422, 'unprocessable', `controller ${req.controller} is ${controller.status}`);
-    }
-    setMessageWait(id, req.controller);
-    return { status: 200, body: detailOf(id) };
-}
-async function handleReviveAll() {
-    const result = await reviveAll();
-    const body = {
-        revived: [...result.revived],
-        failed: [...result.failed],
-        frozen: [...result.frozen],
-    };
-    return { status: 200, body };
-}
-// PATCH /v1/nodes/{id}/config — durable config and repair-only cwd (spec §6.2)
-export async function handleConfig(ctx, deps = {}) {
-    const id = ctx.params['id'];
-    const body = ctx.body;
-    let patch;
-    if (body === undefined) {
-        patch = {};
-    }
-    else if (typeof body === 'object' && body !== null && !Array.isArray(body)) {
-        patch = body;
-    }
-    else {
-        throw new InputError({
-            error: 'cwd_invalid',
-            message: 'cwd repair requires a non-null object with a non-empty cwd string',
-            received: body,
-            field: 'cwd',
-            next: 'Send a config patch with a non-empty absolute cwd string.',
-        });
-    }
-    if (Object.prototype.hasOwnProperty.call(patch, 'cwd')) {
-        const cwd = patch.cwd;
-        if (typeof cwd !== 'string' || cwd === '') {
-            throw new InputError({
-                error: 'cwd_invalid',
-                message: 'cwd must be a non-empty string',
-                received: cwd,
-                field: 'cwd',
-                next: 'Send a non-empty absolute cwd string.',
-            });
-        }
-        if (Object.keys(patch).some((key) => key !== 'cwd' && patch[key] !== undefined)) {
-            throw new InputError({
-                error: 'cwd_not_exclusive',
-                message: 'cwd repair cannot be combined with another config field',
-                received: patch,
-                field: 'cwd',
-                next: 'Send cwd as the only config field.',
-            });
-        }
-        const meta = requireMeta(id);
-        if (boundFleet().has(id)) {
-            const message = `${id} cannot repair its cwd while its broker is live`;
-            throw new ApiError(409, 'cwd_node_live', message, {
-                error: 'cwd_node_live',
-                message,
-                received: cwd,
-                field: 'cwd',
-                next: 'Let the node become dormant, then retry the cwd repair.',
-            });
-        }
-        if (meta.fork_from != null) {
-            throw new InputError({
-                error: 'cwd_node_forked',
-                message: `${id} is a fork and cannot repair its cwd; recorded cwd: ${meta.cwd}`,
-                received: cwd,
-                field: 'cwd',
-                next: `Restore ${meta.cwd}, then revive the fork normally.`,
-            });
-        }
-        if (meta.managed_worktree?.state === 'open') {
-            throw new InputError({
-                error: 'cwd_node_managed_worktree_open',
-                message: `${id} owns an open managed worktree and cannot repair its cwd`,
-                received: cwd,
-                field: 'cwd',
-                next: 'Restore or reconcile the recorded checkout, then use the managed-worktree close or abandon flow.',
-            });
-        }
-        if (existsSync(meta.cwd)) {
-            throw new InputError({
-                error: 'cwd_still_present',
-                message: `${id} recorded cwd still exists: ${meta.cwd}; cwd repair is not a relocation command`,
-                received: cwd,
-                field: 'cwd',
-                next: 'This command only repairs a node whose recorded cwd is gone.',
-            });
-        }
-        if (!isAbsolute(cwd)) {
-            throw new InputError({
-                error: 'cwd_not_absolute',
-                message: `cwd must be an absolute path: ${cwd}`,
-                received: cwd,
-                field: 'cwd',
-                next: 'Send an absolute path.',
-            });
-        }
-        const resolved = resolve(cwd);
-        if (!existsSync(resolved)) {
-            throw new InputError({
-                error: 'cwd_missing',
-                message: `cwd does not exist: ${resolved}`,
-                received: cwd,
-                field: 'cwd',
-                next: 'Create the replacement directory or send an existing absolute directory.',
-            });
-        }
-        try {
-            if (!statSync(resolved).isDirectory()) {
-                throw new InputError({
-                    error: 'cwd_not_a_directory',
-                    message: `cwd is not a directory: ${resolved}`,
-                    received: cwd,
-                    field: 'cwd',
-                    next: 'Send an existing absolute directory.',
-                });
-            }
-        }
-        catch (error) {
-            if (error instanceof InputError)
-                throw error;
-            throw new InputError({
-                error: 'cwd_missing',
-                message: `cwd does not exist: ${resolved}`,
-                received: cwd,
-                field: 'cwd',
-                next: 'Create the replacement directory or send an existing absolute directory.',
-            });
-        }
-        withCanvasWrite(() => {
-            updateNode(id, { cwd: resolved });
-            unbindSession(id);
-        });
-        return { status: 200, body: detailOf(id) };
-    }
-    let meta = requireMeta(id);
-    if (patch.situational_context !== undefined) {
-        appendSituationalContext(id, formatSituationalProse(patch.situational_context));
-    }
-    if (patch.model !== undefined) {
-        const pinned = isProviderPinnedModelToken(patch.model);
-        const ladders = (await readMergedLaunchConfigAsync(meta.cwd, meta.profile_id ?? null)).modelLadders;
-        const spec = normalizeModel(patch.model, ladders);
-        await assertLaunchModelRegistered({ kind: 'concrete', spec }, { cwd: meta.cwd, profileId: meta.profile_id ?? null }, deps.modelRegistry);
-        const persistDormant = () => {
-            // Dormant: persist a fully-qualified `provider/id` spec to the row.
-            if (!spec.includes('/'))
-                throw usage(`model must resolve to a provider/id spec: ${patch.model}`);
-            persistDormantModel(id, spec, pinned);
-        };
-        if (isBrokerLive(meta)) {
-            // Live broker: swap the model over its view socket (spec §6.2). The
-            // liveness heuristic (pid alive + socket present) can win the race against
-            // a broker that is mid-revive: the socket file exists but the connection
-            // is refused/closed before any frame. That surfaces as a
-            // BrokerUnreachableError — fall back to the durable dormant persist (the
-            // next revive applies it, the same guarantee the dormant branch gives)
-            // rather than 500ing. A genuine broker rejection (e.g. an invalid model)
-            // rejects with a plain Error and still surfaces.
-            try {
-                await setModelLive(id, spec, pinned);
-            }
-            catch (err) {
-                if (!(err instanceof BrokerUnreachableError))
-                    throw err;
-                persistDormant();
-            }
-        }
-        else {
-            persistDormant();
-        }
-        // Re-read so the launch-spec rebuild below sees the fresh model pin.
-        meta = requireMeta(id);
-    }
-    // kind / mode / lifecycle: reshape via canonical primitive (CLI parity).
-    if (patch.kind !== undefined || patch.mode !== undefined || patch.lifecycle !== undefined) {
-        if (patch.kind !== undefined)
-            await assertKindServer(patch.kind);
-        const newKind = patch.kind ?? meta.kind;
-        const newMode = (patch.mode ?? meta.mode);
-        const newLifecycle = patch.lifecycle ?? meta.lifecycle;
-        // Setting orchestrator seeds a roadmap scaffold if absent (from the goal).
-        // Pass as beforePersist callback so roadmap seeding is atomic with the
-        // launch spec rebuild.
-        let beforePersist;
-        if (newMode === 'orchestrator' && !hasRoadmap(id)) {
-            beforePersist = () => {
-                const goal = readGoal(id);
-                seedRoadmap(id, goal !== null && goal.trim() !== '' ? { goal: goal.trim() } : {});
-            };
-        }
-        // Use canonical reshape primitive to preserve modelExact, provider pin/intent,
-        // and default-name migration.
-        meta = await reshapeNodeAsync(id, {
-            ...(patch.kind !== undefined ? { kind: newKind } : {}),
-            ...(patch.mode !== undefined ? { mode: newMode } : {}),
-            ...(patch.lifecycle !== undefined ? { lifecycle: newLifecycle } : {}),
-        }, beforePersist);
-    }
-    // name: rename the row and, when it has a live viewer window, that window.
-    if (patch.name !== undefined) {
-        meta = updateNode(id, { name: patch.name });
-        if (meta.window)
-            renameWindow(meta.window, fullName(meta));
-    }
-    // `thinking` is a live-only frame (set_thinking); a dormant node has no broker
-    // to receive it, so it is a documented Stage-A no-op here.
-    return { status: 200, body: detailOf(id) };
-}
-/** POST /v1/nodes and PATCH /v1/nodes/:id/config validate kinds in the daemon's
- * ambient configuration; prospective reads validate their resolved target. The
- * read is subprocess-isolated — crtrd must never resolve config on its own loop. */
-async function assertKindServer(kind) {
-    const kinds = Object.keys((await readMergedLaunchConfigAsync(process.cwd(), envProfileId() || null)).kinds);
-    if (!kinds.includes(kind)) {
-        throw usage(`unknown kind: ${kind}`, { received: kind, next: `Valid kinds: ${kinds.sort().join(', ')}.` });
-    }
-}
-// Route table (revive-all registered before `:id` collisions are impossible —
-// different methods — but ordered defensively).
-export const nodeRoutes = [
-    { method: 'POST', pattern: '/v1/nodes', handler: handleCreate },
-    { method: 'GET', pattern: '/v1/nodes', handler: handleList },
-    { method: 'POST', pattern: '/v1/nodes/revive-all', handler: () => handleReviveAll() },
-    { method: 'GET', pattern: '/v1/nodes/:id', handler: handleDetail },
-    { method: 'GET', pattern: '/v1/nodes/:id/snapshot', handler: handleSnapshot },
-    { method: 'GET', pattern: '/v1/nodes/:id/subject', handler: handleSubject },
-    { method: 'GET', pattern: '/v1/nodes/:id/messages', handler: handleMessages },
-    { method: 'GET', pattern: '/v1/nodes/:id/session', handler: handleSession },
-    { method: 'GET', pattern: '/v1/nodes/:id/transcript', handler: handleTranscript },
-    { method: 'GET', pattern: '/v1/nodes/:id/context', handler: handleContext },
-    { method: 'GET', pattern: '/v1/nodes/:id/artifacts', handler: handleArtifacts },
-    { method: 'POST', pattern: '/v1/nodes/:id/fork', handler: handleFork },
-    { method: 'POST', pattern: '/v1/nodes/:id/revive', handler: handleRevive },
-    { method: 'POST', pattern: '/v1/nodes/:id/relaunch-root', handler: handleRelaunchRoot },
-    { method: 'POST', pattern: '/v1/nodes/:id/close', handler: handleClose },
-    { method: 'POST', pattern: '/v1/nodes/:id/recycle', handler: handleRecycle },
-    { method: 'POST', pattern: '/v1/nodes/:id/demote', handler: handleDemote },
-    { method: 'POST', pattern: '/v1/nodes/:id/promote', handler: handlePromote },
-    { method: 'POST', pattern: '/v1/nodes/:id/yield', handler: handleYield },
-    { method: 'POST', pattern: '/v1/nodes/:id/wait', handler: handleWait },
-    { method: 'PATCH', pattern: '/v1/nodes/:id/config', handler: handleConfig },
-];
+var Q=Object.defineProperty;var d=(e,t)=>Q(e,"name",{value:t,configurable:!0});import{envProfileId as U}from"../../../shared/env.js";import{existsSync as D,readdirSync as X,statSync as Z}from"node:fs";import{basename as q,isAbsolute as ee,resolve as C}from"node:path";import{appendSituationalContext as ne,formatSituationalProse as te}from"../../../core/runtime/situational-context.js";import{closeNode as oe}from"../../../core/runtime/close.js";import{reviveNode as ie}from"../../../core/runtime/revive.js";import{nowIso as T}from"../../../core/fs-utils.js";import{assertLaunchModelRegistered as $,forkNode as re,spawnChildPrepared as de}from"../../../core/runtime/spawn.js";import{childrenOf as se,getNode as b,listNodes as I,subscribersOf as ae,subscriptionsOf as M,setMessageWait as le,updateNode as E}from"../../../core/canvas/canvas.js";import{subtreeIds as ce}from"../../../core/canvas/nav-model.js";import{withCanvasWrite as ue}from"../../../core/canvas/db.js";import{unbindSession as fe}from"../../../core/canvas/sessions.js";import{ticketCountsForNodes as me}from"../../../core/canvas/attention.js";import{contextDir as A,reportsDir as pe}from"../../../core/canvas/paths.js";import{nodeArtifacts as he}from"../../../core/canvas/history.js";import{readNodeMessagesPage as we,readNodeSession as ye,readNodeSnapshot as _e,transcriptMarkdown as ge}from"../../../core/runtime/node-read.js";import{assembleNodeSubject as be}from"../../../core/substrate/subject.js";import{reviveAll as ve}from"../../../core/runtime/revive-all.js";import{promoteAsync as ke,requestYieldAsync as Se,reshapeNodeAsync as L}from"../../../core/runtime/promote.js";import{recycleNode as Oe}from"../../../core/runtime/recycle.js";import{relaunchRoot as Ne}from"../../../core/runtime/reset.js";import{assertReopenGate as Te}from"../../../core/runtime/reopen.js";import{writeYieldMessage as $e,readGoal as Ae}from"../../../core/runtime/kickoff.js";import{hasRoadmap as Pe,seedRoadmap as Re}from"../../../core/runtime/roadmap.js";import{renameWindow as xe}from"../../../core/runtime/placement.js";import{buildLaunchSpecAsync as De,isProviderPinnedModelToken as Ce,normalizeModel as Ie,readMergedLaunchConfigAsync as j}from"../../../core/runtime/launch.js";import{modelRequestFromConfig as Me}from"../../../core/model-routes.js";import{BrokerUnreachableError as Ee}from"../../../core/runtime/broker-request.js";import{isBrokerLive as Le,persistDormantModel as je,setModelLive as Fe}from"../../../core/runtime/model-swap.js";import{boundFleet as Ge}from"../../../core/runtime/fleet.js";import{writeOutputSchema as F}from"../../../core/runtime/structured-output.js";import{OUTCOME_PAYLOAD_MAX_BYTES as G}from"../../../core/canvas/types.js";import{HUMAN_ACTION_NAME_PATTERN as ze}from"../../../core/human/action-binding.js";import{resolveHumanAction as We}from"../../../core/human-actions.js";import{parseDurationMs as Be}from"../../../core/wake.js";import{claimWarmNode as Je,refillWarmPool as z,warmPoolEnabled as Ve}from"../../../core/runtime/warm-pool.js";import{resolveLaunchTarget as Ke}from"../../../core/runtime/launch-target.js";import{fullName as Ye}from"../../../core/canvas/labels.js";import{reportsForNode as He}from"./reports.js";import{getCron as Qe}from"../../../core/canvas/crons.js";import{cronWakeOrigin as Ue}from"../../../core/runtime/bearings.js";import{boundDaemonControl as Xe}from"../../control.js";import{notFound as P,usage as u}from"../../../core/errors.js";import{toCloseResultDTO as Ze,toNodeDetailDTO as R,toNodeSummaryDTO as qe,toReviveResultDTO as en}from"../map.js";import{ApiError as w}from"../../../api/index.js";import{InputError as p}from"../../../core/io.js";function f(e){const t=b(e);if(t===null)throw P(`unknown node: ${e}`,{received:e});return t}d(f,"requireMeta");function x(e){return{subscribesTo:M(e),subscribers:ae(e),children:se(e)}}d(x,"edgesFor");function y(e){const t=f(e);return R(t,x(e))}d(y,"detailOf");function W(e){let t=0;for(const n of[A(e),pe(e)])try{t+=X(n).length}catch{}return t}d(W,"countFiles");function nn(e){if(typeof e!="object"||e===null)throw u("a node create requires a JSON body");const t=e;if(t.kind!==void 0&&(typeof t.kind!="string"||t.kind.trim()===""))throw u("kind must be a non-empty string when provided");if(t.description!==void 0&&(typeof t.description!="string"||t.description.trim()===""))throw u("description must be a non-empty string when provided");if(t.creator!==void 0&&(typeof t.creator!="string"||t.creator.trim()===""))throw u("creator must be a non-empty node id when provided");const n=t.root_lifecycle;if(n!==void 0&&n!=="resident"&&n!=="terminal")throw u("root_lifecycle must be 'resident' or 'terminal'");return t}d(nn,"parseCreateBody");function tn(e){if(e===void 0)return;const t=Be(e),n=t===null?null:new Date(Date.now()+t);if(t===null||!Number.isFinite(t)||t<=0||n===null||!Number.isFinite(n.getTime()))throw new w(422,"invalid_deadline","`deadline` must be a positive representable duration");return n.toISOString()}d(tn,"parseDeadline");function on(e){if(e!==void 0){if(typeof e!="object"||e===null||Array.isArray(e))throw new w(400,"invalid_request","`outcome_delivery` must be an object");if(typeof e.action!="string"||!ze.test(e.action))throw new w(400,"invalid_request","`outcome_delivery.action` must be a declared action name");if(e.payload!==void 0){let t;try{t=JSON.stringify(e.payload)}catch{throw new w(400,"invalid_request","`outcome_delivery.payload` must be JSON-serializable")}if(t===void 0)throw new w(400,"invalid_request","`outcome_delivery.payload` must be JSON-serializable");if(Buffer.byteLength(t,"utf8")>G)throw new w(413,"payload_too_large",`serialized payload exceeds ${G} bytes`)}return e}}d(on,"parseOutcomeDelivery");function rn(e,t){const n=We(e.action,t);if(!("kind"in n))return{actionName:e.action,argv:n.argv,cwd:n.cwd,configOrigin:n.configOrigin,...e.payload===void 0?{}:{payload:e.payload}};throw n.kind==="unknown_action"?new w(422,"unknown_action",`no action named ${e.action} is declared from ${t}`):new w(422,"invalid_action",`${e.action} is declared in ${n.configOrigin} but unusable: ${n.reason}`,{reason:n.reason,configOrigin:n.configOrigin})}d(rn,"resolveOutcomeDelivery");function dn(e,t,n){const o={kind:e.kind,cwd:n,prompt:e.prompt??""};return e.mode!==void 0&&(o.mode=e.mode),e.name!==void 0&&(o.name=e.name),e.description!==void 0&&(o.description=e.description),t!==void 0&&(o.parent=t),e.creator!==void 0&&(o.creator=e.creator),e.root===!0&&(o.root=!0),e.root_lifecycle!==void 0&&(o.rootLifecycle=e.root_lifecycle),(e.worktree===!0||typeof e.worktree=="string")&&(o.worktree=!0),typeof e.worktree=="string"&&(o.worktreeBase=e.worktree),e.worktree!==void 0&&(o.worktreeCwd=C(e.pin_cwd??e.cwd??n)),e.fork_from!==void 0&&(o.forkFrom=e.fork_from),e.model!==void 0&&(o.model=e.model),e.profile!==void 0&&(o.profile=e.profile),e.situational_context!==void 0&&(o.situationalContext=e.situational_context),e.node_id!==void 0&&(o.nodeId=e.node_id),o}d(dn,"buildRecipe");function sn(e,t,n){return!Ve()||e.prefer_warm!==!0||e.root!==!0||e.parent!=null||e.root_lifecycle==="terminal"||(e.prompt??"")!==""||e.model!==void 0||e.fork_from!==void 0||e.worktree!==void 0||e.node_id!==void 0?null:{kind:e.kind,mode:e.mode??"base",cwd:t,profileId:n,model:e.model??null,situationalContext:e.situational_context??null,name:e.name??null,creator:e.creator??null}}d(sn,"warmRequestFor");import{resolveCreateKind as $t}from"../../../core/runtime/launch-target.js";function B(e){const t=e.modelIntent===void 0?void 0:`${e.modelIntent.family}/${e.modelIntent.strength}`;return Me(e.model,t,e.modelExact===!0)}d(B,"requestFromLaunch");async function J(e,t,n){const o=(await De(t.kind,t.mode,{lifecycle:t.lifecycle,hasManager:e.parent!==null,model:t.model,modelOverride:!0,cwd:e.cwd,profileId:e.profile_id??null})).launch;await $(B(o),{cwd:e.cwd,profileId:e.profile_id??null},n)}d(J,"assertNodeModelChangeRegistered");async function an(e,t={}){const n=nn(e.body),o=tn(n.deadline),r=on(n.outcome_delivery),i=n.parent??void 0;if(i==null&&n.root!==!0)throw u("a node create requires a parent (or root: true for an independent root)");let s=null;if(n.output_schema!==void 0)try{s=JSON.parse(n.output_schema)}catch{throw u("output_schema must be a JSON schema string")}const{profileId:l,kind:c,cwd:a,launch:m}=await Ke(n,{validateKind:K}),v={...n,kind:c},_=r===void 0?void 0:rn(r,a);await $(B(m),{cwd:a,profileId:l},t.modelRegistry);let g=null;{const k=sn(v,a,l);if(k!==null){const O=await Je(k,{...o===void 0?{}:{deadlineAt:o},..._===void 0?{}:{outcomeDelivery:_}},s===null?void 0:H=>F(H,"terminal",s));if(O!==null)return z(k),{status:201,body:y(O)};g=k}const S=dn(v,i,a);o!==void 0&&(S.deadlineAt=o),_!==void 0&&(S.outcomeDelivery=_),S.readiness=n.root===!0?"await":"launch";const Y=await de(S,s===null?void 0:O=>F(O,"terminal",s),()=>{g!==null&&z(g)});return{status:201,body:y(Y.node.node_id)}}}d(an,"handleCreate");function h(e,t){const n=e.query.getAll(t);if(n.length>1)throw u(`${t} must appear at most once`);return n[0]}d(h,"singleQueryValue");function V(e,t){if(e!==void 0){if(e==="1"||e==="true")return!0;if(e==="0"||e==="false")return!1;throw u(`${t} must be true or false`)}}d(V,"optionalBoolean");function N(e,t,n){if(e!==void 0){if(n.includes(e))return e;throw u(`${t} must be one of: ${n.join(", ")}`)}}d(N,"oneOf");function ln(e){const t=new Set(["status","lifecycle","kind","mode","profile_id","profile_prefix","parent","top_level","under","hanging","include"]);for(const[g]of e.query)if(!t.has(g))throw u(`unknown nodes query parameter: ${g}`);const n=N(h(e,"status"),"status",["active","idle","done","dead","canceled"]),o=N(h(e,"lifecycle"),"lifecycle",["terminal","resident"]),r=h(e,"kind"),i=N(h(e,"mode"),"mode",["base","orchestrator"]),s=h(e,"profile_id"),l=h(e,"profile_prefix"),c=h(e,"parent"),a=V(h(e,"top_level"),"top_level"),m=h(e,"under"),v=V(h(e,"hanging"),"hanging"),_=N(h(e,"include"),"include",["activity"]);if(c!==void 0&&a===!0)throw u("parent and top_level=true cannot be combined");return{...n!==void 0?{status:n}:{},...o!==void 0?{lifecycle:o}:{},...r!==void 0?{kind:r}:{},...i!==void 0?{mode:i}:{},...s!==void 0?{profile_id:s}:{},...l!==void 0?{profile_prefix:l}:{},...c!==void 0?{parent:c}:{},...a!==void 0?{top_level:a}:{},...m!==void 0?{under:m}:{},...v!==void 0?{hanging:v}:{},..._!==void 0?{include:_}:{}}}d(ln,"parseListQuery");function cn(e){const t=ln(e);let n=t.status!==void 0?I({status:t.status}):I();if(t.lifecycle!==void 0&&(n=n.filter(i=>i.lifecycle===t.lifecycle)),t.kind!==void 0&&(n=n.filter(i=>i.kind===t.kind)),t.mode!==void 0&&(n=n.filter(i=>i.mode===t.mode)),t.profile_id!==void 0&&(n=n.filter(i=>i.profile_id===t.profile_id)),t.profile_prefix!==void 0&&(n=n.filter(i=>i.profile_id?.startsWith(t.profile_prefix))),t.parent!==void 0&&(n=n.filter(i=>i.parent===t.parent)),t.top_level===!0&&(n=n.filter(i=>i.parent===null)),t.under!==void 0){const i=new Set(ce(t.under));n=n.filter(s=>i.has(s.node_id))}t.hanging===!0&&(n=n.filter(i=>i.parent!==null&&b(i.parent)===null));const o=t.include==="activity"?me(n.map(i=>i.node_id)):null;return{status:200,body:n.map(i=>{const s=qe(i);if(o!==null){const l=He(i.node_id);s.activity={latest_report:l[0]??null,final_report:i.final_report===null?null:l.find(c=>q(c.path)===i.final_report)??null,pending_human_count:o[i.node_id]??0}}return s})}}d(cn,"handleList");function un(e){const t=e.params.id;return f(t),{status:200,body:y(t)}}d(un,"handleDetail");async function fn(e){const t=e.params.id;f(t);const n=await _e(t);return{status:200,body:{node_id:t,snapshot:{messages:n.snapshot.messages,...n.snapshot.messageIds===void 0?{}:{messageIds:n.snapshot.messageIds},messageVisibility:n.snapshot.messageVisibility,turnVisibility:n.snapshot.turnVisibility,stats:n.snapshot.stats,state:n.snapshot.state,display:n.snapshot.display,...n.snapshot.queued===void 0?{}:{queued:n.snapshot.queued},...n.snapshot.toolGroupSummaries===void 0?{}:{toolGroupSummaries:n.snapshot.toolGroupSummaries},...n.snapshot.workingActivity===void 0?{}:{workingActivity:n.snapshot.workingActivity}},commands:n.commands.map(r=>({name:r.name,description:r.description,source:r.source})),captured_at:T()}}}d(fn,"handleSnapshot");async function mn(e){const t=e.params.id,n=be(t);if(n===null)throw P(`unknown node: ${t}`,{received:t});return{status:200,body:n}}d(mn,"handleSubject");function pn(e){for(const[i]of e.query)if(i!=="cursor"&&i!=="limit")throw u(`unknown messages query parameter: ${i}`);const t=e.query.getAll("cursor"),n=e.query.getAll("limit");if(t.length>1)throw u("cursor must appear at most once");if(n.length>1)throw u("limit must appear at most once");if(n.length===0)return t.length===0?{}:{cursor:t[0]};const o=n[0],r=Number(o);if(!Number.isSafeInteger(r)||o==="")throw u("limit must be an integer from 1 through 500");return t.length===0?{limit:r}:{cursor:t[0],limit:r}}d(pn,"parseMessagesQuery");async function hn(e){const t=e.params.id,n=await we(t,pn(e));return{status:200,body:{node_id:t,messages:n.messages,...n.messageIds===void 0?{}:{message_ids:n.messageIds},message_visibility:n.messageVisibility,next_cursor:n.nextCursor,captured_at:T()}}}d(hn,"handleMessages");function wn(e){const t=e.params.id;f(t);const n=ye(t);return{status:200,body:{node_id:t,session_file:n.sessionFile,session_jsonl:n.sessionJsonl,system_prompt:n.systemPrompt,captured_at:T()}}}d(wn,"handleSession");async function yn(e){const t=e.params.id;return f(t),{status:200,body:{node_id:t,markdown:await ge(t)}}}d(yn,"handleTranscript");function _n(e){const t=e.params.id;f(t);const n=[{node_id:t,label:b(t)?.name??t,dir:A(t),self:!0,files:W(t)}];for(const o of M(t))n.push({node_id:o.node_id,label:b(o.node_id)?.name??o.node_id,dir:A(o.node_id),self:!1,files:W(o.node_id)});return{status:200,body:{node_id:t,roots:n}}}d(_n,"handleContext");function gn(e){const t=e.params.id;f(t);const n=e.query.get("type"),o=he(t,n!==null?[n]:void 0).map(i=>({ref:i.ref,source:i.source==="report"&&i.reportKind!==void 0?`report:${i.reportKind}`:i.source,ts:i.ts,title:i.title}));return{status:200,body:{node_id:t,artifacts:o}}}d(gn,"handleArtifacts");async function bn(e){const t=await re(e.params.id);return{status:201,body:y(t.node.node_id)}}d(bn,"handleFork");async function vn(e){const t=e.params.id;f(t);const n=e.body,o=n?.resume??!0,r=n?.reopen??!1;Te(t,r);const i=!o&&n?.cron_id!==void 0?Qe(n.cron_id):null,s=await ie(t,{resume:o,capacity:"refuse",...i!==null?{wakeReason:Ue(i,"schedule_revive")}:{}}),l=b(t)?.status??"active";return{status:200,body:en(t,s,l)}}d(vn,"handleRevive");async function kn(e){const t=e.params.id;return{status:200,body:{newNodeId:(await Ne(t))?.newNodeId??null}}}d(kn,"handleRelaunchRoot");function Sn(e){const t=e.params.id;f(t);const n=e.body;if(n?.caller_pid!==void 0&&(!Number.isInteger(n.caller_pid)||n.caller_pid<=0))throw u("caller_pid must be a positive integer when provided");const o=Xe(),r=oe(t,{rootEvent:n?.finish===!0?"finish":"cancel",callerPid:n?.caller_pid,...o===null?{}:{registerDetached:o.registerDetached}});return{status:200,body:Ze(r)}}d(Sn,"handleClose");async function On(e){const t=e.params.id;f(t);const n=await Oe(t);return{status:200,body:{recycled:n.recycled,finalized:n.finalized,new_root:n.newRoot,delivered:n.delivered}}}d(On,"handleRecycle");async function Nn(e){const t=e.params.id;return f(t),await L(t,{lifecycle:"terminal"}),{status:200,body:y(t)}}d(Nn,"handleDemote");async function Tn(e,t={}){const n=e.params.id,o=f(n),r=e.body??{};r.model!==void 0&&await J(o,{kind:r.kind??o.kind,mode:"orchestrator",lifecycle:r.resident===!0?"resident":o.lifecycle,model:r.model},t.modelRegistry);const i=await ke(n,{...r.kind!==void 0?{kind:r.kind}:{},...r.resident===!0?{resident:!0}:{},...r.model!==void 0?{model:r.model}:{}}),s=R(i.meta,x(n));return s.roadmap_written=i.roadmapWritten,s.roadmap_path=i.roadmapPath,s.goal_path=i.goalPath,{status:200,body:s}}d(Tn,"handlePromote");async function $n(e,t={}){const n=e.params.id,o=f(n),r=e.body??{};r.model!==void 0&&await J(o,{kind:r.kind??o.kind,mode:r.promote===!0?"orchestrator":o.mode,lifecycle:o.lifecycle,model:r.model},t.modelRegistry);const i=r.note??"Refresh: continue against your roadmap or goal.";$e(n,i);const s=await Se(n,{...r.promote===!0?{promote:!0}:{},...r.kind!==void 0?{kind:r.kind}:{},...r.model!==void 0?{model:r.model}:{}});return{status:200,body:R(s.meta,x(n))}}d($n,"handleYield");function An(e){const t=e.params.id;f(t);const n=e.body;if(n===void 0||typeof n.controller!="string"||n.controller.trim()==="")throw u("a wait requires a controller node id");const o=b(n.controller);if(o===null)throw P(`unknown controller: ${n.controller}`,{received:n.controller});if(o.status!=="active"&&o.status!=="idle")throw new w(422,"unprocessable",`controller ${n.controller} is ${o.status}`);return le(t,n.controller),{status:200,body:y(t)}}d(An,"handleWait");async function Pn(){const e=await ve();return{status:200,body:{revived:[...e.revived],failed:[...e.failed],frozen:[...e.frozen]}}}d(Pn,"handleReviveAll");async function Rn(e,t={}){const n=e.params.id,o=e.body;let r;if(o===void 0)r={};else if(typeof o=="object"&&o!==null&&!Array.isArray(o))r=o;else throw new p({error:"cwd_invalid",message:"cwd repair requires a non-null object with a non-empty cwd string",received:o,field:"cwd",next:"Send a config patch with a non-empty absolute cwd string."});if(Object.prototype.hasOwnProperty.call(r,"cwd")){const s=r.cwd;if(typeof s!="string"||s==="")throw new p({error:"cwd_invalid",message:"cwd must be a non-empty string",received:s,field:"cwd",next:"Send a non-empty absolute cwd string."});if(Object.keys(r).some(a=>a!=="cwd"&&r[a]!==void 0))throw new p({error:"cwd_not_exclusive",message:"cwd repair cannot be combined with another config field",received:r,field:"cwd",next:"Send cwd as the only config field."});const l=f(n);if(Ge().has(n)){const a=`${n} cannot repair its cwd while its broker is live`;throw new w(409,"cwd_node_live",a,{error:"cwd_node_live",message:a,received:s,field:"cwd",next:"Let the node become dormant, then retry the cwd repair."})}if(l.fork_from!=null)throw new p({error:"cwd_node_forked",message:`${n} is a fork and cannot repair its cwd; recorded cwd: ${l.cwd}`,received:s,field:"cwd",next:`Restore ${l.cwd}, then revive the fork normally.`});if(l.managed_worktree?.state==="open")throw new p({error:"cwd_node_managed_worktree_open",message:`${n} owns an open managed worktree and cannot repair its cwd`,received:s,field:"cwd",next:"Restore or reconcile the recorded checkout, then use the managed-worktree close or abandon flow."});if(D(l.cwd))throw new p({error:"cwd_still_present",message:`${n} recorded cwd still exists: ${l.cwd}; cwd repair is not a relocation command`,received:s,field:"cwd",next:"This command only repairs a node whose recorded cwd is gone."});if(!ee(s))throw new p({error:"cwd_not_absolute",message:`cwd must be an absolute path: ${s}`,received:s,field:"cwd",next:"Send an absolute path."});const c=C(s);if(!D(c))throw new p({error:"cwd_missing",message:`cwd does not exist: ${c}`,received:s,field:"cwd",next:"Create the replacement directory or send an existing absolute directory."});try{if(!Z(c).isDirectory())throw new p({error:"cwd_not_a_directory",message:`cwd is not a directory: ${c}`,received:s,field:"cwd",next:"Send an existing absolute directory."})}catch(a){throw a instanceof p?a:new p({error:"cwd_missing",message:`cwd does not exist: ${c}`,received:s,field:"cwd",next:"Create the replacement directory or send an existing absolute directory."})}return ue(()=>{E(n,{cwd:c}),fe(n)}),{status:200,body:y(n)}}let i=f(n);if(r.situational_context!==void 0&&ne(n,te(r.situational_context)),r.model!==void 0){const s=Ce(r.model),l=(await j(i.cwd,i.profile_id??null)).modelLadders,c=Ie(r.model,l);await $({kind:"concrete",spec:c},{cwd:i.cwd,profileId:i.profile_id??null},t.modelRegistry);const a=d(()=>{if(!c.includes("/"))throw u(`model must resolve to a provider/id spec: ${r.model}`);je(n,c,s)},"persistDormant");if(Le(i))try{await Fe(n,c,s)}catch(m){if(!(m instanceof Ee))throw m;a()}else a();i=f(n)}if(r.kind!==void 0||r.mode!==void 0||r.lifecycle!==void 0){r.kind!==void 0&&await K(r.kind);const s=r.kind??i.kind,l=r.mode??i.mode,c=r.lifecycle??i.lifecycle;let a;l==="orchestrator"&&!Pe(n)&&(a=d(()=>{const m=Ae(n);Re(n,m!==null&&m.trim()!==""?{goal:m.trim()}:{})},"beforePersist")),i=await L(n,{...r.kind!==void 0?{kind:s}:{},...r.mode!==void 0?{mode:l}:{},...r.lifecycle!==void 0?{lifecycle:c}:{}},a)}return r.name!==void 0&&(i=E(n,{name:r.name}),i.window&&xe(i.window,Ye(i))),{status:200,body:y(n)}}d(Rn,"handleConfig");async function K(e){const t=Object.keys((await j(process.cwd(),U()||null)).kinds);if(!t.includes(e))throw u(`unknown kind: ${e}`,{received:e,next:`Valid kinds: ${t.sort().join(", ")}.`})}d(K,"assertKindServer");const Ot=[{method:"POST",pattern:"/v1/nodes",handler:an},{method:"GET",pattern:"/v1/nodes",handler:cn},{method:"POST",pattern:"/v1/nodes/revive-all",handler:d(()=>Pn(),"handler")},{method:"GET",pattern:"/v1/nodes/:id",handler:un},{method:"GET",pattern:"/v1/nodes/:id/snapshot",handler:fn},{method:"GET",pattern:"/v1/nodes/:id/subject",handler:mn},{method:"GET",pattern:"/v1/nodes/:id/messages",handler:hn},{method:"GET",pattern:"/v1/nodes/:id/session",handler:wn},{method:"GET",pattern:"/v1/nodes/:id/transcript",handler:yn},{method:"GET",pattern:"/v1/nodes/:id/context",handler:_n},{method:"GET",pattern:"/v1/nodes/:id/artifacts",handler:gn},{method:"POST",pattern:"/v1/nodes/:id/fork",handler:bn},{method:"POST",pattern:"/v1/nodes/:id/revive",handler:vn},{method:"POST",pattern:"/v1/nodes/:id/relaunch-root",handler:kn},{method:"POST",pattern:"/v1/nodes/:id/close",handler:Sn},{method:"POST",pattern:"/v1/nodes/:id/recycle",handler:On},{method:"POST",pattern:"/v1/nodes/:id/demote",handler:Nn},{method:"POST",pattern:"/v1/nodes/:id/promote",handler:Tn},{method:"POST",pattern:"/v1/nodes/:id/yield",handler:$n},{method:"POST",pattern:"/v1/nodes/:id/wait",handler:An},{method:"PATCH",pattern:"/v1/nodes/:id/config",handler:Rn}];export{Rn as handleConfig,an as handleCreate,bn as handleFork,cn as handleList,Tn as handlePromote,$n as handleYield,Ot as nodeRoutes,$t as resolveCreateKind};