@jmfederico/pi-web 1.202609.0 → 1.202610.0

package/dist/server/sessions/sessionActivityMarker.js

@@ -0,0 +1,105 @@
+import { randomUUID } from "node:crypto";
+import { readFile, stat, unlink, writeFile } from "node:fs/promises";
+const markerPath = (sessionFile) => `${sessionFile}.pi-web-activity.json`;
+const isMissing = (error) => typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+/** Best-effort advisory presence, not a lock or an atomic ownership claim. */
+export class SessionActivityMarker {
+    constructor(options = {}) {
+        this.entries = new Map();
+        this.owner = options.owner ?? randomUUID();
+        this.now = options.now ?? Date.now;
+        this.onError = options.onError;
+    }
+    async refresh(sessionFile, busy) {
+        if (sessionFile === undefined || sessionFile === "" || this.disposal)
+            return;
+        let entry = this.entries.get(sessionFile);
+        if (!entry) {
+            entry = { pending: Promise.resolve(), activeElsewhere: false };
+            this.entries.set(sessionFile, entry);
+        }
+        const state = entry;
+        await this.enqueue(state, async () => {
+            const now = this.now();
+            if (state.busy === busy && state.refreshedAt !== undefined && now - state.refreshedAt < 2_000)
+                return;
+            state.busy = busy;
+            state.refreshedAt = now;
+            // Keep the last known activity visible until the filesystem read completes.
+            // Never create directories or sidecars for transcripts that do not exist.
+            await stat(sessionFile);
+            const marker = await this.readMarker(sessionFile);
+            state.activeElsewhere = marker !== undefined && marker.owner !== this.owner && now - marker.updatedAt <= 15_000;
+            if (state.activeElsewhere)
+                return;
+            if (busy) {
+                await writeFile(markerPath(sessionFile), JSON.stringify({ owner: this.owner, updatedAt: now }));
+            }
+            else if (marker?.owner === this.owner) {
+                await unlink(markerPath(sessionFile));
+            }
+        });
+    }
+    isActiveElsewhere(sessionFile) {
+        return sessionFile === undefined ? false : this.entries.get(sessionFile)?.activeElsewhere ?? false;
+    }
+    async release(sessionFile) {
+        if (sessionFile === undefined || sessionFile === "")
+            return;
+        const entry = this.entries.get(sessionFile);
+        if (!entry)
+            return;
+        const pending = this.enqueue(entry, async () => {
+            entry.activeElsewhere = false;
+            delete entry.refreshedAt;
+            delete entry.busy;
+            if ((await this.readMarker(sessionFile))?.owner === this.owner) {
+                await unlink(markerPath(sessionFile));
+            }
+        });
+        await pending;
+        if (entry.pending === pending)
+            this.entries.delete(sessionFile);
+    }
+    async dispose() {
+        this.disposal ??= Promise.all([...this.entries.keys()].map((file) => this.release(file))).then(() => undefined);
+        await this.disposal;
+    }
+    enqueue(entry, operation) {
+        entry.pending = entry.pending.then(operation).catch((error) => {
+            entry.activeElsewhere = false;
+            if (!isMissing(error)) {
+                // An error reporter must not turn advisory IO into a session failure.
+                try {
+                    this.onError?.(error);
+                }
+                catch { /* Best effort only. */ }
+            }
+        });
+        return entry.pending;
+    }
+    async readMarker(sessionFile) {
+        let text;
+        try {
+            text = await readFile(markerPath(sessionFile), "utf8");
+        }
+        catch (error) {
+            if (isMissing(error))
+                return undefined;
+            throw error;
+        }
+        let value;
+        try {
+            value = JSON.parse(text);
+        }
+        catch {
+            return undefined;
+        }
+        if (typeof value !== "object" || value === null || !("owner" in value) || !("updatedAt" in value))
+            return undefined;
+        if (typeof value.owner !== "string" || typeof value.updatedAt !== "number" || !Number.isFinite(value.updatedAt))
+            return undefined;
+        return { owner: value.owner, updatedAt: value.updatedAt };
+    }
+}
+//# sourceMappingURL=sessionActivityMarker.js.map

package/dist/server/sessions/sessionActivityMarker.js.map

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

package/dist/server/sessions/sessionEnvironmentFacts.js

@@ -11,9 +11,9 @@
  *
  * The block tells the agent the nesting exists and which precautions follow,
  * so it learns the rules before discovering them by breaking its own session:
- * use a distinct data dir, socket, and ports for another instance; never
- * restart the session daemon hosting the session; and restart the web/API
- * process before the session daemon when restarts are needed.
+ * use a distinct data dir, socket, and ports for another instance; require an
+ * explicit user override before stopping or restarting the hosting daemon;
+ * and restart the web/API process before the session daemon.
  */
 import { piWebDataDir } from "../../config.js";
 import { sessiondEndpointDescription } from "../../sessiond/config.js";
@@ -25,7 +25,8 @@ export function sessionEnvironmentFacts({ env }) {
         `This session runs inside a PI WEB session daemon. Every process spawned from it — the bash tool, terminals, subsessions — inherits \`${PI_WEB_SESSION_ENV}=1\`, marking it as nested inside this PI WEB instance.`,
         `The hosting instance owns the data directory \`${piWebDataDir(env)}\` and its session daemon listens on \`${sessiondEndpointDescription(env)}\`. Spawned processes inherit the daemon's \`PI_WEB_*\` environment, which points at that same live instance.`,
         "Starting another PI WEB instance with those inherited values fails loudly at startup because the live instance owns the state. To run a second instance, give it a distinct `PI_WEB_DATA_DIR`, `PI_WEB_SESSIOND_SOCKET` (or `PI_WEB_SESSIOND_PORT` / `PI_WEB_SESSIOND_HOST`), and `PI_WEB_PORT`.",
-        "Never restart or stop the session daemon hosting this session: it owns the terminals and the session runtime, so restarting it kills this session's own work. When PI WEB services must be restarted, restart the web/API process before the session daemon.",
+        "Do not restart or stop the session daemon hosting this session unless the user explicitly requests or authorizes that daemon restart or stop. An explicit user request overrides this default restriction, including a request to schedule the operation. The daemon owns the terminals and session runtime, so warn the user that the operation interrupts active sessions and this session's own work. A general request to fix the app is not authorization to restart the daemon.",
+        "For an authorized scheduled daemon restart or stop, use a detached service-manager timer (such as systemd-run --user --on-active), not a sleep process owned by this session. Report the scheduled operation and delay before it runs; do not claim completion without checking. When both PI WEB services must be restarted, restart the web/API process before the session daemon.",
     ];
     return [
         "<pi_web_session_environment>",

package/dist/server/sessions/sessionEnvironmentFacts.js.map

@@ -1 +1 @@
-{"version":3,"file":"sessionEnvironmentFacts.js","sourceRoot":"","sources":["../../../src/server/sessions/sessionEnvironmentFacts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAEvE,gGAAgG;AAChG,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAMnD,iDAAiD;AACjD,MAAM,UAAU,uBAAuB,CAAC,EAAE,GAAG,EAAgC;IAC3E,MAAM,KAAK,GAAG;QACZ,wIAAwI,kBAAkB,yDAAyD;QACnN,kDAAkD,YAAY,CAAC,GAAG,CAAC,0CAA0C,2BAA2B,CAAC,GAAG,CAAC,+GAA+G;QAC5P,kSAAkS;QAClS,8PAA8P;KAC/P,CAAC;IACF,OAAO;QACL,8BAA8B;QAC9B,oDAAoD;QACpD,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;QACnC,+BAA+B;KAChC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAQD;;;;;GAKG;AACH,MAAM,UAAU,gCAAgC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAmC;IAChG,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,OAAO,CAAC,uBAAuB,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"sessionEnvironmentFacts.js","sourceRoot":"","sources":["../../../src/server/sessions/sessionEnvironmentFacts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAEvE,gGAAgG;AAChG,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAMnD,iDAAiD;AACjD,MAAM,UAAU,uBAAuB,CAAC,EAAE,GAAG,EAAgC;IAC3E,MAAM,KAAK,GAAG;QACZ,wIAAwI,kBAAkB,yDAAyD;QACnN,kDAAkD,YAAY,CAAC,GAAG,CAAC,0CAA0C,2BAA2B,CAAC,GAAG,CAAC,+GAA+G;QAC5P,kSAAkS;QAClS,udAAud;QACvd,sXAAsX;KACvX,CAAC;IACF,OAAO;QACL,8BAA8B;QAC9B,oDAAoD;QACpD,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;QACnC,+BAA+B;KAChC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAQD;;;;;GAKG;AACH,MAAM,UAAU,gCAAgC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAmC;IAChG,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,OAAO,CAAC,uBAAuB,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;AAC5C,CAAC"}

package/dist/server/sessions/sessionMediaIndex.js

@@ -0,0 +1,184 @@
+import { createHash } from "node:crypto";
+import { canonicalizeStoredCwd } from "../workingDirectory.js";
+/**
+ * Disposable daemon-owned source bindings and hash memos, never extracted files
+ * or decoded-byte caches. Bindings are scoped to a session AND workspace. Both
+ * strong indexes are bounded; weak block memos survive eviction only as long as
+ * their runtime/transcript owner retains the original block.
+ */
+export class SessionMediaIndex {
+    constructor(options = {}) {
+        this.media = new Map();
+        this.memo = new Map();
+        this.blocks = new WeakMap();
+        this.mediaBytes = 0;
+        this.memoBytes = 0;
+        this.maxMediaBytes = options.maxMediaBytes ?? 64 * 1024 * 1024;
+        this.maxMediaEntries = options.maxMediaEntries ?? 1024;
+        this.maxMemoBytes = options.maxMemoBytes ?? 32 * 1024 * 1024;
+        this.maxMemoEntries = options.maxMemoEntries ?? 256;
+        this.hash = options.hash ?? ((source) => createHash("sha256").update(source).digest("hex"));
+        this.decode = options.decode ?? ((source) => Buffer.from(source, "base64"));
+    }
+    /** An unscoped projection may produce a reference, but cannot create a binding. */
+    reference(scope, block) {
+        const image = this.image(block);
+        if (image === undefined)
+            return undefined;
+        if (scope !== undefined)
+            this.remember(scope, image);
+        return image.reference;
+    }
+    get(scope, mediaId) {
+        const key = bindingKey(scope, mediaId);
+        const image = this.media.get(key);
+        if (image === undefined)
+            return undefined;
+        this.media.delete(key);
+        this.media.set(key, image);
+        return this.decodeImage(image);
+    }
+    /** Stop at the match; known nonmatching blocks need neither hashing nor decoding. */
+    find(scope, mediaId, values) {
+        for (const value of values) {
+            for (const block of imageBlocks(value)) {
+                const image = this.image(block);
+                if (image?.reference.mediaId !== mediaId)
+                    continue;
+                this.remember(scope, image);
+                return this.decodeImage(image);
+            }
+        }
+        return undefined;
+    }
+    forgetSession(scope) {
+        const prefix = `${scopeKey(scope)}:`;
+        for (const [key, image] of this.media) {
+            if (!key.startsWith(prefix))
+                continue;
+            this.media.delete(key);
+            this.mediaBytes -= bindingWeight(image);
+        }
+    }
+    clear() {
+        this.media.clear();
+        this.memo.clear();
+        this.blocks = new WeakMap();
+        this.mediaBytes = 0;
+        this.memoBytes = 0;
+    }
+    image(block) {
+        if (block["type"] !== "image" || typeof block["data"] !== "string" || !isSessionImageMimeType(block["mimeType"]))
+            return undefined;
+        const source = block["data"];
+        const mimeType = block["mimeType"];
+        const previous = this.blocks.get(block);
+        if (previous?.source === source && previous.mimeType === mimeType)
+            return previous;
+        const key = `${mimeType}\0${source}`;
+        const cached = this.memo.get(key);
+        if (cached !== undefined) {
+            this.memo.delete(key);
+            this.memo.set(key, cached);
+            this.blocks.set(block, cached);
+            return cached;
+        }
+        const byteSize = imageByteSize(source);
+        if (byteSize === undefined)
+            return undefined;
+        const image = { source, mimeType, reference: { type: "image", mediaId: this.hash(key), mimeType, byteSize } };
+        this.blocks.set(block, image);
+        const weight = memoWeight(image);
+        if (weight <= this.maxMemoBytes && this.maxMemoEntries > 0) {
+            this.memo.set(key, image);
+            this.memoBytes += weight;
+            while (this.memoBytes > this.maxMemoBytes || this.memo.size > this.maxMemoEntries) {
+                const oldest = this.memo.entries().next().value;
+                if (oldest === undefined)
+                    break;
+                this.memo.delete(oldest[0]);
+                this.memoBytes -= memoWeight(oldest[1]);
+            }
+        }
+        return image;
+    }
+    decodeImage(image) {
+        return { data: this.decode(image.source), mimeType: image.mimeType };
+    }
+    remember(scope, image) {
+        const weight = bindingWeight(image);
+        if (weight > this.maxMediaBytes || this.maxMediaEntries <= 0)
+            return;
+        const key = bindingKey(scope, image.reference.mediaId);
+        const previous = this.media.get(key);
+        if (previous !== undefined)
+            this.mediaBytes -= bindingWeight(previous);
+        this.media.delete(key);
+        this.media.set(key, image);
+        this.mediaBytes += weight;
+        while (this.mediaBytes > this.maxMediaBytes || this.media.size > this.maxMediaEntries) {
+            const oldest = this.media.entries().next().value;
+            if (oldest === undefined)
+                break;
+            this.media.delete(oldest[0]);
+            this.mediaBytes -= bindingWeight(oldest[1]);
+        }
+    }
+}
+export function isSessionImageMimeType(value) {
+    return value === "image/png" || value === "image/jpeg" || value === "image/gif" || value === "image/webp";
+}
+function scopeKey(scope) {
+    return JSON.stringify([scope.id, canonicalizeStoredCwd(scope.cwd)]);
+}
+function bindingKey(scope, mediaId) {
+    return `${scopeKey(scope)}:${mediaId}`;
+}
+function bindingWeight(image) {
+    // Conservatively count UTF-16 source storage, not the deferred binary size.
+    return image.source.length * 2;
+}
+function memoWeight(image) {
+    // The content key also retains a copy of the source and MIME.
+    return bindingWeight(image) + (image.mimeType.length + 1 + image.source.length) * 2;
+}
+function imageByteSize(source) {
+    // Buffer.from(base64) silently accepts junk. Validate standard base64 (with
+    // optional omitted padding) arithmetically, including unused final sextet bits,
+    // without allocating, decoding, or re-encoding every transcript image.
+    if (source === "" || !/^[A-Za-z0-9+/]+={0,2}$/u.test(source))
+        return undefined;
+    const padding = source.endsWith("==") ? 2 : source.endsWith("=") ? 1 : 0;
+    const length = source.length - padding;
+    const remainder = length % 4;
+    if (remainder === 1 || (padding > 0 && (source.length % 4 !== 0 || padding !== 4 - remainder)))
+        return undefined;
+    const last = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/".indexOf(source.charAt(length - 1));
+    if ((remainder === 2 && (last & 15) !== 0) || (remainder === 3 && (last & 3) !== 0))
+        return undefined;
+    return Math.floor(length * 3 / 4);
+}
+/** Only Pi content containers, not arbitrary tool arguments or provider metadata. */
+function* imageBlocks(value) {
+    if (isUnknownArray(value)) {
+        for (const part of value)
+            yield* imageBlocks(part);
+    }
+    else if (isRecord(value)) {
+        if (value["type"] === "image")
+            yield value;
+        else {
+            if (value["content"] !== undefined)
+                yield* imageBlocks(value["content"]);
+            if (value["message"] !== undefined)
+                yield* imageBlocks(value["message"]);
+        }
+    }
+}
+function isUnknownArray(value) {
+    return Array.isArray(value);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=sessionMediaIndex.js.map

package/dist/server/sessions/sessionMediaIndex.js.map

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

package/dist/server/sessions/sessionNameGenerator.js

@@ -1,3 +1,4 @@
+import { normalizeContext } from "@earendil-works/pi-ai";
 const SESSION_NAME_TIMEOUT_MS = 10_000;
 const SESSION_NAME_MAX_INPUT_CHARS = 4_000;
 const SESSION_NAME_MAX_LENGTH = 60;
@@ -9,14 +10,14 @@ export function deterministicSessionName(firstMessage) {
     return relayHandoffSessionName(firstMessage.trimStart());
 }
 export async function generateShortSessionName(streamFn, model, firstMessage) {
-    const stream = await streamFn(model, {
+    const stream = await streamFn(model, normalizeContext({
         systemPrompt: "Generate a concise title for a coding-agent chat session. Return only the title, with no quotes or punctuation wrapper.",
         messages: [{
                 role: "user",
                 content: `Create a 2-6 word title for this request:\n\n${truncateInput(firstMessage)}`,
                 timestamp: Date.now(),
             }],
-    }, {
+    }), {
         maxTokens: 24,
         reasoning: "minimal",
         signal: AbortSignal.timeout(SESSION_NAME_TIMEOUT_MS),

package/dist/server/sessions/sessionNameGenerator.js.map

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

package/dist/server/sessions/sessionRoutes.js

@@ -1,5 +1,8 @@
 import { ASK_USER_ID_MAX_LENGTH, ASK_USER_OPTION_LIMIT, ASK_USER_OTHER_TEXT_MAX_LENGTH, ASK_USER_QUESTION_LIMIT, EXTENSION_DIALOG_ID_MAX_LENGTH, EXTENSION_DIALOG_INPUT_MAX_LENGTH, SESSION_TREE_CUSTOM_INSTRUCTIONS_MAX_LENGTH, SESSION_UNREAD_CATALOG_ID_MAX_LENGTH, SESSION_UNREAD_CWD_MAX_LENGTH, SESSION_UNREAD_SESSION_ID_MAX_LENGTH } from "../../shared/apiTypes.js";
-import { projectBrowserMessageResponse } from "../browserMessageProjection.js";
+import { parseSessionDefaultsUpdate } from "../../shared/sessionDefaults.js";
+import { projectBrowserMessageResponse, projectBrowserStreamSnapshot, projectBrowserTranscriptSnapshot } from "../browserMessageProjection.js";
+import { isSessionMediaId, SESSION_MEDIA_MODE } from "../../shared/sessionMedia.js";
+import { isSessionImageMimeType } from "./sessionMediaIndex.js";
 import { normalizeRequestCwd } from "../workingDirectory.js";
 import { normalizeSessionCleanupRequest } from "./sessionCleanup.js";
 const MAX_NOTIFICATION_SESSION_ID_LENGTH = 512;
@@ -142,12 +145,37 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
         try {
             const page = { ...optionalField("before", optionalNumber(request.query.before)), ...optionalField("limit", optionalNumber(request.query.limit)) };
             const messages = await sessions.messages(ref, page);
-            return projectBrowserMessageResponse(messages);
+            return projectBrowserMessageResponse(messages, imageProjector(request.query, eventHub, ref));
         }
         catch (error) {
             return reply.code(404).send({ error: errorMessage(error) });
         }
     });
+    app.get(`${prefix}/sessions/:sessionId/media/:mediaId`, async (request, reply) => {
+        const ref = sessionRefFromQueryOr400(request.params.sessionId, request.query, reply);
+        if (ref === undefined)
+            return reply;
+        if (!isSessionMediaId(request.params.mediaId))
+            return reply.code(400).send({ error: "Invalid media id" });
+        try {
+            const media = await sessions.media(ref, request.params.mediaId);
+            if (media === undefined)
+                return await reply.code(404).send({ error: "Session media not found" });
+            if (!isSessionImageMimeType(media.mimeType))
+                throw new Error("Unsupported session image MIME type");
+            return await reply
+                .type(media.mimeType)
+                .header("Cache-Control", "private, max-age=31536000, immutable")
+                .header("Content-Length", media.data.byteLength)
+                .header("X-Content-Type-Options", "nosniff")
+                .send(media.data);
+        }
+        catch (error) {
+            if (isSessionNotFoundError(error))
+                return reply.code(404).send({ error: errorMessage(error) });
+            throw error; // Fastify logs unexpected failures and returns 500, not a false miss.
+        }
+    });
     app.get(`${prefix}/sessions/:sessionId/status`, async (request, reply) => {
         const ref = sessionRefFromQueryOr400(request.params.sessionId, request.query, reply);
         if (ref === undefined)
@@ -159,12 +187,24 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return reply.code(404).send({ error: errorMessage(error) });
         }
     });
+    app.get(`${prefix}/sessions/:sessionId/transcript-snapshot`, async (request, reply) => {
+        const ref = sessionRefFromQueryOr400(request.params.sessionId, request.query, reply);
+        if (ref === undefined)
+            return reply;
+        try {
+            const snapshot = await sessions.transcriptSnapshot(ref, { ...optionalField("limit", optionalNumber(request.query.limit)) });
+            return projectBrowserTranscriptSnapshot(snapshot, imageProjector(request.query, eventHub, ref));
+        }
+        catch (error) {
+            return reply.code(404).send({ error: errorMessage(error) });
+        }
+    });
     app.get(`${prefix}/sessions/:sessionId/stream-snapshot`, async (request, reply) => {
         const ref = sessionRefFromQueryOr400(request.params.sessionId, request.query, reply);
         if (ref === undefined)
             return reply;
         try {
-            return await sessions.streamSnapshot(ref);
+            return projectBrowserStreamSnapshot(await sessions.streamSnapshot(ref), imageProjector(request.query, eventHub, ref));
         }
         catch (error) {
             return reply.code(404).send({ error: errorMessage(error) });
@@ -234,6 +274,23 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
         }
     });
+    app.get(`${prefix}/sessions/:sessionId/defaults`, async (request, reply) => {
+        try {
+            return await sessions.getSessionDefaults(sessionRefFromQuery(request.params.sessionId, request.query));
+        }
+        catch (error) {
+            return reply.code(400).send({ error: errorMessage(error) });
+        }
+    });
+    app.post(`${prefix}/sessions/:sessionId/defaults`, async (request, reply) => {
+        try {
+            const body = requireRecord(request.body);
+            return await sessions.setSessionDefaults(sessionRefFromBody(request.params.sessionId, body), parseSessionDefaultsUpdate(body));
+        }
+        catch (error) {
+            return reply.code(400).send({ error: errorMessage(error) });
+        }
+    });
     app.get(`${prefix}/sessions/:sessionId/thinking-levels`, async (request, reply) => {
         const ref = sessionRefFromQueryOr400(request.params.sessionId, request.query, reply);
         if (ref === undefined)
@@ -466,7 +523,7 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
     app.get(`${prefix}/sessions/:sessionId/events`, { websocket: true }, (socket, request) => {
         // Only the id matters for event subscription; cwd is intentionally ignored
         // so a malformed value cannot throw inside the websocket handler.
-        eventHub.add(request.params.sessionId, socket);
+        eventHub.add(request.params.sessionId, socket, request.query.media === SESSION_MEDIA_MODE ? SESSION_MEDIA_MODE : undefined);
     });
     app.get(`${prefix}/sessions/events`, { websocket: true }, (socket) => {
         eventHub.addGlobal(socket);
@@ -475,6 +532,9 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
         eventHub.addGlobal(socket);
     });
 }
+function imageProjector(query, hub, ref) {
+    return query.media === SESSION_MEDIA_MODE ? (image) => hub.mediaIndex.reference(ref, image) : undefined;
+}
 function bulkMutationRefsFromBody(body) {
     const record = requireRecord(body);
     const sessions = record["sessions"];