feat(web): hide empty sessions from the session list (#1166)

* chore(web): remove the /sessions slash command

* feat(web): hide empty sessions from the session list

Add an optional exclude_empty parameter to the session list API; the web client passes it so unused "New Session" entries are hidden by default, with pagination and has_more computed on the filtered set.

* fix(protocol): add exclude_empty to the session list query schema

Keep the shared protocol schema in sync with the server route so clients using the protocol type see the new parameter.

* fix(protocol): keep exclude_empty off the child session list schema

listSessionChildrenQuerySchema aliased the main list schema, so it inherited exclude_empty even though the /sessions/{id}/children route does not filter by it. Split it so generated clients are not misled.

Author: wbxl2000

.changeset/add-session-list-exclude-empty.md

@@ -0,0 +1,5 @@
+---
+"@moonshot-ai/kimi-code": patch
+---
+
+Add an optional exclude_empty parameter to the session list API to omit sessions that have no messages.

.changeset/web-hide-empty-sessions.md

@@ -0,0 +1,5 @@
+---
+"@moonshot-ai/kimi-code": patch
+---
+
+Hide unused "New Session" entries from the web session list by default.

.changeset/web-remove-sessions-command.md

@@ -0,0 +1,5 @@
+---
+"@moonshot-ai/kimi-code": patch
+---
+
+Remove the /sessions slash command from the web UI; the sidebar already covers session browsing.

apps/kimi-web/src/App.vue

@@ -16,7 +16,6 @@ import ProviderManager from './components/settings/ProviderManager.vue';
 import LoginDialog from './components/dialogs/LoginDialog.vue';
 import NewSessionDialog from './components/dialogs/NewSessionDialog.vue';
 import SettingsDialog from './components/settings/SettingsDialog.vue';
-import SessionsDialog from './components/dialogs/SessionsDialog.vue';
 import AddWorkspaceDialog from './components/dialogs/AddWorkspaceDialog.vue';
 import StatusPanel from './components/chat/StatusPanel.vue';
 import WarningToasts from './components/WarningToasts.vue';
@@ -229,7 +228,6 @@ const showModelPicker = ref(false);
 const showProviders = ref(false);
 const showLogin = ref(false);
 const showNewSession = ref(false);
-const showSessions = ref(false);
 const showAddWorkspace = ref(false);
 const showStatusPanel = ref(false);
 const showSettings = ref(false);
@@ -249,7 +247,6 @@ const anyOverlayOpen = computed<boolean>(() =>
   showProviders.value ||
   showLogin.value ||
   showNewSession.value ||
-  showSessions.value ||
   showAddWorkspace.value ||
   showStatusPanel.value ||
   showSettings.value ||
@@ -400,9 +397,6 @@ function handleCommand(cmd: string): void {
     case '/clear':
       handleCreateSession();
       break;
-    case '/sessions':
-      showSessions.value = true;
-      break;
     case '/fork':
       void client.forkSession();
       break;
@@ -868,17 +862,6 @@ function openPr(url: string): void {
       @close="showNewSession = false"
     />
 
-    <!-- Sessions browser overlay (/sessions) — client-side list, click to switch -->
-    <SessionsDialog
-      v-if="showSessions"
-      :sessions="client.sessions.value"
-      :workspace-groups="client.workspaceGroups.value"
-      :attention-by-session="client.attentionBySession.value"
-      :active-id="client.activeSessionId.value"
-      @select="(id) => { void client.selectSession(id); showSessions = false; }"
-      @close="showSessions = false"
-    />
-
     <!-- Status panel overlay (/status) — renders current client state, no daemon call -->
     <StatusPanel
       v-if="showStatusPanel"

apps/kimi-web/src/api/daemon/client.ts

@@ -286,14 +286,20 @@ export class DaemonKimiWebApi implements KimiWebApi {
   // -------------------------------------------------------------------------
 
   async listSessions(
-    input?: PageRequest & { status?: AppSessionStatus; workspaceId?: string; includeArchive?: boolean },
+    input?: PageRequest & {
+      status?: AppSessionStatus;
+      workspaceId?: string;
+      includeArchive?: boolean;
+      excludeEmpty?: boolean;
+    },
   ): Promise<Page<AppSession>> {
     const query: Record<string, string | number | boolean | undefined> = {
       before_id: input?.beforeId,
       after_id: input?.afterId,
       page_size: input?.pageSize,
       status: input?.status ? toWireSessionStatus(input.status) : undefined,
       include_archive: input?.includeArchive,
+      exclude_empty: input?.excludeEmpty,
       // PRESUMED — daemon supports ?workspace_id= once the registry ships; it
       // ignores unknown query params until then, so this is safe to always send.
       workspace_id: input?.workspaceId,

apps/kimi-web/src/api/types.ts

@@ -605,7 +605,7 @@ export interface AppSessionWarning {
 export interface KimiWebApi {
   getHealth(): Promise<{ status: 'ok'; uptimeSec: number }>;
   getMeta(): Promise<{ serverVersion: string; serverId: string; startedAt: string; capabilities: Record<string, boolean>; openInApps: string[] }>;
-  listSessions(input?: PageRequest & { status?: AppSessionStatus; workspaceId?: string; includeArchive?: boolean }): Promise<Page<AppSession>>;
+  listSessions(input?: PageRequest & { status?: AppSessionStatus; workspaceId?: string; includeArchive?: boolean; excludeEmpty?: boolean }): Promise<Page<AppSession>>;
   createSession(input: { title?: string; cwd?: string; model?: string; workspaceId?: string }): Promise<AppSession>;
   /** Fetch one session by id (deep links beyond the first listSessions page). */
   getSession(sessionId: string): Promise<AppSession>;