@chainingintention/pi-web-cn 2.0.0 → 2.202610.0

package/dist/server/sessions/sessionRoutes.js

@@ -1,14 +1,20 @@
+import { UserFacingError, userFacingErrorMessage } from "../../shared/i18n.js";
+import { loadNodeTranslator } from "../../localization.js";
 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 { attachWorkbenchAccessHandle, decodeManagementContext, MANAGEMENT_EMBED_CONTEXT_HEADER, WORKBENCH_ACCESS_HANDLE_HEADER } from "../managementEmbed.js";
 import { eventScopeFromManagementContext } from "../realtime/sessionEventScope.js";
 import { normalizeSessionCleanupRequest } from "./sessionCleanup.js";
+import { parseQueueMessageMutation } from "./queuedMessageMutation.js";
 const MAX_NOTIFICATION_SESSION_ID_LENGTH = 512;
 const MAX_NOTIFICATION_CWD_LENGTH = 32 * 1024;
 const MAX_NOTIFICATION_DAEMON_ID_LENGTH = 512;
 const MAX_NOTIFICATION_ID_LENGTH = 1024;
-export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
+export function registerSessionRoutes(app, sessions, eventHub, prefix = "", t = loadNodeTranslator("server")) {
     app.get(`${prefix}/sessions`, async (request, reply) => {
         if (request.query.cwd === undefined || request.query.cwd === "")
             return reply.code(400).send({ error: "cwd query parameter is required" });
@@ -16,7 +22,7 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return await sessions.list(normalizeRequestCwd(request.query.cwd), managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(400).send({ error: errorMessage(error) });
+            return reply.code(400).send({ error: errorMessage(error, t) });
         }
     });
     app.get(`${prefix}/sessions/search`, async (request, reply) => {
@@ -28,7 +34,7 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return await sessions.search(normalizeRequestCwd(request.query.cwd), request.query.q, managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(400).send({ error: errorMessage(error) });
+            return reply.code(400).send({ error: errorMessage(error, t) });
         }
     });
     app.get(`${prefix}/sessions/pins`, async (request, reply) => {
@@ -38,7 +44,7 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return await sessions.listPinned(normalizeRequestCwd(request.query.cwd), managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(400).send({ error: errorMessage(error) });
+            return reply.code(400).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions`, async (request, reply) => {
@@ -55,23 +61,23 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             });
         }
         catch (error) {
-            return reply.code(400).send({ error: errorMessage(error) });
+            return reply.code(400).send({ error: errorMessage(error, t) });
         }
     });
-    app.get(`${prefix}/sessions/notifications`, async (_request, reply) => {
+    app.get(`${prefix}/sessions/notifications`, async (request, reply) => {
         try {
-            return await sessions.notificationCatalog();
+            return await sessions.notificationCatalog(managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(400).send({ error: errorMessage(error) });
+            return reply.code(400).send({ error: errorMessage(error, t) });
         }
     });
-    app.get(`${prefix}/sessions/unread`, async (_request, reply) => {
+    app.get(`${prefix}/sessions/unread`, async (request, reply) => {
         try {
-            return await sessions.unreadCatalog();
+            return await sessions.unreadCatalog(managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(503).send({ error: errorMessage(error) });
+            return reply.code(503).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions/:sessionId/unread/acknowledge`, async (request, reply) => {
@@ -87,13 +93,13 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             };
         }
         catch (error) {
-            return reply.code(400).send({ error: errorMessage(error) });
+            return reply.code(400).send({ error: errorMessage(error, t) });
         }
         try {
-            return await sessions.acknowledgeUnread(sessionId, acknowledgement);
+            return await sessions.acknowledgeUnread(sessionId, acknowledgement, managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(503).send({ error: errorMessage(error) });
+            return reply.code(503).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions/cleanup/preview`, async (request, reply) => {
@@ -101,15 +107,15 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return await sessions.cleanupPreview(normalizeSessionCleanupRequest(optionalRecord(request.body)));
         }
         catch (error) {
-            return reply.code(400).send({ error: errorMessage(error) });
+            return reply.code(400).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions/cleanup`, async (request, reply) => {
         try {
-            return await sessions.cleanup(normalizeSessionCleanupRequest(optionalRecord(request.body)));
+            return await sessions.cleanup(normalizeSessionCleanupRequest(optionalRecord(request.body)), managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(400).send({ error: errorMessage(error) });
+            return reply.code(400).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions/bulk/archive`, async (request, reply) => {
@@ -117,7 +123,7 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return await sessions.archiveMany(bulkMutationRefsFromBody(request.body), managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions/bulk/delete-archived`, async (request, reply) => {
@@ -125,7 +131,7 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return await sessions.deleteArchivedMany(bulkMutationRefsFromBody(request.body), managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.put(`${prefix}/sessions/:sessionId/pin`, async (request, reply) => {
@@ -134,7 +140,7 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return await sessions.setPinned(sessionLookupFromRequiredCwd(request.params.sessionId, body), true, managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.delete(`${prefix}/sessions/:sessionId/pin`, async (request, reply) => {
@@ -142,15 +148,15 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return await sessions.setPinned(sessionLookupFromRequiredCwd(request.params.sessionId, request.query), false, managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.get(`${prefix}/sessions/:sessionId/notifications`, async (request, reply) => {
         try {
-            return await sessions.notificationInbox(notificationRefFromQuery(request.params.sessionId, request.query));
+            return await sessions.notificationInbox(notificationRefFromQuery(request.params.sessionId, request.query), managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(notificationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(notificationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions/:sessionId/notifications/dismiss`, async (request, reply) => {
@@ -160,10 +166,10 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return await sessions.dismissNotification(ref, {
                 daemonInstanceId: requireNonEmptyBoundedString(body["daemonInstanceId"], "daemonInstanceId", MAX_NOTIFICATION_DAEMON_ID_LENGTH),
                 notificationId: requireNonEmptyBoundedString(body["notificationId"], "notificationId", MAX_NOTIFICATION_ID_LENGTH),
-            });
+            }, managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(notificationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(notificationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions/:sessionId/notifications/dismiss-all`, async (request, reply) => {
@@ -174,28 +180,59 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
                 daemonInstanceId: requireNonEmptyBoundedString(body["daemonInstanceId"], "daemonInstanceId", MAX_NOTIFICATION_DAEMON_ID_LENGTH),
                 throughOrder: requireNonNegativeSafeInteger(body["throughOrder"], "throughOrder"),
                 throughOverflowWatermark: requireNonNegativeSafeInteger(body["throughOverflowWatermark"], "throughOverflowWatermark"),
-            });
+            }, managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(notificationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(notificationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.get(`${prefix}/sessions/:sessionId/messages`, async (request, reply) => {
+        const ref = sessionRefFromQueryOr400(request.params.sessionId, request.query, reply, t);
+        if (ref === undefined)
+            return reply;
         try {
             const page = { ...optionalField("before", optionalNumber(request.query.before)), ...optionalField("limit", optionalNumber(request.query.limit)) };
-            const messages = await sessions.messages(sessionLookupFromQuery(request.params.sessionId, request.query), page, managementContextFromHeaders(request.headers));
-            return projectBrowserMessageResponse(messages);
+            const messages = await sessions.messages(ref, page, managementContextFromHeaders(request.headers));
+            return projectBrowserMessageResponse(messages, imageProjector(request.query, eventHub, ref, eventScopeFromHeaders(request.headers)));
+        }
+        catch (error) {
+            return reply.code(404).send({ error: errorMessage(error, t) });
+        }
+    });
+    app.get(`${prefix}/sessions/:sessionId/media/:mediaId`, async (request, reply) => {
+        const ref = sessionRefFromQueryOr400(request.params.sessionId, request.query, reply, t);
+        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, managementContextFromHeaders(request.headers));
+            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) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            if (isSessionNotFoundError(error))
+                return reply.code(404).send({ error: errorMessage(error, t) });
+            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, t);
+        if (ref === undefined)
+            return reply;
         try {
-            return await sessions.status(sessionLookupFromQuery(request.params.sessionId, request.query), managementContextFromHeaders(request.headers));
+            return await sessions.status(ref, managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(404).send({ error: errorMessage(error, t) });
         }
     });
     app.get(`${prefix}/sessions/search-content`, async (request, reply) => {
@@ -207,23 +244,73 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return await sessions.searchContent(normalizeRequestCwd(request.query.cwd), request.query.q, managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(400).send({ error: errorMessage(error) });
+            return reply.code(400).send({ error: errorMessage(error, t) });
+        }
+    });
+    app.get(`${prefix}/sessions/:sessionId/transcript-snapshot`, async (request, reply) => {
+        const ref = sessionRefFromQueryOr400(request.params.sessionId, request.query, reply, t);
+        if (ref === undefined)
+            return reply;
+        try {
+            const snapshot = await sessions.transcriptSnapshot(ref, { ...optionalField("limit", optionalNumber(request.query.limit)) }, managementContextFromHeaders(request.headers));
+            return projectBrowserTranscriptSnapshot(snapshot, imageProjector(request.query, eventHub, ref, eventScopeFromHeaders(request.headers)));
+        }
+        catch (error) {
+            return reply.code(404).send({ error: errorMessage(error, t) });
         }
     });
     app.get(`${prefix}/sessions/:sessionId/stream-snapshot`, async (request, reply) => {
+        const ref = sessionRefFromQueryOr400(request.params.sessionId, request.query, reply, t);
+        if (ref === undefined)
+            return reply;
         try {
-            return await sessions.streamSnapshot(sessionLookupFromQuery(request.params.sessionId, request.query), managementContextFromHeaders(request.headers));
+            return projectBrowserStreamSnapshot(await sessions.streamSnapshot(ref, managementContextFromHeaders(request.headers)), imageProjector(request.query, eventHub, ref, eventScopeFromHeaders(request.headers)));
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(404).send({ error: errorMessage(error, t) });
         }
     });
     app.get(`${prefix}/sessions/:sessionId/models`, async (request, reply) => {
+        const ref = sessionRefFromQueryOr400(request.params.sessionId, request.query, reply, t);
+        if (ref === undefined)
+            return reply;
+        try {
+            return { models: await sessions.availableModels(ref, managementContextFromHeaders(request.headers)) };
+        }
+        catch (error) {
+            return reply.code(404).send({ error: errorMessage(error, t) });
+        }
+    });
+    app.get(`${prefix}/sessions/:sessionId/models/catalog`, async (request, reply) => {
+        const ref = sessionRefFromQueryOr400(request.params.sessionId, request.query, reply, t);
+        if (ref === undefined)
+            return reply;
+        try {
+            return { models: await sessions.modelCatalog(ref, managementContextFromHeaders(request.headers)) };
+        }
+        catch (error) {
+            return reply.code(404).send({ error: errorMessage(error, t) });
+        }
+    });
+    app.post(`${prefix}/sessions/:sessionId/models/enabled`, async (request, reply) => {
+        try {
+            const body = optionalRecord(request.body);
+            return { models: await sessions.setModelEnabled(sessionLookupFromBody(request.params.sessionId, body), requireString(body, "provider"), requireString(body, "modelId"), requireBoolean(body, "enabled"), managementContextFromHeaders(request.headers)) };
+        }
+        catch (error) {
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
+        }
+    });
+    app.post(`${prefix}/sessions/:sessionId/models/scope`, async (request, reply) => {
         try {
-            return { models: await sessions.availableModels(sessionLookupFromQuery(request.params.sessionId, request.query), managementContextFromHeaders(request.headers)) };
+            const body = optionalRecord(request.body);
+            const mode = body["mode"];
+            if (!isSessionModelScopeMode(mode))
+                throw new Error(t("server.main.6a6ece1f173c", "mode field must be all or current"));
+            return { models: await sessions.setModelScope(sessionLookupFromBody(request.params.sessionId, body), mode, managementContextFromHeaders(request.headers)) };
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions/:sessionId/model`, async (request, reply) => {
@@ -232,7 +319,7 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return await sessions.setModel(sessionLookupFromBody(request.params.sessionId, body), requireString(body, "provider"), requireString(body, "modelId"), managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions/:sessionId/model/cycle`, async (request, reply) => {
@@ -244,15 +331,35 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return await sessions.cycleModel(sessionLookupFromBody(request.params.sessionId, body), direction ?? "forward", managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
+        }
+    });
+    app.get(`${prefix}/sessions/:sessionId/defaults`, async (request, reply) => {
+        try {
+            return await sessions.getSessionDefaults(sessionLookupFromQuery(request.params.sessionId, request.query), managementContextFromHeaders(request.headers));
+        }
+        catch (error) {
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
+        }
+    });
+    app.post(`${prefix}/sessions/:sessionId/defaults`, async (request, reply) => {
+        try {
+            const body = requireRecord(request.body);
+            return await sessions.setSessionDefaults(sessionLookupFromBody(request.params.sessionId, body), parseSessionDefaultsUpdate(body), managementContextFromHeaders(request.headers));
+        }
+        catch (error) {
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.get(`${prefix}/sessions/:sessionId/thinking-levels`, async (request, reply) => {
+        const ref = sessionRefFromQueryOr400(request.params.sessionId, request.query, reply, t);
+        if (ref === undefined)
+            return reply;
         try {
-            return { levels: await sessions.availableThinkingLevels(sessionLookupFromQuery(request.params.sessionId, request.query), managementContextFromHeaders(request.headers)) };
+            return { levels: await sessions.availableThinkingLevels(ref, managementContextFromHeaders(request.headers)) };
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(404).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions/:sessionId/thinking-level`, async (request, reply) => {
@@ -263,7 +370,7 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return await sessions.setThinkingLevel(sessionLookupFromBody(request.params.sessionId, body), requireThinkingLevel(body["level"]), managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions/:sessionId/thinking-level/cycle`, async (request, reply) => {
@@ -272,15 +379,18 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return await sessions.cycleThinkingLevel(sessionLookupFromBody(request.params.sessionId, body), managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.get(`${prefix}/sessions/:sessionId/commands`, async (request, reply) => {
+        const ref = sessionRefFromQueryOr400(request.params.sessionId, request.query, reply, t);
+        if (ref === undefined)
+            return reply;
         try {
-            return await sessions.commands(sessionLookupFromQuery(request.params.sessionId, request.query), managementContextFromHeaders(request.headers));
+            return await sessions.commands(ref, managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(404).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions/:sessionId/prompt`, async (request, reply) => {
@@ -291,7 +401,16 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return { accepted: true };
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
+        }
+    });
+    app.post(`${prefix}/sessions/:sessionId/queue/message`, async (request, reply) => {
+        try {
+            const body = requireRecord(request.body);
+            return await sessions.mutateQueueMessage(sessionLookupFromRequiredCwd(request.params.sessionId, body), parseQueueMessageMutation(body), managementContextFromHeaders(request.headers));
+        }
+        catch (error) {
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions/:sessionId/queue/clear`, async (request, reply) => {
@@ -299,7 +418,7 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return await sessions.clearQueue(sessionLookupFromBody(request.params.sessionId, optionalRecord(request.body)), managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions/:sessionId/ask/submit`, async (request, reply) => {
@@ -309,7 +428,7 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return await sessions.submitAsk(sessionLookupFromBody(request.params.sessionId, body), askId, askUserSubmissionFromBody(body), managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions/:sessionId/ask/cancel`, async (request, reply) => {
@@ -318,7 +437,7 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return await sessions.cancelAsk(sessionLookupFromBody(request.params.sessionId, body), requireBoundedId(body["askId"], "askId"), managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions/:sessionId/dialogs/answer`, async (request, reply) => {
@@ -328,7 +447,7 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return await sessions.answerDialog(sessionLookupFromBody(request.params.sessionId, body), answer.dialogId, answer.value, managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions/:sessionId/dialogs/cancel`, async (request, reply) => {
@@ -338,16 +457,16 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return await sessions.cancelDialog(sessionLookupFromBody(request.params.sessionId, body), cancel.dialogId, managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions/:sessionId/warnings/dismiss`, async (request, reply) => {
         try {
             const body = optionalRecord(request.body);
-            return await sessions.dismissWarning(sessionLookupFromBody(request.params.sessionId, body), requireString(body, "dismissId"));
+            return await sessions.dismissWarning(sessionLookupFromBody(request.params.sessionId, body), requireString(body, "dismissId"), managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions/:sessionId/attachments`, async (request, reply) => {
@@ -360,7 +479,7 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return { attachments };
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions/:sessionId/shell`, async (request, reply) => {
@@ -370,7 +489,7 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return { accepted: true };
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions/:sessionId/commands/run`, async (request, reply) => {
@@ -379,7 +498,7 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return await sessions.runCommand(sessionLookupFromBody(request.params.sessionId, body), requireString(body, "text"), managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions/:sessionId/commands/respond`, async (request, reply) => {
@@ -388,7 +507,7 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return await sessions.respondToCommand(sessionLookupFromBody(request.params.sessionId, body), requireString(body, "requestId"), requireString(body, "value"), managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions/:sessionId/tree/navigate`, async (request, reply) => {
@@ -397,7 +516,7 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return await sessions.navigateTree(sessionLookupFromBody(request.params.sessionId, body), sessionTreeNavigateRequestFromBody(body), managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions/:sessionId/tree/fork`, async (request, reply) => {
@@ -406,7 +525,7 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return await sessions.forkFromTree(sessionLookupFromBody(request.params.sessionId, body), sessionTreeForkRequestFromBody(body), managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions/:sessionId/abort`, async (request, reply) => {
@@ -415,7 +534,7 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return { aborted: true };
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions/:sessionId/stop`, async (request, reply) => {
@@ -424,7 +543,7 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return { stopped: true };
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions/:sessionId/archive`, async (request, reply) => {
@@ -433,7 +552,7 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return { archived: true };
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions/:sessionId/archive-tree`, async (request, reply) => {
@@ -441,7 +560,7 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return await sessions.archiveTree(sessionLookupFromBody(request.params.sessionId, optionalRecord(request.body)), managementContextFromHeaders(request.headers));
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions/:sessionId/restore`, async (request, reply) => {
@@ -450,7 +569,7 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return { restored: true };
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.delete(`${prefix}/sessions/:sessionId`, async (request, reply) => {
@@ -459,7 +578,7 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return { deleted: true };
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions/:sessionId/reload`, async (request, reply) => {
@@ -468,7 +587,7 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return { reloaded: true };
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     app.post(`${prefix}/sessions/:sessionId/detach-parent`, async (request, reply) => {
@@ -477,13 +596,13 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
             return { detached: true };
         }
         catch (error) {
-            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error) });
+            return reply.code(mutationErrorStatus(error)).send({ error: errorMessage(error, t) });
         }
     });
     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, eventScopeFromHeaders(request.headers));
+        eventHub.add(request.params.sessionId, socket, eventScopeFromHeaders(request.headers), request.query.media === SESSION_MEDIA_MODE ? SESSION_MEDIA_MODE : undefined);
     });
     app.get(`${prefix}/sessions/events`, { websocket: true }, (socket, request) => {
         eventHub.addGlobal(socket, eventScopeFromHeaders(request.headers));
@@ -492,6 +611,9 @@ export function registerSessionRoutes(app, sessions, eventHub, prefix = "") {
         eventHub.addGlobal(socket, eventScopeFromHeaders(request.headers));
     });
 }
+function imageProjector(query, hub, ref, eventScope) {
+    return query.media === SESSION_MEDIA_MODE ? (image) => hub.mediaIndex.reference({ ...ref, eventScope }, image) : undefined;
+}
 function bulkMutationRefsFromBody(body) {
     const record = requireRecord(body);
     const sessions = record["sessions"];
@@ -506,7 +628,7 @@ function parseBulkMutationRef(value) {
         throw new Error("id field must not be empty");
     const cwd = record["cwd"];
     if (typeof cwd !== "string" || cwd === "")
-        throw new Error("cwd field is required");
+        throw new UserFacingError("routing.cwdRequired", "cwd field is required");
     return { id, cwd: normalizeRequestCwd(cwd) };
 }
 function notificationRefFromQuery(id, query) {
@@ -523,6 +645,15 @@ function notificationRef(id, cwd) {
         cwd: normalizeRequestCwd(cwd),
     };
 }
+function sessionRefFromQueryOr400(id, query, reply, t) {
+    try {
+        return sessionLookupFromQuery(id, query);
+    }
+    catch (error) {
+        reply.code(400).send({ error: errorMessage(error, t) });
+        return undefined;
+    }
+}
 function sessionLookupFromQuery(id, query) {
     return sessionLookupFromRequiredCwd(id, query, "cwd query parameter is required");
 }
@@ -543,13 +674,13 @@ function sessionLookupFromBody(id, body) {
 function sessionLookupFromRequiredCwd(id, value, message = "cwd query parameter is required") {
     const cwd = value.cwd;
     if (typeof cwd !== "string" || cwd === "")
-        throw new Error(message);
+        throw new UserFacingError(message === "cwd field is required" ? "routing.cwdRequired" : "routing.cwdQueryRequired", message);
     return { id, cwd: normalizeRequestCwd(cwd) };
 }
 function sessionTreeNavigateRequestFromBody(body) {
     const targetId = requireNonEmptyString(body, "targetId");
     const expectedLeafId = requireNullableString(body, "expectedLeafId");
-    return { targetId, expectedLeafId, summary: sessionTreeSummaryChoice(body["summary"]) };
+    return { targetId, expectedLeafId, summary: sessionTreeSummaryChoice(body["summary"]), ...optionalField("retainCheckpoint", optionalBoolean(body, "retainCheckpoint")) };
 }
 function sessionTreeSummaryChoice(value) {
     const summary = requireRecord(value);
@@ -615,7 +746,7 @@ function requireBoundedId(value, field) {
 function sessionTreeForkRequestFromBody(body) {
     const entryId = requireNonEmptyString(body, "entryId");
     const expectedLeafId = requireNullableString(body, "expectedLeafId");
-    return { entryId, expectedLeafId };
+    return { entryId, expectedLeafId, ...optionalField("retainCheckpoint", optionalBoolean(body, "retainCheckpoint")) };
 }
 function extensionDialogAnswerFromBody(body) {
     const dialogId = requireNonEmptyBoundedString(body["dialogId"], "dialogId", EXTENSION_DIALOG_ID_MAX_LENGTH);
@@ -624,10 +755,10 @@ function extensionDialogAnswerFromBody(body) {
         return { dialogId, value };
     if (typeof value === "string") {
         if (value.length > EXTENSION_DIALOG_INPUT_MAX_LENGTH)
-            throw new Error("value exceeds its length limit");
+            throw new UserFacingError("routing.valueLength", "value exceeds its length limit");
         return { dialogId, value };
     }
-    throw new Error("value must be a boolean or string");
+    throw new UserFacingError("routing.valueType", "value must be a boolean or string");
 }
 function extensionDialogCancelFromBody(body) {
     return { dialogId: requireNonEmptyBoundedString(body["dialogId"], "dialogId", EXTENSION_DIALOG_ID_MAX_LENGTH) };
@@ -648,6 +779,15 @@ function requireString(record, field) {
         throw new Error(`${field} field must be a string`);
     return value;
 }
+function requireBoolean(record, field) {
+    const value = record[field];
+    if (typeof value !== "boolean")
+        throw new Error(`${field} field must be a boolean`);
+    return value;
+}
+function optionalBoolean(record, field) {
+    return record[field] === undefined ? undefined : requireBoolean(record, field);
+}
 function requireNonEmptyString(record, field) {
     const value = requireString(record, field);
     if (value.trim() === "")
@@ -701,8 +841,11 @@ function optionalNumber(value) {
     const parsed = Number(value);
     return Number.isFinite(parsed) ? parsed : undefined;
 }
-function errorMessage(error) {
-    return error instanceof Error ? error.message : String(error);
+function isSessionModelScopeMode(value) {
+    return value === "all" || value === "current";
+}
+function errorMessage(error, t = loadNodeTranslator("server")) {
+    return userFacingErrorMessage(error, t);
 }
 function mutationErrorStatus(error) {
     return isSessionNotFoundError(error) ? 404 : 400;
@@ -711,7 +854,7 @@ function notificationErrorStatus(error) {
     return isSessionNotFoundError(error) ? 404 : 400;
 }
 function isSessionNotFoundError(error) {
-    const message = errorMessage(error);
+    const message = error instanceof Error ? error.message : String(error);
     return message === "Session not found" || message === "Archived session not found" || message === "未找到会话" || message === "未找到已归档会话";
 }
 function isRecord(value) {