@songsid/agend 2.3.4-beta.6 → 2.3.5-alpha.2

package/dist/runtime-transcript-delta-reader.js

@@ -0,0 +1,74 @@
+import { transcriptDeltaNeedle } from "./transcript-needles.js";
+import { validatePaneTranscriptWireBatch, validateRuntimeTranscriptReference } from "./runtime-pane-transcript-protocol.js";
+/** Validate both the closed frame and its relation to the exact checkpoint requested. */
+export function decodeRuntimeTranscriptBatch(raw, before) {
+    const batch = validatePaneTranscriptWireBatch(raw, before.sessionId), after = batch.cursor;
+    const data = Buffer.from(batch.data, "base64"), delta = after.offset - before.offset;
+    if (delta < 0 || before.fileId && after.fileId !== before.fileId || data.length > delta || !batch.gap && data.length !== delta
+        || batch.state === "pending" && (after.offset !== before.offset || after.fileId !== before.fileId || after.anchor !== before.anchor || after.skipping !== before.skipping)
+        || delta === 0 && (after.anchor !== before.anchor || after.skipping !== before.skipping))
+        throw Error("Runtime transcript checkpoint response differs");
+    const text = new TextDecoder("utf-8", { fatal: true }).decode(data);
+    if (text && !text.endsWith("\n"))
+        throw Error("Runtime transcript response ended inside a record");
+    // A malformed record may hide a turn boundary or a delivery marker: never skip it silently.
+    for (const line of text.split(/\r?\n/))
+        if (line) {
+            const record = JSON.parse(line);
+            if (!record || typeof record !== "object" || Array.isArray(record))
+                throw Error("Runtime transcript contains a non-record");
+        }
+    return { batch, text };
+}
+export class RuntimeTranscriptDeltaReader {
+    port;
+    needle;
+    reference;
+    inFlight = false;
+    closed = false;
+    gap = false;
+    constructor(port, reference, needle) {
+        this.port = port;
+        this.needle = needle;
+        this.reference = validateRuntimeTranscriptReference(reference);
+    }
+    get readPosition() { return this.reference.cursor.offset; }
+    close() { this.closed = true; }
+    async look() {
+        if (this.closed || !this.port.isTranscriptObservationCurrent(this.reference))
+            return "unavailable";
+        if (this.inFlight)
+            return "pending";
+        this.inFlight = true;
+        const before = structuredClone(this.reference);
+        let abandoned = false, timer;
+        const current = () => !abandoned && !this.closed && this.port.isTranscriptObservationCurrent(before);
+        const read = this.port.readTranscript(before.cursor, current).finally(() => { this.inFlight = false; });
+        try {
+            const got = await Promise.race([read, new Promise(resolve => { timer = setTimeout(() => resolve(null), 250); timer.unref?.(); })]);
+            if (got === null) {
+                abandoned = true;
+                return "pending";
+            }
+            if (!current())
+                return "unavailable";
+            const { batch, text } = decodeRuntimeTranscriptBatch(got, before.cursor);
+            if (batch.state === "pending")
+                return "pending";
+            const proof = transcriptDeltaNeedle(text, before.provider, this.needle);
+            this.reference = { ...before, cursor: batch.cursor };
+            this.gap ||= batch.gap;
+            // A genuine complete user record after a gap remains positive evidence. Missing records prove no absence.
+            return proof ?? (this.gap ? "unavailable" : "no-match");
+        }
+        catch {
+            return "unavailable";
+        }
+        finally {
+            abandoned = true;
+            clearTimeout(timer);
+            void read.catch(() => { });
+        }
+    }
+}
+//# sourceMappingURL=runtime-transcript-delta-reader.js.map

package/dist/runtime-transcript-delta-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-transcript-delta-reader.js","sourceRoot":"","sources":["../src/runtime-transcript-delta-reader.ts"],"names":[],"mappings":"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"}

package/dist/runtime-transcript-source.d.ts

@@ -0,0 +1,36 @@
+/** Ordinary progress and turn events from the native runner's pinned session. No local path fallback. */
+import type { TranscriptSource, TranscriptEvents } from "./transcript-sources.js";
+import type { TranscriptTurnEvent } from "./transcript-turns.js";
+import { type RuntimeTranscriptPort } from "./runtime-transcript-delta-reader.js";
+import { type RuntimeTranscriptReference } from "./runtime-pane-transcript-protocol.js";
+export declare class RuntimeTranscriptSource implements TranscriptSource {
+    private readonly port;
+    private readonly allowDeferredFresh;
+    private reference;
+    private generation;
+    private stopped;
+    private baseline;
+    private followed;
+    private deferred;
+    private inFlight;
+    private queue;
+    private state;
+    private pendingTurns;
+    private pending;
+    private pendingBytes;
+    constructor(port: RuntimeTranscriptPort, reference: RuntimeTranscriptReference, allowDeferredFresh?: boolean);
+    private serialized;
+    /** One bounded baseline look. Large existing transcripts continue baselining on polls, without replaying history. */
+    initialize(): Promise<void>;
+    following(): boolean;
+    turnStateKnown(): boolean;
+    currentPath(): null;
+    checkpoint(): Promise<null>;
+    takeTurns(): TranscriptTurnEvent[];
+    close(): void;
+    reset(): void;
+    poll(): Promise<TranscriptEvents>;
+    /** Drain only a few frames; if work is still arriving, hold this delivery rather than paste against an old offset. */
+    runtimeCheckpoint(): Promise<RuntimeTranscriptReference | null>;
+    private read;
+}

package/dist/runtime-transcript-source.js

@@ -0,0 +1,189 @@
+import { codexTurnRecord, codexToolRecord, claudeTranscriptRecord } from "./transcript-records.js";
+import { decodeRuntimeTranscriptBatch } from "./runtime-transcript-delta-reader.js";
+import { PANE_TRANSCRIPT_EMPTY_ANCHOR, validatePaneTranscriptBaseline, validateRuntimeTranscriptReference } from "./runtime-pane-transcript-protocol.js";
+const empty = () => ({ toolUses: [], toolResults: [], assistantTexts: [], records: [], turns: [] });
+export class RuntimeTranscriptSource {
+    port;
+    allowDeferredFresh;
+    reference;
+    generation = 0;
+    stopped = false;
+    baseline = true;
+    followed = false;
+    deferred = false;
+    inFlight = false;
+    queue = Promise.resolve();
+    state = { openTurnId: "", openTurn: null, turnKnown: false };
+    pendingTurns = [];
+    pending = empty();
+    pendingBytes = 0;
+    constructor(port, reference, allowDeferredFresh = false) {
+        this.port = port;
+        this.allowDeferredFresh = allowDeferredFresh;
+        this.reference = validateRuntimeTranscriptReference(reference);
+        if (this.reference.cursor.offset !== 0)
+            throw Error("Native progress source requires a full baseline from its pinned session");
+    }
+    serialized(work) {
+        const result = this.queue.catch(() => { }).then(work);
+        this.queue = result;
+        return result;
+    }
+    /** One bounded baseline look. Large existing transcripts continue baselining on polls, without replaying history. */
+    async initialize() { await this.serialized(async () => { await this.read(true); }); }
+    following() { return this.followed && !this.stopped && this.port.isTranscriptObservationCurrent(this.reference); }
+    turnStateKnown() { return this.following() && !this.baseline && this.state.turnKnown; }
+    currentPath() { return null; }
+    async checkpoint() { return null; }
+    takeTurns() { return this.pendingTurns.splice(0); }
+    close() { this.stopped = true; this.generation++; this.followed = false; this.pending = empty(); this.pendingBytes = 0; this.pendingTurns = []; }
+    reset() {
+        this.generation++;
+        this.stopped = false;
+        this.baseline = true;
+        this.followed = false;
+        this.reference = { ...this.reference, cursor: { sessionId: this.reference.cursor.sessionId, offset: 0, fileId: this.reference.cursor.fileId,
+                anchor: PANE_TRANSCRIPT_EMPTY_ANCHOR } };
+        this.deferred = false;
+        this.state = { openTurnId: "", openTurn: null, turnKnown: false };
+        this.pending = empty();
+        this.pendingBytes = 0;
+        this.pendingTurns = [];
+    }
+    async poll() {
+        return this.serialized(async () => {
+            const events = await this.read(false), queued = this.pending;
+            this.pending = empty();
+            this.pendingBytes = 0;
+            queued.toolUses.push(...events.toolUses);
+            queued.toolResults.push(...events.toolResults);
+            queued.assistantTexts.push(...events.assistantTexts);
+            queued.records.push(...events.records);
+            queued.turns.push(...this.takeTurns(), ...events.turns);
+            return queued;
+        });
+    }
+    /** Drain only a few frames; if work is still arriving, hold this delivery rather than paste against an old offset. */
+    async runtimeCheckpoint() {
+        return this.serialized(async () => {
+            for (let n = 0; n < 8; n++) {
+                // Keep bounded progress between checkpoint and next monitor poll. Never retain an unbounded history replay.
+                if (this.pendingBytes > 512 * 1024 || this.pendingTurns.length + this.pending.toolUses.length + this.pending.toolResults.length + this.pending.assistantTexts.length + this.pending.records.length > 2048) {
+                    this.followed = false;
+                    throw Error("Native transcript progress awaits its monitor poll");
+                }
+                const events = await this.read(false);
+                this.pendingBytes += Buffer.byteLength(JSON.stringify(events));
+                this.pending.toolUses.push(...events.toolUses);
+                this.pending.toolResults.push(...events.toolResults);
+                this.pending.assistantTexts.push(...events.assistantTexts);
+                this.pending.records.push(...events.records);
+                this.pendingTurns.push(...events.turns);
+                if (!this.baseline && (this.following() || this.deferred && this.reference.cursor.fileId === null
+                    && this.port.isTranscriptObservationCurrent(this.reference)))
+                    return structuredClone(this.reference);
+            }
+            return null;
+        });
+    }
+    async read(initial) {
+        if (this.stopped || !this.port.isTranscriptObservationCurrent(this.reference)) {
+            this.followed = false;
+            return empty();
+        }
+        if (this.inFlight) {
+            this.followed = false;
+            return empty();
+        }
+        const epoch = this.generation, before = structuredClone(this.reference);
+        let abandoned = false, timer;
+        const current = () => !abandoned && !this.stopped && epoch === this.generation && this.port.isTranscriptObservationCurrent(before);
+        this.inFlight = true;
+        const baselining = this.baseline && !!this.port.readTranscriptBaseline;
+        const read = (baselining ? this.port.readTranscriptBaseline(before.cursor, current) : this.port.readTranscript(before.cursor, current)).finally(() => { this.inFlight = false; });
+        try {
+            const raw = await Promise.race([read, new Promise(resolve => { timer = setTimeout(() => resolve(null), 1000); timer.unref?.(); })]);
+            if (raw === null) {
+                this.followed = false;
+                return empty();
+            }
+            if (!current())
+                return empty();
+            if (baselining) {
+                const batch = validatePaneTranscriptBaseline(raw, before.cursor.sessionId);
+                if (before.cursor.fileId && batch.cursor.fileId !== before.cursor.fileId || batch.cursor.offset < before.cursor.offset)
+                    throw Error("Native baseline identity differs");
+                if (batch.state === "pending") {
+                    this.followed = false;
+                    if (initial && this.allowDeferredFresh && before.cursor.fileId === null) {
+                        this.baseline = false;
+                        this.deferred = true;
+                    }
+                    return empty();
+                }
+                this.reference = { ...before, cursor: batch.cursor };
+                this.baseline = false;
+                this.followed = batch.complete;
+                this.deferred = false;
+                this.state = { turnKnown: batch.turnKnown, openTurn: batch.openTurn, openTurnId: batch.openTurn ?? "" };
+                if (batch.openTurn)
+                    this.pendingTurns.push({ kind: "start", turnId: batch.openTurn });
+                return empty();
+            }
+            const { batch, text } = decodeRuntimeTranscriptBatch(raw, before.cursor);
+            if (batch.state === "pending") {
+                this.followed = false;
+                if (initial && this.allowDeferredFresh && before.cursor.fileId === null) {
+                    this.baseline = false;
+                    this.deferred = true;
+                }
+                return empty();
+            }
+            const events = empty(), wasBaseline = this.baseline;
+            if (batch.gap) {
+                if (!wasBaseline && this.state.openTurn)
+                    events.turns.push({ kind: "retract", turnId: this.state.openTurn });
+                this.state = { openTurnId: "", openTurn: null, turnKnown: false };
+            }
+            else if (before.cursor.offset === 0)
+                this.state.turnKnown = true;
+            for (const line of text.split(/\r?\n/))
+                if (line) {
+                    const entry = JSON.parse(line);
+                    if (before.provider === "codex") {
+                        // After a gap an orphan end proves no closed turn. Only a subsequent start re-establishes the ledger.
+                        const orphanEnd = !this.state.turnKnown && entry.type === "event_msg" && ["task_complete", "turn_aborted"].includes(entry.payload?.type);
+                        if (!orphanEnd)
+                            codexTurnRecord(entry, this.state, events.turns);
+                        if (!wasBaseline)
+                            codexToolRecord(entry, events);
+                    }
+                    else if (!wasBaseline)
+                        claudeTranscriptRecord(entry, (...record) => events.records.push(record));
+                }
+            this.reference = { ...before, cursor: batch.cursor };
+            this.followed = batch.complete;
+            this.deferred = false;
+            if (wasBaseline) {
+                if (batch.complete) {
+                    this.baseline = false;
+                    if (this.state.openTurn)
+                        this.pendingTurns.push({ kind: "start", turnId: this.state.openTurn });
+                }
+                return empty();
+            }
+            return events;
+        }
+        catch (error) {
+            if (epoch === this.generation)
+                this.followed = false;
+            throw error;
+        }
+        finally {
+            abandoned = true;
+            clearTimeout(timer);
+            void read.catch(() => { });
+        }
+    }
+}
+//# sourceMappingURL=runtime-transcript-source.js.map

package/dist/runtime-transcript-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-transcript-source.js","sourceRoot":"","sources":["../src/runtime-transcript-source.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,sBAAsB,EAAyB,MAAM,yBAAyB,CAAC;AAC1H,OAAO,EAAE,4BAA4B,EAA8B,MAAM,sCAAsC,CAAC;AAChH,OAAO,EAAE,4BAA4B,EAAE,8BAA8B,EAAE,kCAAkC,EAAmC,MAAM,uCAAuC,CAAC;AAC1L,MAAM,KAAK,GAAG,GAAqB,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;AACtH,MAAM,OAAO,uBAAuB;IAaL,IAAI;IAAiF,kBAAkB;IAZ5H,SAAS,CAA6B;IACtC,UAAU,GAAG,CAAC,CAAC;IACf,OAAO,GAAG,KAAK,CAAC;IAChB,QAAQ,GAAG,IAAI,CAAC;IAChB,QAAQ,GAAG,KAAK,CAAC;IACjB,QAAQ,GAAG,KAAK,CAAC;IACjB,QAAQ,GAAG,KAAK,CAAC;IACjB,KAAK,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5C,KAAK,GAAqB,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC/E,YAAY,GAA0B,EAAE,CAAC;IACzC,OAAO,GAAqB,KAAK,EAAE,CAAC;IACpC,YAAY,GAAG,CAAC,CAAC;IACzB,YAA6B,IAA2B,EAAE,SAAqC,EAAmB,kBAAkB,GAAG,KAAK;oBAA/G,IAAI;kCAAiF,kBAAkB;QAClI,IAAI,CAAC,SAAS,GAAG,kCAAkC,CAAC,SAAS,CAAC,CAAC;QAC/D,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,KAAK,CAAC,yEAAyE,CAAC,CAAC;IACjI,CAAC;IACO,UAAU,CAAI,IAAsB;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAAC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;QAAC,OAAO,MAAM,CAAC;IAC3F,CAAC;IACD,qHAAqH;IACrH,KAAK,CAAC,UAAU,KAAoB,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpG,SAAS,KAAc,OAAO,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC3H,cAAc,KAAc,OAAO,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IAChG,WAAW,KAAW,OAAO,IAAI,CAAC,CAAC,CAAC;IACpC,KAAK,CAAC,UAAU,KAAoB,OAAO,IAAI,CAAC,CAAC,CAAC;IAClD,SAAS,KAA4B,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1E,KAAK,KAAW,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,GAAG,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC,CAAC;IACvJ,KAAK;QACH,IAAI,CAAC,UAAU,EAAE,CAAC;QAAC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QAAC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACrF,IAAI,CAAC,SAAS,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM;gBACzI,MAAM,EAAE,4BAA4B,EAAE,EAAE,CAAC;QAAC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QAClE,IAAI,CAAC,KAAK,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QAAC,IAAI,CAAC,OAAO,GAAG,KAAK,EAAE,CAAC;QAAC,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QAAC,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;IAC3I,CAAC;IACD,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE;YAChC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;YAAC,IAAI,CAAC,OAAO,GAAG,KAAK,EAAE,CAAC;YAAC,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;YAC5G,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;YAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;YAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;YAC/I,MAAM,CAAC,OAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,OAAQ,CAAC,CAAC;YAAC,MAAM,CAAC,KAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,EAAE,EAAE,GAAG,MAAM,CAAC,KAAM,CAAC,CAAC;YACpG,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC;IACD,sHAAsH;IACtH,KAAK,CAAC,iBAAiB;QACrB,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE;YAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC3B,4GAA4G;gBAC5G,IAAI,IAAI,CAAC,YAAY,GAAG,GAAG,GAAG,IAAI,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAQ,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;oBAC3M,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;oBAAC,MAAM,KAAK,CAAC,oDAAoD,CAAC,CAAC;gBAC3F,CAAC;gBACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACtC,IAAI,CAAC,YAAY,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;gBAC/D,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;gBAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;gBACjK,IAAI,CAAC,OAAO,CAAC,OAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,OAAQ,CAAC,CAAC;gBAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAM,CAAC,CAAC;gBACzF,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,KAAK,IAAI;uBAC5F,IAAI,CAAC,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBAAE,OAAO,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACzG,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;IACO,KAAK,CAAC,IAAI,CAAC,OAAgB;QACjC,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YAAC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;QAAC,CAAC;QACzH,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAAC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;QAAC,CAAC;QAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxE,IAAI,SAAS,GAAG,KAAK,EAAE,KAAgD,CAAC;QACxE,MAAM,OAAO,GAAG,GAAY,EAAE,CAAC,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,KAAK,KAAK,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,8BAA8B,CAAC,MAAM,CAAC,CAAC;QAC5I,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC;QACvE,MAAM,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,sBAAuB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACnL,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE,GAAG,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1I,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;gBAAC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;YAAC,CAAC;YAC5D,IAAI,CAAC,OAAO,EAAE;gBAAE,OAAO,KAAK,EAAE,CAAC;YAC/B,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,KAAK,GAAG,8BAA8B,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBAC3E,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM;oBAAE,MAAM,KAAK,CAAC,kCAAkC,CAAC,CAAC;gBACxK,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;oBAC9B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;oBACtB,IAAI,OAAO,IAAI,IAAI,CAAC,kBAAkB,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;wBAAC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;wBAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;oBAAC,CAAC;oBACzH,OAAO,KAAK,EAAE,CAAC;gBACjB,CAAC;gBACD,IAAI,CAAC,SAAS,GAAG,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;gBAAC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;gBAAC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;gBAAC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;gBACnI,IAAI,CAAC,KAAK,GAAG,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;gBACxG,IAAI,KAAK,CAAC,QAAQ;oBAAE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;gBACtF,OAAO,KAAK,EAAE,CAAC;YACjB,CAAC;YACD,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,4BAA4B,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YACzE,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC9B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;gBACtB,IAAI,OAAO,IAAI,IAAI,CAAC,kBAAkB,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;oBAAC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;oBAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;gBAAC,CAAC;gBACzH,OAAO,KAAK,EAAE,CAAC;YACjB,CAAC;YACD,MAAM,MAAM,GAAG,KAAK,EAAE,EAAE,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC;YACpD,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;gBACd,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ;oBAAE,MAAM,CAAC,KAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;gBAC9G,IAAI,CAAC,KAAK,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;YACpE,CAAC;iBAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;gBAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;YACnE,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;gBAAE,IAAI,IAAI,EAAE,CAAC;oBACjD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBAC/B,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;wBAChC,sGAAsG;wBACtG,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;wBACzI,IAAI,CAAC,SAAS;4BAAE,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,KAAM,CAAC,CAAC;wBAClE,IAAI,CAAC,WAAW;4BAAE,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;oBACnD,CAAC;yBAAM,IAAI,CAAC,WAAW;wBAAE,sBAAsB,CAAC,KAAK,EAAE,CAAC,GAAG,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;gBACtG,CAAC;YACD,IAAI,CAAC,SAAS,GAAG,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;YAAC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;YAAC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;YAC5G,IAAI,WAAW,EAAE,CAAC;gBAChB,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;oBACnB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;oBACtB,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ;wBAAE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;gBAClG,CAAC;gBACD,OAAO,KAAK,EAAE,CAAC;YACjB,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAAC,IAAI,KAAK,KAAK,IAAI,CAAC,UAAU;gBAAE,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;YAAC,MAAM,KAAK,CAAC;QAAC,CAAC;gBAC9E,CAAC;YAAC,SAAS,GAAG,IAAI,CAAC;YAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YAAC,KAAK,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAAC,CAAC;IAC/E,CAAC;CACF"}

package/dist/runtime-windows-bridge.d.ts

@@ -0,0 +1,41 @@
+/** Route the existing native conversation store to a local worker or a paired Windows runtime. */
+import { type WindowsCliExecutor, type WindowsCliProbe, type WindowsCliTask, type WindowsRunOptions } from "./windows-cli.js";
+import type { RuntimeOperation } from "./runtime-protocol.js";
+import type { RuntimeCoordinatorEvent } from "./runtime-coordinator.js";
+export interface RuntimeExecutionCoordinator {
+    machine(id: string): {
+        status: string;
+        platform: string;
+        inventory?: WindowsCliProbe;
+    } | null;
+    call(machineId: string, operation: RuntimeOperation, payload: unknown): Promise<unknown>;
+    task(id: string): WindowsCliTask | null;
+    hasActiveTask(machineId: string): boolean;
+    subscribe(listener: (event: RuntimeCoordinatorEvent) => void): () => void;
+}
+export declare class RuntimeWindowsBridge implements WindowsCliExecutor {
+    private readonly coordinator;
+    private readonly local;
+    private readonly pending;
+    private readonly scopes;
+    private subscription;
+    private attached;
+    constructor(owner: object, coordinator: () => RuntimeExecutionCoordinator | null, local?: WindowsCliExecutor);
+    private remote;
+    private finish;
+    private machine;
+    probe(options?: {
+        force?: boolean;
+        machineId?: string;
+    }): Promise<WindowsCliProbe>;
+    prepareWorkspace(agentId: string, authorized?: () => boolean, machineId?: string): Promise<string>;
+    start(value: unknown, authorized?: () => boolean, options?: WindowsRunOptions): WindowsCliTask;
+    get(id: string): WindowsCliTask | null;
+    list(): WindowsCliTask[];
+    hasActiveTask(machineId?: string): boolean;
+    cancel(id: string): WindowsCliTask;
+    releaseUnknown(id: string): void;
+    recoverRemote(machineId: string, id: string): Promise<WindowsCliTask>;
+    mcp(machineId: string, runId: string, body: unknown): Promise<unknown>;
+    close(): void;
+}

package/dist/runtime-windows-bridge.js

@@ -0,0 +1,157 @@
+/** Route the existing native conversation store to a local worker or a paired Windows runtime. */
+import { windowsBridgeFor } from "./windows-cli.js";
+import { validateNativeTask } from "./windows-cli-worker.js";
+import { nativeMcpHttp } from "./windows-native-mcp.js";
+export class RuntimeWindowsBridge {
+    coordinator;
+    local;
+    pending = new Map();
+    scopes = new Map();
+    subscription = null;
+    attached = null;
+    constructor(owner, coordinator, local) {
+        this.coordinator = coordinator;
+        this.local = local ?? windowsBridgeFor(owner);
+    }
+    remote() {
+        const remote = this.coordinator();
+        if (!remote)
+            throw new Error("Remote runtimes are not enabled");
+        if (this.attached !== remote) {
+            this.subscription?.();
+            this.attached = remote;
+            this.subscription = remote.subscribe(event => {
+                if (event.type !== "task" || !event.task)
+                    return;
+                const pending = this.pending.get(event.task.id);
+                if (!pending || pending.machineId !== event.machineId)
+                    return;
+                pending.task = structuredClone(event.task);
+                if (event.task.finishedAt)
+                    this.finish(event.task.id, event.task);
+            });
+        }
+        return remote;
+    }
+    finish(id, task) {
+        const pending = this.pending.get(id);
+        this.scopes.delete(id);
+        if (!pending)
+            return;
+        clearTimeout(pending.timer);
+        this.pending.delete(id);
+        pending.settle?.(structuredClone(task));
+    }
+    machine(id) {
+        const remote = this.remote(), machine = remote.machine(id);
+        if (!machine || machine.status !== "online" || machine.platform !== "win32")
+            throw new Error("The selected Windows runtime is offline or unavailable");
+        return remote;
+    }
+    async probe(options = {}) {
+        if (!options.machineId)
+            return this.local.probe(options);
+        const remote = this.machine(options.machineId), machine = remote.machine(options.machineId);
+        if (!options.force)
+            return structuredClone(machine.inventory ?? { clis: [], home: "", probedAt: null });
+        return await remote.call(options.machineId, "probe", { force: true });
+    }
+    async prepareWorkspace(agentId, authorized = () => true, machineId) {
+        if (!machineId)
+            return this.local.prepareWorkspace(agentId, authorized);
+        if (!authorized())
+            throw new Error("Authorization expired");
+        const result = await this.machine(machineId).call(machineId, "workspace", { agentId });
+        if (!authorized())
+            throw new Error("Authorization expired");
+        if (typeof result?.cwd !== "string")
+            throw new Error("The remote runtime did not return a workspace");
+        return result.cwd;
+    }
+    start(value, authorized = () => true, options = {}) {
+        if (!options.machineId)
+            return this.local.start(value, authorized, options);
+        const input = validateNativeTask(value), machineId = options.machineId, remote = this.machine(machineId);
+        if (!authorized())
+            throw new Error("Authorization expired before remote execution");
+        const existing = remote.task(input.requestId) ?? this.pending.get(input.requestId)?.task;
+        // The coordinator journal validates the complete payload digest as well as task identity.
+        if (existing)
+            throw new Error("This remote task was already admitted; reconcile its saved result before retrying");
+        if (remote.hasActiveTask(machineId))
+            throw new Error("This runtime is already executing a task");
+        const task = { id: input.requestId, cli: input.cli, cwd: input.cwd, sandbox: input.sandbox, ...(input.model ? { model: input.model } : {}), status: "starting", startedAt: Date.now(), output: "" };
+        const timer = setTimeout(() => {
+            const pending = this.pending.get(task.id);
+            if (!pending)
+                return;
+            this.finish(task.id, { ...pending.task, status: "failed", finishedAt: Date.now(), outcomeConfirmed: false, error: "Remote execution outcome is unknown. Reconnect the runtime to reconcile; do not retry automatically." });
+        }, 360_000);
+        timer.unref?.();
+        this.pending.set(task.id, { machineId, task, settle: options.onSettled, timer });
+        if (options.mcp)
+            this.scopes.set(task.id, { machineId, connection: options.mcp });
+        const payload = { task: input, ...(options.resumeSessionId ? { resumeSessionId: options.resumeSessionId } : {}), ...(options.context ? { context: options.context } : {}), ...(options.mcp ? { mcp: { tools: options.mcp.tools } } : {}) };
+        void remote.call(machineId, "run", payload).then(result => {
+            const accepted = result;
+            if (!accepted || accepted.id !== task.id)
+                throw new Error("Invalid remote execution acceptance");
+            const pending = this.pending.get(task.id);
+            if (pending)
+                pending.task = structuredClone(accepted);
+            if (accepted.finishedAt)
+                this.finish(task.id, accepted);
+        }).catch(() => {
+            const pending = this.pending.get(task.id);
+            if (!pending)
+                return;
+            // A lost response is not proof that the runtime did not execute the command.
+            this.finish(task.id, { ...pending.task, status: "failed", finishedAt: Date.now(), outcomeConfirmed: false, error: "Remote admission could not be confirmed. Reconnect to reconcile this task before sending another." });
+        });
+        return structuredClone(task);
+    }
+    get(id) { return this.coordinator()?.task(id) ?? structuredClone(this.pending.get(id)?.task ?? null) ?? this.local.get(id); }
+    list() { return [...this.local.list(), ...Array.from(this.pending.values(), item => structuredClone(item.task))]; }
+    hasActiveTask(machineId) { return machineId ? this.coordinator()?.hasActiveTask(machineId) ?? true : this.local.hasActiveTask(); }
+    cancel(id) {
+        const pending = this.pending.get(id), remote = this.coordinator(), task = remote?.task(id) ?? pending?.task;
+        if (!task)
+            return this.local.cancel(id);
+        if (!pending)
+            throw new Error("Reconnect and reconcile the remote task before cancelling it");
+        this.scopes.delete(id);
+        void this.machine(pending.machineId).call(pending.machineId, "cancel", { runId: id }).catch(() => { });
+        pending.task = { ...task, status: "cancelling" };
+        return structuredClone(pending.task);
+    }
+    releaseUnknown(id) {
+        if (this.coordinator()?.task(id) || this.pending.has(id))
+            throw new Error("Remote process state must be reconciled on its runtime before recovery");
+        this.local.releaseUnknown(id);
+    }
+    async recoverRemote(machineId, id) {
+        const task = await this.machine(machineId).call(machineId, "recover", { runId: id, confirmedStopped: true });
+        if (!task || task.id !== id || !task.finishedAt || task.outcomeConfirmed !== true)
+            throw new Error("The runtime has not confirmed process recovery");
+        this.finish(id, task);
+        return task;
+    }
+    async mcp(machineId, runId, body) {
+        const scope = this.scopes.get(runId), remote = this.machine(machineId), task = remote.task(runId) ?? this.pending.get(runId)?.task;
+        if (!scope || scope.machineId !== machineId || !task || task.finishedAt)
+            throw new Error("The remote tool execution is not active");
+        // The central capability still rechecks the agent, original turn and live tool permissions at admission.
+        return nativeMcpHttp(scope.connection, body);
+    }
+    close() {
+        this.subscription?.();
+        this.subscription = null;
+        this.attached = null;
+        this.scopes.clear();
+        for (const pending of this.pending.values())
+            clearTimeout(pending.timer);
+        this.pending.clear();
+        this.local.close();
+    }
+}
+//# sourceMappingURL=runtime-windows-bridge.js.map

package/dist/runtime-windows-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-windows-bridge.js","sourceRoot":"","sources":["../src/runtime-windows-bridge.ts"],"names":[],"mappings":"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"}

package/dist/settings-api.js

@@ -11,6 +11,7 @@ import { gatewayRequestContext } from "./web-request-context.js";
 import { applyAppearanceChanges, applyGuestsPatch, applyVerifiedAuthorityPatch, parseAppearanceSettingsBody, parseWebSettingsBody } from "./web-settings-patch.js";
 import { APPEARANCE_BOUNDS, APPEARANCE_DEFAULTS, effectiveAppearanceLimits } from "./web-appearance-limits.js";
 import { permitWebContinuation } from "./web-continuation.js";
+import { parseRuntimesSettingsBody, runtimeSettingsView } from "./runtime-switches.js";
 import { evaluateWebRequest } from "./web-auth.js";
 import { redactInlineSecrets, restoreRedactedSecrets } from "./settings-redaction.js";
 /**
@@ -910,6 +911,63 @@ export function handleSettingsRequest(req, res, url, ctx) {
         return true;
     }
     // One hot web toggle; an unrelated Settings edit never materializes defaults.
+    // ── M-2255: Settings → Runtime's switches — "Use this PC's Windows CLIs" (runtimes.windows_cli) and "Allow other
+    // Windows computers to pair" (runtimes.remote_runtime). Off by default; the environment overrides them (said here).
+    // Never over the public link. Switching one on is confirmed by a General admin (settings-change.ts); off applies at once.
+    if (method === "GET" && path === "/api/settings/runtimes") {
+        if (gatewayRequestContext(req)) {
+            json(res, 403, { error: "runtime_settings_not_over_public_link" });
+            return true;
+        }
+        json(res, 200, runtimeSettingsView(cfg));
+        return true;
+    }
+    if (method === "PUT" && path === "/api/settings/fleet/runtimes") {
+        if (gatewayRequestContext(req)) {
+            json(res, 403, { error: "runtime_settings_not_over_public_link" });
+            return true;
+        }
+        if (!cfg) {
+            json(res, 503, { error: "fleet not loaded" });
+            return true;
+        }
+        readBody(req, 4096).then(buf => {
+            if (!permitWebContinuation(req, res, ctx))
+                return;
+            let body;
+            try {
+                body = JSON.parse(buf.toString("utf-8"));
+            }
+            catch {
+                return json(res, 400, { error: "invalid JSON" });
+            }
+            const parsed = parseRuntimesSettingsBody(body);
+            if ("error" in parsed)
+                return json(res, parsed.status, { error: parsed.error });
+            const changes = Object.entries(parsed.patch).map(([key, value]) => ({ path: ["runtimes", key], value }));
+            if (!changes.length)
+                return json(res, 200, { ok: true });
+            const runtimes = { ...cfg.runtimes, ...parsed.patch };
+            const before = validateFleet(cfg), after = validateFleet({ ...cfg, runtimes });
+            if (rejectIfWorse(res, before, after))
+                return;
+            const previous = { runtimes: cfg.runtimes, had: "runtimes" in cfg };
+            try {
+                settingsWrite(req, () => { cfg.runtimes = runtimes; ctx.saveFleetConfig(changes); });
+            }
+            catch (err) {
+                // The save refused (fleet.yaml unchanged): memory goes back to what the file still says.
+                if (previous.had)
+                    cfg.runtimes = previous.runtimes;
+                else
+                    delete cfg.runtimes;
+                ctx.logger.warn({ err }, "settings: runtime switches save refused");
+                return json(res, 500, { ok: false, error: err.message });
+            }
+            json(res, 200, { ok: true, ...runtimeSettingsView(cfg), warnings: saveWarnings(before, after) });
+        }).catch(() => json(res, 400, { error: "bad request" }));
+        return true;
+    }
     if (method === "PUT" && path === "/api/settings/fleet/web") {
         // #1620: never over the temporary public link — refused before the body is read (the confirmation gate refuses it
         // first; this is the second wall, for any path that reaches the handler without it).