@abot-ai/runtime 1.6.0 → 1.7.0

package/dist/src/web-ui/app/controllers/session-controller.js

@@ -27,6 +27,7 @@ export function createSessionController({
   confirmAction = window.confirm.bind(window),
   copyText = (value) => navigator.clipboard.writeText(value),
 }) {
+  let pagination;
   const titleOf = (session) =>
     textOf(session?.displayName || session?.title || session?.id);
   const byId = (sessionId) =>
@@ -34,7 +35,8 @@ export function createSessionController({
   const isPinned = (sessionId) => state.pinnedSessionIds.includes(sessionId);
   const sidebar = createSessionSidebarController({
     state, preferences, selectedEnvironmentId, showToast: shell?.showToast,
-    render: onSidebarChange ?? render, getFilteredSessions: filtered,
+    render: () => { (onSidebarChange ?? render)(); void pagination?.load(); }, getFilteredSessions: filtered,
+    getPageInfo: () => pagination?.info(),
   });
 
   function filtered() {
@@ -51,11 +53,14 @@ export function createSessionController({
   }
 
   function render() {
+    const scrollTop = dom.sessionsList.scrollTop;
     sessionActionsMenu.reset();
     dom.sessionsList.innerHTML = "";
     const sessions = filtered();
-    dom.sessionsCount.textContent = String(sessions.length);
+    dom.sessionsCount.textContent = String(pagination?.info().total ?? sessions.length);
     sidebar.renderSections({ root: dom.sessionsList, sessions, createSessionItem, renderGroups });
+    pagination?.renderFooter();
+    dom.sessionsList.scrollTop = scrollTop;
   }
 
   function createSessionItem(session, sessionIndex) {
@@ -229,6 +234,7 @@ export function createSessionController({
       : [sessionId, ...state.pinnedSessionIds];
     preferences.savePinnedSessions(state.pinnedSessionIds);
     render();
+    void pagination?.load();
   }
 
   async function copyFilename(sessionId) {
@@ -310,6 +316,8 @@ export function createSessionController({
   }
 
   return {
+    setPagination: (value) => { pagination = value; },
+    paginationQuery: sidebar.paginationQuery,
     archiveSession: (sessionId) => sidebar.archiveSession(sessionId),
     applyReadState,
     applyTitle,

package/dist/src/web-ui/app/controllers/session-list-pagination.js

@@ -0,0 +1,71 @@
+import { mergeSessionListReadState } from "../lib/session-read-state.js";
+
+export function createSessionListPagination({ state, dom, client, sessions, selectedEnvironmentId, renderSessions, onSessionListState }) {
+  let revision = 0;
+  let pending = false;
+  let nextCursor = null;
+  let pageInfo = {};
+  let queryKey = "";
+  let errorMessage = "";
+  const query = () => ({ ...sessions.paginationQuery?.(), query: state.sessionQuery || "" });
+  function invalidate() {
+    state.sessionOverview = undefined;
+    revision += 1; pending = false; nextCursor = null; pageInfo = {}; queryKey = ""; errorMessage = "";
+  }
+  function isCurrent(environmentId, version, key) {
+    if (version !== revision) return false;
+    if (environmentId !== selectedEnvironmentId()) return false;
+    return key === JSON.stringify(query());
+  }
+  async function load(more = false) {
+    const input = query();
+    const key = JSON.stringify(input);
+    if (more && (pending || !nextCursor || key !== queryKey)) return state.sessions;
+    if (!more) nextCursor = null;
+    const environmentId = selectedEnvironmentId();
+    const version = ++revision;
+    const cursor = more ? nextCursor : null;
+    pending = true; errorMessage = ""; queryKey = key;
+    onSessionListState({ status: "loading", sessions: state.sessions });
+    renderSessions();
+    try {
+      const payload = await client.listSessions(environmentId, { ...input, cursor });
+      if (!isCurrent(environmentId, version, key)) return [];
+      const incoming = Array.isArray(payload.sessions) ? payload.sessions : [];
+      const merged = more ? [...state.sessions, ...incoming] : incoming;
+      state.sessions = mergeSessionListReadState([...new Map(merged.map((session) => [session.id, session])).values()], state.sessions);
+      nextCursor = payload.nextCursor || null;
+      pageInfo = { total: payload.total, archivedCount: payload.archivedCount };
+      if (payload.overview) state.sessionOverview = payload.overview;
+      onSessionListState({ status: "ready", sessions: state.sessions });
+      return state.sessions;
+    } catch (error) {
+      if (!isCurrent(environmentId, version, key)) return [];
+      errorMessage = error instanceof Error ? error.message : String(error);
+      onSessionListState({ status: "error", sessions: state.sessions, error: errorMessage });
+      return [];
+    } finally {
+      if (version === revision) { pending = false; renderSessions(); }
+    }
+  }
+  function renderFooter() {
+    const root = dom.sessionsList;
+    if (!root?.ownerDocument) return;
+    if (!pending && !nextCursor && !errorMessage) return;
+    const button = root.ownerDocument.createElement("button");
+    button.type = "button";
+    button.className = "session-archive-toggle";
+    button.disabled = pending;
+    button.textContent = pending ? "Loading conversations…" : errorMessage ? "Could not load conversations — retry" : "Load more conversations";
+    button.addEventListener("click", () => void load(Boolean(nextCursor)));
+    root.appendChild(button);
+  }
+  dom.sessionsList?.addEventListener?.("scroll", () => {
+    const root = dom.sessionsList;
+    if (root.scrollHeight - root.scrollTop - root.clientHeight > 100) return;
+    if (!errorMessage) void load(true);
+  }, { passive: true });
+  const controller = { load, invalidate, renderFooter, info: () => pageInfo };
+  sessions.setPagination?.(controller);
+  return controller;
+}

package/dist/src/web-ui/app/controllers/session-sidebar-controller.js

@@ -6,7 +6,7 @@ import { renderSessionSidebarSections } from "../components/session-sidebar-sect
 import { filterSessionsByArchiveState } from "../lib/session-archive-visibility.js";
 
 export function createSessionSidebarController({
-  state, preferences, selectedEnvironmentId = () => "", render, showToast, getFilteredSessions,
+  state, preferences, selectedEnvironmentId = () => "", render, showToast, getFilteredSessions, getPageInfo = () => undefined,
 }) {
   let showingArchived = false;
   let environmentId = selectedEnvironmentId();
@@ -67,8 +67,10 @@ export function createSessionSidebarController({
       return;
     }
     const saved = savedPreferences();
+    const rankedIds = new Set(saved.orderedSessionIds);
+    const unrankedIds = orderedSessions().map((session) => session.id).filter((id) => !rankedIds.has(id));
     saved.orderedSessionIds = moveSidebarSession(
-      orderedSessions().map((session) => session.id), sourceId, targetId, placement,
+      [...unrankedIds, ...saved.orderedSessionIds], sourceId, targetId, placement,
     );
     if (saveSidebar(saved)) render();
   }
@@ -143,7 +145,7 @@ export function createSessionSidebarController({
     const saved = savedPreferences();
     renderSessionSidebarSections({
       ...options,
-      archivedCount: filterSessionsByArchiveState(state.sessions, saved.archivedSessionIds, true).length,
+      archivedCount: getPageInfo()?.archivedCount ?? filterSessionsByArchiveState(state.sessions, saved.archivedSessionIds, true).length,
       showingArchived,
       onToggleArchived: () => {
         showingArchived = !showingArchived;
@@ -155,5 +157,5 @@ export function createSessionSidebarController({
     });
   }
 
-  return { archiveSession, bindItem, renderSections, visibleSessions, isArchiveView: () => showingArchived };
+  return { paginationQuery: () => ({ ...savedPreferences(), archived: showingArchived, pinnedSessionIds: state.pinnedSessionIds }), archiveSession, bindItem, renderSections, visibleSessions, isArchiveView: () => showingArchived };
 }

package/dist/src/web-ui/app/controllers/spark-chat-reading.js

@@ -125,6 +125,7 @@ export function createSparkChatReading({
   documentRoot.addEventListener("visibilitychange", scheduleRead);
   viewport.addEventListener("focus", scheduleRead);
   return {
+    preservePosition() { follow = false; top = dom.messagesList.scrollTop; },
     afterRender,
     onLayoutChange() {
       if (!isOpen()) return;

package/dist/src/web-ui/app/controllers/spark-chat-sync.js

@@ -1,15 +1,20 @@
 import { normalizeConversationMessage } from "./conversation-session-controller.js";
 import { rememberRequestLifecycle, sameConversationMessage } from "../lib/request-lifecycle-view.js";
 
-export function mergeSparkSnapshotMessages(snapshot, current) {
+export function mergeSparkSnapshotMessages(snapshot, current, hasNewer = false) {
   const canonical = (snapshot.messages || []).map(normalizeConversationMessage);
+  if (hasNewer) return current.map((message) => canonical.find((entry) => sameConversationMessage(message, entry)) || message);
   const activeRequestIds = new Set((snapshot.requests || []).filter((request) => request.status === "streaming").map((request) => request.requestId));
   const unsettled = current.filter((message) => {
     if (!message.streaming) return false;
     if (activeRequestIds.has(message.requestId)) return true;
     return !canonical.some((entry) => sameConversationMessage(message, entry));
   });
-  return [...canonical, ...unsettled];
+  if (snapshot.newerCursor === undefined) return [...canonical, ...unsettled];
+  const settled = current.filter((message) => !message.streaming);
+  const firstIndex = canonical.length ? settled.findIndex((message) => sameConversationMessage(message, canonical[0])) : -1;
+  const older = firstIndex >= 0 ? settled.slice(0, firstIndex) : [];
+  return [...older, ...canonical, ...unsettled];
 }
 
 function needsRequestLifecycleHydration(snapshot, state) {
@@ -64,6 +69,18 @@ export function createSparkChatSync({
     if (environmentId !== getEnvironmentId()) return false;
     return readRevision === revision;
   }
+  function canRetainTargetWindow(sessionId) {
+    if (!initialized || state.currentSessionId !== sessionId) return false;
+    return conversation.session.history?.hasNewer() === true;
+  }
+  async function hydrateConversation(result) {
+    if (!canRetainTargetWindow(result.sessionId)) {
+      await conversation.session.openSession(result.sessionId, { snapshot: { ...result.snapshot, readState: result.readState } });
+      return true;
+    }
+    state.messages = mergeSparkSnapshotMessages(result.snapshot, state.messages, true);
+    return conversation.session.rehydrateRequests(result.snapshot.requests || []);
+  }
   async function drain() {
     if (!canRefresh()) return;
     queued = false;
@@ -98,13 +115,15 @@ export function createSparkChatSync({
       onReadState(result.readState);
       const snapshot = result.snapshot;
       if (shouldHydrateSparkConversation(initialized, rehydrate, snapshot, state)) {
-        initialized = false; hydrating = true;
-        await conversation.session.openSession(result.sessionId);
+        hydrating = true;
+        const restored = await hydrateConversation(result);
         hydrating = false;
+        if (!restored) return;
         if (!isCurrentRead(environmentId, readRevision)) return;
         initialized = true;
       } else {
-        state.messages = mergeSparkSnapshotMessages(snapshot, state.messages);
+        conversation.session.history?.refresh(snapshot);
+        state.messages = mergeSparkSnapshotMessages(snapshot, state.messages, conversation.session.history?.hasNewer());
         for (const request of snapshot.requests || []) rememberRequestLifecycle(state, request.lifecycle);
         for (const message of state.messages) {
           if (message.role !== "assistant" || !message.requestId) continue;

package/dist/src/web-ui/app/controllers/workspace-route-controller.js

@@ -37,7 +37,7 @@ export function createWorkspaceRouteController({
       session: getSessionId(),
       automationRun: automations?.chatRunId() || "",
       category: configurationCategoryForWorkspace(shell.activeWorkspace()),
-      tab: shell.activeOperationsTab(),
+      tab: shell.activeWorkspace() === "plugins" ? configuration.activePluginTab?.() || "installed" : shell.activeOperationsTab(),
       job: schedules.selectedJobId(),
       automation: automations?.selectedAutomationId() || "",
       run: automations?.selectedRunId() || "",
@@ -136,24 +136,24 @@ export function createWorkspaceRouteController({
       return true;
     }
     if (route.session === getSessionId()) return true;
-    const sessions = await loadSessions();
+    await loadSessions();
     if (!routeActivationIsCurrent()) return false;
     if (environmentId !== getEnvironmentId()) return false;
-    if (!routeSessionIsListed(route, sessions)) {
-      shell.showToast(
-        "This conversation is unavailable in the selected environment.",
-        "failed",
-      );
+    let routeCommitted = false;
+    try {
+      await openSession(route.session, {
+        isRouteCurrent: routeActivationIsCurrent,
+        commitRouteNavigation: () => {
+          routeCommitted = commitLinkedConversationRoute();
+          return routeCommitted;
+        },
+      });
+    } catch (error) {
+      if (error.code !== "session_not_found") throw error;
+      if (!routeActivationIsCurrent()) return false;
+      shell.showToast("This conversation is unavailable in the selected environment.", "failed");
       return false;
     }
-    let routeCommitted = false;
-    await openSession(route.session, {
-      isRouteCurrent: routeActivationIsCurrent,
-      commitRouteNavigation: () => {
-        routeCommitted = commitLinkedConversationRoute();
-        return routeCommitted;
-      },
-    });
     if (!routeCommitted) return false;
     if (!routeActivationIsCurrent()) return false;
     if (environmentId !== getEnvironmentId()) return false;
@@ -223,6 +223,9 @@ export function createWorkspaceRouteController({
     if (route.workspace === "config") {
       shell.activateOperationsTab(route.tab || "runtime");
     }
+    if (route.workspace === "plugins") {
+      return configuration.openPluginRoute?.(route) ?? true;
+    }
     if (route.workspace === "schedules") {
       return await schedules.openJob(route.job || "");
     }
@@ -251,6 +254,9 @@ export function createWorkspaceRouteController({
         route.job = "";
         route.automation = "";
         route.run = "";
+        route.pluginSource = "";
+        route.pluginRef = "";
+        route.pluginPath = "";
       }
       await applyRoute(route, { initial: true });
     } catch (error) {
@@ -346,10 +352,6 @@ function routeChangesEnvironment(route, selectedEnvironment) {
   return route.environment !== selectedEnvironment;
 }
 
-function routeSessionIsListed(route, sessions) {
-  return sessions.some((session) => session.id === route.session);
-}
-
 function initialRouteWasSuperseded(initial, pendingHistory) {
   if (!initial) return false;
   return Boolean(pendingHistory);

package/dist/src/web-ui/app/dashboard-feature.js

@@ -34,7 +34,7 @@ export function createDashboardFeature({
     render: (snapshot) => {
       const sessions = filterSessionsByArchiveState(snapshot.sessions,
         preferences?.loadSessionSidebar?.(selectedEnvironmentId())?.archivedSessionIds);
-      view?.render({ ...snapshot, sessions, composerAvailable: isComposerAvailable() });
+      view?.render({ ...snapshot, sessions, sessionOverview: state.sessionOverview, composerAvailable: isComposerAvailable() });
     },
   });
   view = createDashboardWorkspace({
@@ -52,7 +52,7 @@ export function createDashboardFeature({
       openConversation: async (sessionId, requestId) => {
         if (!shell.activateWorkspace("chat")) return;
         try {
-          await openSession(sessionId);
+          await openSession(sessionId, { page: { targetRequestId: requestId } });
           if (state.currentSessionId !== sessionId) return;
           if (!requestId) return;
           requestAnimationFrame(() => {

package/dist/src/web-ui/app/index.html

@@ -25,7 +25,10 @@
     </section>
     <div id="app" class="app-shell" data-startup-pending aria-busy="true" inert>
       <nav class="workspace-rail" aria-label="Workspace navigation">
-        <div class="workspace-brand"><img src="/favicon.svg" width="28" height="28" alt="ABot" /></div>
+        <div class="workspace-brand">
+          <img src="/favicon.svg" width="28" height="28" alt="ABot" />
+          <a class="product-site-link" href="https://abot-ai.com/" target="_blank" rel="noopener noreferrer" aria-label="abot-ai.com — ABot website (opens in a new tab)">abot-ai.com <span aria-hidden="true">↗</span></a>
+        </div>
         <button
           id="sessionsToggleButton"
           class="rail-button rail-history-button"
@@ -314,6 +317,7 @@
           id="messagesList"
           class="messages-list"
           aria-label="Conversation messages"
+          tabindex="0"
         ></section>
         <div
           id="messageStatusRegion"
@@ -639,7 +643,7 @@
       >
         <header class="workspace-page-header config-workspace-header">
           <div class="workspace-page-heading config-workspace-heading">
-            <p class="eyebrow">Runtime workspace</p>
+            <a class="product-site-link" href="https://abot-ai.com/" target="_blank" rel="noopener noreferrer" aria-label="abot-ai.com — ABot website (opens in a new tab)">abot-ai.com <span aria-hidden="true">↗</span></a>
             <h2 id="configWorkspaceTitle">System</h2>
           </div>
           <div class="toolbar-actions">

package/dist/src/web-ui/app/lib/history-page-messages.js

@@ -0,0 +1,49 @@
+import { isApprovalPresentation, mergeConversationMessage, sameConversationMessage } from "./request-lifecycle-view.js";
+
+function isRequestResponse(message) {
+  if (message.role !== "assistant") return false;
+  if (!message.requestId) return false;
+  return !isApprovalPresentation(message);
+}
+
+function indexConversationMessages(messages) {
+  const byId = new Map(messages.map((message) => [message.id, message]));
+  const byRequest = new Map();
+  for (const message of messages) {
+    if (!isRequestResponse(message)) continue;
+    const candidates = byRequest.get(message.requestId) || [];
+    candidates.push(message);
+    byRequest.set(message.requestId, candidates);
+  }
+  return (incoming) => {
+    if (!incoming) return undefined;
+    const exact = byId.get(incoming.id);
+    if (exact) return exact;
+    return byRequest.get(incoming.requestId)?.find((message) => sameConversationMessage(message, incoming));
+  };
+}
+
+/** Keep the contiguous loaded history before rows received from the live stream. */
+export function mergeHistoryPage(state, incoming, direction, windowEnd) {
+  const current = state.messages;
+  const findCurrent = indexConversationMessages(current);
+  const replaced = new Set();
+  const page = incoming.map((message) => {
+    const existing = findCurrent(message);
+    if (!existing) return message;
+    replaced.add(existing);
+    return mergeConversationMessage(existing, message);
+  });
+  const retained = (messages) => messages.filter((message) => !replaced.has(message));
+  if (direction === "older") {
+    state.messages = [...page, ...retained(current)];
+  } else {
+    const end = current.indexOf(findCurrent(windowEnd));
+    const split = end < 0 ? current.length : end + 1;
+    state.messages = [...retained(current.slice(0, split)), ...page, ...retained(current.slice(split))];
+  }
+  for (const message of state.messages) {
+    if (!isRequestResponse(message)) continue;
+    state.requestMessages?.set(message.requestId, message.id);
+  }
+}

package/dist/src/web-ui/app/lib/request-lifecycle-view.js

@@ -71,6 +71,14 @@ export function sameConversationMessage(existing, incoming) {
   return !existing.persistedMessageId || !incoming.persistedMessageId;
 }
 
+export function mergeConversationMessage(existing, incoming) {
+  return {
+    ...existing, ...incoming,
+    text: incoming.text || existing.text,
+    thinkingText: incoming.thinkingText || existing.thinkingText,
+  };
+}
+
 export function removeStreamingPlaceholder(state, requestId) {
   state.messages = state.messages.filter((message) => {
     if (message.requestId !== requestId || message.role !== "assistant")

package/dist/src/web-ui/app/lib/workspace-route.d.ts

@@ -8,6 +8,9 @@ export interface WorkspaceRoute {
   job: string;
   automation: string;
   run: string;
+  pluginSource?: string;
+  pluginRef?: string;
+  pluginPath?: string;
 }
 
 export function readWorkspaceRoute(

package/dist/src/web-ui/app/lib/workspace-route.js

@@ -39,6 +39,7 @@ export function readWorkspaceRoute(location) {
     job: routeParameter(parameters, "job"),
     automation: routeParameter(parameters, "automation"),
     run: routeParameter(parameters, "run"),
+    ...(workspace === "plugins" && parameters.has("pluginSource") ? { pluginSource: routeParameter(parameters, "pluginSource"), pluginRef: routeParameter(parameters, "pluginRef"), pluginPath: routeParameter(parameters, "pluginPath") } : {}),
   };
 }
 
@@ -53,6 +54,9 @@ export function workspaceRouteUrl(route) {
     parameters.set("automationRun", route.automationRun);
   else if (workspace === "chat" && route.session)
     parameters.set("session", route.session);
+  if (workspace === "plugins") {
+    if (route.tab === "discover") parameters.set("tab", "discover");
+  }
   if (workspace === "config") {
     if (route.tab) parameters.set("tab", route.tab);
   }

package/dist/src/web-ui/app/passive-learning-feature.js

@@ -39,7 +39,6 @@ export function createPassiveLearningFeature({
   home = createPassiveLearningHome({
     actions,
     openLearning,
-    openComputerAccess,
     openSetup: () => {
       if (openLearning() === false) return;
       if (learningRoot) selectLearningView(learningRoot, "settings");

package/dist/src/web-ui/app/runtime-onboarding-feature.js

@@ -17,6 +17,7 @@ export function createRuntimeOnboardingFeature({
   const usesBridgeBackend = () => state.config?.backend === "bridge";
   let selectedGuide = null;
   let bindings = {};
+  shell?.runtimeAvailabilityChanged(state.runtimeAvailability);
 
   function createConfiguredGuide() {
     const common = {
@@ -52,6 +53,7 @@ export function createRuntimeOnboardingFeature({
       loadHostConnection: () => runtimeClient.getSystemHostConnection(),
       connectLocalHost: () => runtimeClient.connectLocalSystemHost(),
       createHostPairing: () => runtimeClient.createSystemHostPairing(),
+      requestHostStoreConnection: () => runtimeClient.requestSystemHostStoreConnection(),
       requestHostPermissions: (input) => runtimeClient.requestSystemHostPermissions(input),
       downloadHostSetup: (platform) =>
         runtimeClient.downloadSystemHostSetup(platform),
@@ -87,6 +89,7 @@ export function createRuntimeOnboardingFeature({
   };
   const controller = createRuntimeOnboardingController({
     state,
+    getEnvironmentId: selectedEnvironmentId,
     guide,
     reloadModels: () =>
       usesBridgeBackend() ? reloadCatalog() : reloadModels(),

package/dist/src/web-ui/app/schedules-feature.js

@@ -32,7 +32,7 @@ export function createSchedulesFeature({
       if (!shell.activateWorkspace("chat")) return;
       if (!sessionId) return;
       try {
-        await openSession(sessionId);
+        await openSession(sessionId, { page: { targetRequestId: requestId } });
         if (!requestId) return;
         requestAnimationFrame(() => {
           const messages = [

package/dist/src/web-ui/app/services/runtime-web-client/configuration.js

@@ -1,8 +1,10 @@
+import { createPluginConfigurationRequests } from "./plugin-configuration.js";
 /** Configuration transport; credentials are sent once and never retained here. */
 export function createConfigurationRequests({ requestApi, environmentQuery }) {
   const scoped = (path, environmentId) =>
     path + "?environment=" + environmentQuery(environmentId);
   return {
+    ...createPluginConfigurationRequests({ requestApi, environmentQuery }),
     getRuntimeSetup(environmentId) {
       return requestApi(scoped("/runtime/setup", environmentId));
     },
@@ -42,6 +44,24 @@ export function createConfigurationRequests({ requestApi, environmentQuery }) {
         body: JSON.stringify(input),
       });
     },
+    inspectRuntimePlugin(input, environmentId) {
+      return requestApi(scoped("/runtime/plugins/inspect", environmentId), {
+        method: "POST",
+        body: JSON.stringify(input),
+      });
+    },
+    installRuntimePlugin(input, environmentId) {
+      return requestApi(scoped("/runtime/plugins/install", environmentId), {
+        method: "POST",
+        body: JSON.stringify(input),
+      });
+    },
+    removeRuntimePlugin(input, environmentId) {
+      return requestApi(scoped("/runtime/plugins/remove", environmentId), {
+        method: "POST",
+        body: JSON.stringify(input),
+      });
+    },
     applyRuntimeConfiguration(environmentId) {
       return requestApi(scoped("/runtime/config/apply", environmentId), {
         method: "POST",

package/dist/src/web-ui/app/services/runtime-web-client/plugin-configuration.js

@@ -0,0 +1,19 @@
+/** Plugin configuration transport never retains entered credentials. */
+export function createPluginConfigurationRequests({
+  requestApi,
+  environmentQuery,
+}) {
+  const path = (pluginId, environmentId) =>
+    `/runtime/plugins/configuration/${encodeURIComponent(pluginId)}?environment=${environmentQuery(environmentId)}`;
+  return {
+    getPluginConfiguration(pluginId, environmentId) {
+      return requestApi(path(pluginId, environmentId));
+    },
+    savePluginConfiguration(pluginId, input, environmentId) {
+      return requestApi(path(pluginId, environmentId), {
+        method: "PUT",
+        body: JSON.stringify(input),
+      });
+    },
+  };
+}

package/dist/src/web-ui/app/services/runtime-web-client/spark-chat.js

@@ -1,16 +1,16 @@
 export function createSparkChatRequests({ requestApi, getEnvironmentId, getConfig }) {
   const supportsSparkChat = () => getConfig()?.backend === "runtime";
-  function path(environmentId) {
+  function path(environmentId, paged = false) {
     if (!supportsSparkChat()) throw new Error("SPARK chat is unavailable with this backend.");
-    return `/runtime/spark/chat?${new URLSearchParams({ environment: environmentId })}`;
+    return `/runtime/spark/chat?${new URLSearchParams({ environment: environmentId, ...(paged ? { page: "1" } : {}) })}`;
   }
   return {
     supportsSparkChat,
     loadSparkChat(environmentId = getEnvironmentId()) {
-      return requestApi(path(environmentId));
+      return requestApi(path(environmentId, true));
     },
     configureSparkChat(input, environmentId = getEnvironmentId()) {
-      return requestApi(path(environmentId), {
+      return requestApi(path(environmentId, true), {
         method: "PUT", body: JSON.stringify(input),
       });
     },

package/dist/src/web-ui/app/services/runtime-web-client/system-host.js

@@ -18,6 +18,8 @@ export function createSystemHostRequests({ requestApi, getConfig, getEnvironment
       requestSystemHost("/permissions", { method: "POST", body: JSON.stringify(input) }),
     connectLocalSystemHost: () =>
       requestSystemHost("/connect-local", { method: "POST", body: "{}" }),
+    requestSystemHostStoreConnection: () =>
+      requestSystemHost("/store-connect", { method: "POST", body: "{}" }),
     downloadSystemHostSetup: (platform, options = {}) =>
       requestSystemHost("/setup", {
         method: "POST",

package/dist/src/web-ui/app/services/runtime-web-client.d.ts

@@ -101,6 +101,7 @@ export declare function createRuntimeWebClient(options: {
   getSystemHostConnection(): Promise<Record<string, unknown>>;
   requestSystemHostPermissions(input: Record<string, unknown>): Promise<Record<string, unknown>>;
   connectLocalSystemHost(): Promise<Record<string, unknown>>;
+  requestSystemHostStoreConnection(): Promise<Record<string, unknown>>;
   downloadSystemHostSetup(
     platform: "windows" | "macos" | "linux",
     options?: { purpose?: "learning" },
@@ -128,6 +129,9 @@ export declare function createRuntimeWebClient(options: {
     environmentId?: string,
   ): Promise<Record<string, unknown>>;
   getRuntimePlugins(environmentId?: string): Promise<Record<string, unknown>>;
+  inspectRuntimePlugin(input: Record<string, unknown>, environmentId?: string): Promise<Record<string, unknown>>;
+  installRuntimePlugin(input: Record<string, unknown>, environmentId?: string): Promise<Record<string, unknown>>;
+  removeRuntimePlugin(input: { pluginId: string }, environmentId?: string): Promise<Record<string, unknown>>;
   setRuntimePlugin(
     input: { pluginId: string; capabilityId?: string; enabled: boolean },
     environmentId?: string,
@@ -217,10 +221,11 @@ export declare function createRuntimeWebClient(options: {
     file: Blob;
   }): Promise<Record<string, unknown>>;
   loadWebConfig(): Promise<Record<string, unknown>>;
-  listSessions(environmentId?: string): Promise<Record<string, unknown>>;
+  listSessions(environmentId?: string, page?: Record<string, unknown>): Promise<Record<string, unknown>>;
   loadSession(
     sessionId: string,
     environmentId?: string,
+    page?: Record<string, unknown>,
   ): Promise<Record<string, unknown>>;
   markSessionRead(options: {
     sessionId: string;

package/dist/src/web-ui/app/services/runtime-web-client.js

@@ -168,17 +168,26 @@ export function createRuntimeWebClient({
       return request("/web-config", "Web configuration");
     },
 
-    listSessions(environmentId = getEnvironmentId()) {
+    listSessions(environmentId = getEnvironmentId(), page) {
+      if (page && getConfig()?.backend === "runtime") return requestApi(
+        `/chat/sessions/page?environment=${environmentQuery(environmentId)}`,
+        { method: "POST", body: JSON.stringify(page) },
+      );
       return requestApi(
         `/chat/sessions?environment=${environmentQuery(environmentId)}`,
       );
     },
 
-    loadSession(sessionId, environmentId = getEnvironmentId()) {
+    loadSession(sessionId, environmentId = getEnvironmentId(), page = {}) {
+      const query = new URLSearchParams({ environment: environmentId });
+      if (getConfig()?.backend === "runtime") {
+        query.set("page", "1");
+        for (const [key, value] of Object.entries(page)) if (value != null) query.set(key, String(value));
+      }
       return requestApi(
         `/chat/sessions/${encodeURIComponent(
           sessionId,
-        )}/messages?environment=${environmentQuery(environmentId)}`,
+        )}/messages?${query}`,
       );
     },