@abot-ai/runtime 1.3.0 → 1.4.0

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

@@ -0,0 +1,278 @@
+function errorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+
+export function createProjectsController({
+  client,
+  getEnvironmentId,
+  getConversationRevision,
+  prepareConversation,
+  openSession,
+  loadSessions,
+  onChange,
+  notify,
+  onSessionCreated = () => {},
+}) {
+  let revision = 0;
+  let currentEnvironment = getEnvironmentId();
+  let browseRevision = 0;
+  let listRevision = 0;
+  let activationRevision = 0;
+  let state = {
+    projects: [],
+    loading: false,
+    error: "",
+    draft: null,
+    busyProjectId: "",
+  };
+  const snapshot = () => state;
+  const publish = () => onChange(snapshot());
+  const isCurrentEnvironment = (environmentId, token) =>
+    environmentId === getEnvironmentId() && token === revision;
+  const hasCurrentDraft = (environmentId, token, draft) =>
+    isCurrentEnvironment(environmentId, token) && state.draft === draft;
+
+  function canApplyProjectList(environmentId, token, listToken) {
+    if (!isCurrentEnvironment(environmentId, token)) return false;
+    return listToken === listRevision;
+  }
+
+  function canApplyFolderListing(environmentId, token, draft) {
+    if (state.draft !== draft) return false;
+    if (token !== browseRevision) return false;
+    if (!draft.pickerOpen) return false;
+    return environmentId === getEnvironmentId();
+  }
+
+  function canEditProjectDraft(draft) {
+    if (!draft) return false;
+    return !draft.saving;
+  }
+
+  function canCreateProject(draft) {
+    if (!canEditProjectDraft(draft)) return false;
+    if (draft.pickerOpen) return false;
+    return !draft.loading;
+  }
+
+  function canBrowseProjectFolders(draft) {
+    if (!canEditProjectDraft(draft)) return false;
+    return draft.pickerOpen;
+  }
+
+  function canSelectProjectFolder(draft) {
+    if (!canBrowseProjectFolders(draft)) return false;
+    if (draft.loading) return false;
+    if (draft.error) return false;
+    return Boolean(draft.listing?.directory);
+  }
+
+  function isProjectDraftField(field) {
+    return ["name", "directory"].includes(field);
+  }
+
+  async function load() {
+    const environmentId = getEnvironmentId();
+    currentEnvironment = environmentId;
+    const token = revision;
+    const listToken = ++listRevision;
+    state = { ...state, loading: true, error: "" };
+    publish();
+    if (!client.supportsProjects()) {
+      state = { ...state, projects: [], loading: false };
+      publish();
+      return;
+    }
+    try {
+      const result = await client.listProjects(environmentId);
+      if (!canApplyProjectList(environmentId, token, listToken)) return;
+      state = { ...state, projects: result.projects ?? [], loading: false };
+    } catch (error) {
+      if (!canApplyProjectList(environmentId, token, listToken)) return;
+      state = { ...state, loading: false, error: errorMessage(error) };
+    }
+    publish();
+  }
+
+  function closeCreate() {
+    activationRevision += 1;
+    browseRevision += 1;
+    state = { ...state, draft: null };
+    publish();
+    return true;
+  }
+
+  async function browse(directory = "", cursor = "") {
+    const draft = state.draft;
+    if (!canBrowseProjectFolders(draft)) return;
+    const token = ++browseRevision;
+    const environmentId = getEnvironmentId();
+    draft.loading = true;
+    draft.error = "";
+    if (!cursor) draft.listing = null;
+    publish();
+    try {
+      const result = await client.browseProjectFolders(
+        directory,
+        cursor,
+        environmentId,
+      );
+      if (!canApplyFolderListing(environmentId, token, draft)) return;
+      const entries = cursor
+        ? [...(draft.listing?.entries ?? []), ...result.entries]
+        : result.entries;
+      draft.listing = { ...result, entries };
+    } catch (error) {
+      if (!canApplyFolderListing(environmentId, token, draft)) return;
+      draft.error = errorMessage(error);
+    }
+    draft.loading = false;
+    publish();
+  }
+
+  function openFolderPicker() {
+    const draft = state.draft;
+    if (!canEditProjectDraft(draft)) return Promise.resolve();
+    draft.pickerOpen = true;
+    return browse(draft.directory);
+  }
+
+  function cancelFolderPicker() {
+    const draft = state.draft;
+    if (!canEditProjectDraft(draft)) return;
+    browseRevision += 1;
+    draft.pickerOpen = false;
+    draft.loading = false;
+    draft.listing = null;
+    draft.error = "";
+    publish();
+  }
+
+  function selectFolder() {
+    const draft = state.draft;
+    if (!canSelectProjectFolder(draft)) return;
+    draft.directory = draft.listing.directory;
+    cancelFolderPicker();
+  }
+
+  function openCreate() {
+    activationRevision += 1;
+    state = {
+      ...state,
+      draft: {
+        name: "",
+        directory: "",
+        pickerOpen: false,
+        listing: null,
+        loading: false,
+        saving: false,
+        error: "",
+      },
+    };
+    publish();
+  }
+
+  function updateDraft(field, value) {
+    if (!canEditProjectDraft(state.draft)) return;
+    if (!isProjectDraftField(field)) return;
+    state.draft[field] = value;
+    if (field !== "directory") return;
+    cancelFolderPicker();
+  }
+
+  async function create() {
+    const draft = state.draft;
+    if (!canCreateProject(draft)) return;
+    const environmentId = getEnvironmentId();
+    const token = revision;
+    draft.saving = true;
+    draft.error = "";
+    publish();
+    try {
+      const result = await client.createProject(
+        { name: draft.name.trim(), directory: draft.directory.trim() },
+        environmentId,
+      );
+      if (!hasCurrentDraft(environmentId, token, draft)) return;
+      const project = result.project;
+      listRevision += 1;
+      state.loading = false;
+      state.projects = [
+        ...state.projects.filter((entry) => entry.id !== project.id),
+        project,
+      ];
+      draft.saving = false;
+      closeCreate();
+      await newConversation(project.id);
+    } catch (error) {
+      if (!hasCurrentDraft(environmentId, token, draft)) return;
+      draft.saving = false;
+      draft.error = errorMessage(error);
+      publish();
+    }
+  }
+
+  async function newConversation(projectId) {
+    if (state.busyProjectId) return;
+    if (!prepareConversation()) return;
+    const environmentId = getEnvironmentId();
+    const token = revision;
+    const conversationRevision = getConversationRevision();
+    const activationToken = ++activationRevision;
+    state = { ...state, busyProjectId: projectId };
+    publish();
+    try {
+      const result = await client.createProjectSession(
+        projectId,
+        environmentId,
+      );
+      onSessionCreated(result.sessionId);
+      if (!isCurrentEnvironment(environmentId, token)) return;
+      await loadSessions();
+      if (!isCurrentEnvironment(environmentId, token)) return;
+      if (activationToken !== activationRevision) return;
+      if (getConversationRevision() !== conversationRevision) return;
+      await openSession(result.sessionId);
+    } catch (error) {
+      if (isCurrentEnvironment(environmentId, token))
+        notify(errorMessage(error), "failed");
+    } finally {
+      if (isCurrentEnvironment(environmentId, token)) {
+        state = { ...state, busyProjectId: "" };
+        publish();
+      }
+    }
+  }
+
+  function environmentChanged() {
+    if (currentEnvironment === getEnvironmentId()) return Promise.resolve();
+    currentEnvironment = getEnvironmentId();
+    revision += 1;
+    listRevision += 1;
+    browseRevision += 1;
+    state = {
+      projects: [],
+      loading: false,
+      error: "",
+      draft: null,
+      busyProjectId: "",
+    };
+    publish();
+    return load();
+  }
+
+  return {
+    snapshot,
+    load,
+    environmentChanged,
+    openCreate,
+    closeCreate,
+    updateDraft,
+    openFolderPicker,
+    cancelFolderPicker,
+    selectFolder,
+    browse,
+    create,
+    newConversation,
+  };
+}

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

@@ -318,6 +318,9 @@ export function createRealtimeEventController({
         tone,
         tool: textOf(message.tool),
         approvalId: textOf(message.approvalId),
+        recommendedToolPermissionMode: textOf(
+          message.recommendedToolPermissionMode,
+        ),
         ...(webSources ? { webSources } : {}),
         ...(toolActivity ? { toolActivity } : {}),
         payload: {

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

@@ -1,18 +1,18 @@
 import { textOf } from "../lib/text-format.js";
 
-const SETUP_MESSAGE =
-  "Configure a provider and model, then restart the local services before starting a chat.";
+const SETUP_MESSAGE = "Connect a provider and model to start chatting.";
 const CHECKING_MESSAGE =
   "Checking model availability. Wait for the catalog refresh to finish.";
 const ERROR_MESSAGE =
-  "ABot could not check the model catalog. Verify the local services, then try again.";
+  "ABot could not check the model catalog. Check your connection, then try again.";
 
-function setupRequired(message = SETUP_MESSAGE) {
+function setupRequired(message = SETUP_MESSAGE, recovery) {
   return {
     status: "setup_required",
     code: "runtime_configuration_required",
     message: textOf(message, SETUP_MESSAGE),
     showGuide: true,
+    ...(recovery === "configuration" ? { recovery } : {}),
   };
 }
 
@@ -58,6 +58,9 @@ export function createRuntimeOnboardingController({
     state.runtimeAvailability = {
       status: "checking",
       showGuide: guideWasVisible(state.runtimeAvailability),
+      ...(state.runtimeAvailability?.recovery === "configuration"
+        ? { recovery: "configuration" }
+        : {}),
     };
     render();
     onStateChange();
@@ -70,7 +73,7 @@ export function createRuntimeOnboardingController({
     const ready = availability?.status === "ready" && profiles.length > 0;
     state.runtimeAvailability = ready
       ? { status: "ready" }
-      : setupRequired(availability?.message);
+      : setupRequired(availability?.message, availability?.recovery);
     render();
     onStateChange();
     if (ready && wasVisible) {
@@ -79,7 +82,11 @@ export function createRuntimeOnboardingController({
   }
 
   function catalogUnavailable(error) {
-    state.runtimeAvailability = catalogError(error);
+    const recovery = state.runtimeAvailability?.recovery;
+    state.runtimeAvailability = {
+      ...catalogError(error),
+      ...(recovery === "configuration" ? { recovery } : {}),
+    };
     render();
     onStateChange();
   }

package/dist/src/web-ui/app/controllers/runtime-selection-controller.d.ts

@@ -1,5 +1,6 @@
 export type AgentMode = "auto" | "fast" | "reasoning" | "deep";
-export type ToolPermissionMode = "ask" | "full_access";
+import type { ToolPermissionMode } from "../lib/tool-permission-mode.js";
+export type { ToolPermissionMode } from "../lib/tool-permission-mode.js";
 
 export declare function normalizeAgentMode(mode: unknown): AgentMode;
 export declare function normalizeToolPermissionMode(
@@ -79,6 +80,8 @@ export interface RuntimeSelectionControllerDependencies {
         label?: unknown;
       }>[];
       defaultEnvironmentId?: unknown;
+      backend?: unknown;
+      supportedToolPermissionModes?: readonly unknown[];
     }> | null;
     pinnedSessionIds: readonly string[];
     sessionModes: Record<string, Record<string, unknown>>;
@@ -119,6 +122,8 @@ export interface RuntimeSelectionControllerDependencies {
       normalize: (value: unknown) => ToolPermissionMode,
     ): Record<string, Record<string, unknown>>;
     saveSessionModes(modes: Record<string, Record<string, unknown>>): void;
+    loadLastToolPermissionMode(normalize: (value: unknown) => ToolPermissionMode): ToolPermissionMode;
+    saveLastToolPermissionMode(mode: ToolPermissionMode): void;
     loadModelPreferences(): {
       sessionModels: Record<string, unknown>;
       lastModelByEnvironment: Record<string, unknown>;
@@ -175,4 +180,5 @@ export declare function createRuntimeSelectionController(
   selectedModelSupportsImageInput(profileId?: string): boolean;
   setAgentMode(mode: AgentMode): Promise<boolean>;
   setToolPermissionMode(mode: ToolPermissionMode): void;
+  initializeSessionMode(sessionId: string): void;
 };

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

@@ -1,4 +1,8 @@
 import { escapeAttribute, escapeHtml, textOf } from "../lib/text-format.js";
+import { normalizeToolPermissionMode } from "../lib/tool-permission-mode.js";
+import { createToolPermissionModeController } from "./tool-permission-mode-controller.js";
+
+export { normalizeToolPermissionMode } from "../lib/tool-permission-mode.js";
 
 export function normalizeAgentMode(mode) {
   const normalized = textOf(mode).trim().toLowerCase();
@@ -7,11 +11,6 @@ export function normalizeAgentMode(mode) {
     : "reasoning";
 }
 
-export function normalizeToolPermissionMode(value) {
-  const mode = textOf(value).trim().toLowerCase();
-  return mode === "ask" || mode === "approval_required" ? "ask" : "full_access";
-}
-
 function agentModeMeta(mode) {
   const modes = {
     auto: { label: "Auto", description: "Lets the agent choose", icon: "*" },
@@ -30,20 +29,6 @@ function agentModeMeta(mode) {
   return modes[normalizeAgentMode(mode)] || modes.reasoning;
 }
 
-function permissionMeta(mode) {
-  return normalizeToolPermissionMode(mode) === "ask"
-    ? {
-        label: "Ask",
-        description: "Require approval",
-        title: "Ask before running tools",
-      }
-    : {
-        label: "Full",
-        description: "Run tools directly",
-        title: "Run tools without approval prompts",
-      };
-}
-
 export function createRuntimeSelectionController({
   state,
   dom,
@@ -207,82 +192,12 @@ export function createRuntimeSelectionController({
     saveModelPreferences();
   }
 
-  const sessionModeFor = (sessionId) => {
-    const mode = state.sessionModes[sessionId];
-    return mode && typeof mode === "object" && !Array.isArray(mode) ? mode : {};
-  };
-  const currentToolPermissionMode = () =>
-    normalizeToolPermissionMode(
-      getComposerSessionId()
-        ? sessionModeFor(getComposerSessionId()).toolPermissionMode
-        : undefined,
-    );
-
-  function clearSessionMode(sessionId) {
-    if (!sessionId) return;
-    delete state.sessionModes[sessionId];
-    preferences.saveSessionModes(state.sessionModes);
-  }
-
-  function setToolPermissionMode(mode) {
-    if (!getComposerSessionId()) return;
-    const normalized = normalizeToolPermissionMode(mode);
-    if (normalized === "full_access")
-      delete state.sessionModes[getComposerSessionId()];
-    else {
-      state.sessionModes[getComposerSessionId()] = {
-        ...sessionModeFor(getComposerSessionId()),
-        toolPermissionMode: normalized,
-        savedAt: Date.now(),
-      };
-    }
-    preferences.saveSessionModes(state.sessionModes);
-    state.permissionModeMenuOpen = false;
-    renderPermissionMode();
-    dom.permissionModeButton.focus();
-  }
-
-  function renderPermissionMode() {
-    const mode = currentToolPermissionMode();
-    const meta = permissionMeta(mode);
-    dom.permissionModeButton.innerHTML = `<span class="permission-mode-label">${escapeHtml(meta.label)}</span>`;
-    dom.permissionModeButton.title = meta.title;
-    dom.permissionModeButton.disabled = !getComposerSessionId();
-    dom.permissionModeButton.classList.toggle("full", mode === "full_access");
-    dom.permissionModeButton.classList.toggle(
-      "open",
-      state.permissionModeMenuOpen,
-    );
-    dom.permissionModeButton.setAttribute(
-      "aria-expanded",
-      state.permissionModeMenuOpen ? "true" : "false",
-    );
-    dom.permissionModeMenu.classList.toggle(
-      "open",
-      state.permissionModeMenuOpen,
-    );
-    dom.permissionModeMenu.hidden = !state.permissionModeMenuOpen;
-    dom.permissionModeMenu.setAttribute("role", "menu");
-    dom.permissionModeMenu.innerHTML = ["full_access", "ask"]
-      .map((itemMode) => {
-        const item = permissionMeta(itemMode);
-        const selected = normalizeToolPermissionMode(itemMode) === mode;
-        return `
-          <button class="permission-mode-option ${selected ? "selected" : ""}" type="button"
-            role="menuitemradio" aria-checked="${selected ? "true" : "false"}"
-            tabindex="${selected ? "0" : "-1"}" data-mode="${escapeAttribute(itemMode)}">
-            <strong>${escapeHtml(item.label)}</strong><small>${escapeHtml(item.description)}</small>
-          </button>`;
-      })
-      .join("");
-    dom.permissionModeMenu
-      .querySelectorAll(".permission-mode-option")
-      .forEach((button) => {
-        button.addEventListener("click", () =>
-          setToolPermissionMode(button.dataset.mode),
-        );
-      });
-  }
+  const {
+    clearSessionMode, currentToolPermissionMode, initializeSessionMode,
+    renderPermissionMode, setToolPermissionMode,
+  } = createToolPermissionModeController({
+    state, dom, preferences, recordControlEvent, getComposerSessionId,
+  });
 
   function renderAgentMode() {
     const meta = agentModeMeta(state.agentMode);
@@ -469,6 +384,7 @@ export function createRuntimeSelectionController({
     clearSessionMode,
     configuredEnvironmentOptions,
     currentToolPermissionMode,
+    initializeSessionMode,
     environmentOptions,
     loadAgentMode,
     loadModels,

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

@@ -11,6 +11,7 @@ export function createSessionController({
   state,
   dom,
   sessionActionsMenu,
+  renderGroups = () => false,
   shell,
   preferences,
   client,
@@ -63,6 +64,8 @@ export function createSessionController({
     dom.sessionsList.innerHTML = "";
     const sessions = filtered();
     dom.sessionsCount.textContent = String(sessions.length);
+    if (renderGroups({ root: dom.sessionsList, sessions, createSessionItem }))
+      return;
     if (state.sessions.length === 0) {
       dom.sessionsList.innerHTML = `
         <div class="empty-state sidebar-empty-state">
@@ -82,66 +85,70 @@ export function createSessionController({
       return;
     }
     for (const [sessionIndex, session] of sessions.entries()) {
-      const sessionId = textOf(session.id);
-      const pinned = isPinned(sessionId);
-      const busy = state.busySessionIds.has(sessionId);
-      const unreadCount = getNumber(session.unreadCount, 0);
-      const unreadUnavailable = isSessionReadStateUnavailable(session);
-      const hasUnread = unreadUnavailable
-        ? false
-        : session.hasUnread === true || unreadCount > 0;
-      const item = document.createElement("div");
-      item.className = `session-item ${
-        session.id === state.currentSessionId ? "active" : ""
-      } ${pinned ? "pinned" : ""} ${busy ? "busy" : ""} ${
-        hasUnread ? "unread" : ""
-      }`;
-      item.innerHTML = `
-        <button class="session-open-button" type="button" title="${escapeAttribute(titleOf(session))}">
-          <div class="session-title-row">
-            <div class="session-title" dir="auto">${escapeHtml(titleOf(session))}</div>
-            ${unreadUnavailable ? '<span class="session-unread-badge" title="Unread status unavailable" aria-label="Unread status unavailable">?</span>' : ""}
-            ${
-              hasUnread
-                ? `<span class="session-unread-badge" title="${escapeAttribute(
-                    `${unreadCount || 1} unread`,
-                  )}">${unreadCount > 99 ? "99+" : unreadCount || 1}</span>`
-                : ""
-            }
-          </div>
-        </button>
-        <div class="session-actions" aria-label="Session actions">
-          <button class="session-menu-button" type="button" title="Session actions" aria-label="Session actions" aria-haspopup="menu" aria-expanded="false" aria-controls="session-menu-${sessionIndex}">•••</button>
-          <div id="session-menu-${sessionIndex}" class="session-menu" role="menu" hidden>
-            <button class="session-action pin-action" type="button" role="menuitem" tabindex="-1" title="${pinned ? "Unpin session" : "Pin session"}">${pinned ? "Unpin" : "Pin"}</button>
-            <button class="session-action copy-filename-action" type="button" role="menuitem" tabindex="-1" title="Copy session filename">Copy filename</button>
-            <button class="session-action clear-action" type="button" role="menuitem" tabindex="-1" title="Reset messages">Reset</button>
-            <button class="session-action delete-action" type="button" role="menuitem" tabindex="-1" title="Delete session">Delete</button>
-          </div>
-        </div>
-      `;
-      item
-        .querySelector(".session-open-button")
-        ?.addEventListener("click", () => {
-          shell.setSessionsDrawerOpen(false);
-          void onOpen(session.id);
-        });
-      item
-        .querySelector(".pin-action")
-        ?.addEventListener("click", () => togglePinned(sessionId));
-      item
-        .querySelector(".copy-filename-action")
-        ?.addEventListener("click", () => void copyFilename(sessionId));
-      item
-        .querySelector(".clear-action")
-        ?.addEventListener("click", () => void clearMessages(sessionId));
-      item
-        .querySelector(".delete-action")
-        ?.addEventListener("click", () => void deleteSession(sessionId));
-      dom.sessionsList.appendChild(item);
+      dom.sessionsList.appendChild(createSessionItem(session, sessionIndex));
     }
   }
 
+  function createSessionItem(session, sessionIndex) {
+    const sessionId = textOf(session.id);
+    const pinned = isPinned(sessionId);
+    const busy = state.busySessionIds.has(sessionId);
+    const unreadCount = getNumber(session.unreadCount, 0);
+    const unreadUnavailable = isSessionReadStateUnavailable(session);
+    const hasUnread = unreadUnavailable
+      ? false
+      : session.hasUnread === true || unreadCount > 0;
+    const item = document.createElement("div");
+    item.className = `session-item ${
+      session.id === state.currentSessionId ? "active" : ""
+    } ${pinned ? "pinned" : ""} ${busy ? "busy" : ""} ${
+      hasUnread ? "unread" : ""
+    }`;
+    item.innerHTML = `
+      <button class="session-open-button" type="button" title="${escapeAttribute(titleOf(session))}">
+        <div class="session-title-row">
+          <div class="session-title" dir="auto">${escapeHtml(titleOf(session))}</div>
+          ${unreadUnavailable ? '<span class="session-unread-badge" title="Unread status unavailable" aria-label="Unread status unavailable">?</span>' : ""}
+          ${
+            hasUnread
+              ? `<span class="session-unread-badge" title="${escapeAttribute(
+                  `${unreadCount || 1} unread`,
+                )}">${unreadCount > 99 ? "99+" : unreadCount || 1}</span>`
+              : ""
+          }
+        </div>
+      </button>
+      <div class="session-actions" aria-label="Session actions">
+        <button class="session-menu-button" type="button" title="Session actions" aria-label="Session actions" aria-haspopup="menu" aria-expanded="false" aria-controls="session-menu-${sessionIndex}">•••</button>
+        <div id="session-menu-${sessionIndex}" class="session-menu" role="menu" hidden>
+          <button class="session-action pin-action" type="button" role="menuitem" tabindex="-1" title="${pinned ? "Unpin session" : "Pin session"}">${pinned ? "Unpin" : "Pin"}</button>
+          <button class="session-action copy-filename-action" type="button" role="menuitem" tabindex="-1" title="Copy session filename">Copy filename</button>
+          <button class="session-action clear-action" type="button" role="menuitem" tabindex="-1" title="Reset messages">Reset</button>
+          <button class="session-action delete-action" type="button" role="menuitem" tabindex="-1" title="Delete session">Delete</button>
+        </div>
+      </div>
+    `;
+    item
+      .querySelector(".session-open-button")
+      ?.addEventListener("click", () => {
+        shell.setSessionsDrawerOpen(false);
+        void onOpen(session.id);
+      });
+    item
+      .querySelector(".pin-action")
+      ?.addEventListener("click", () => togglePinned(sessionId));
+    item
+      .querySelector(".copy-filename-action")
+      ?.addEventListener("click", () => void copyFilename(sessionId));
+    item
+      .querySelector(".clear-action")
+      ?.addEventListener("click", () => void clearMessages(sessionId));
+    item
+      .querySelector(".delete-action")
+      ?.addEventListener("click", () => void deleteSession(sessionId));
+    return item;
+  }
+
   function setCurrentTitle(title) {
     if (state.currentSessionId) {
       dom.sessionTitle.textContent = title || state.currentSessionId;

package/dist/src/web-ui/app/controllers/tool-permission-mode-controller.d.ts

@@ -0,0 +1,20 @@
+import type {
+  RuntimeSelectionControllerDependencies,
+  createRuntimeSelectionController,
+} from "./runtime-selection-controller.js";
+
+type SelectionDependencies = RuntimeSelectionControllerDependencies;
+
+export declare function createToolPermissionModeController(options: {
+  state: Pick<SelectionDependencies["state"],
+    "config" | "sessionModes" | "permissionModeMenuOpen">;
+  dom: Pick<SelectionDependencies["dom"],
+    "permissionModeButton" | "permissionModeMenu">;
+  preferences: Pick<SelectionDependencies["preferences"],
+    "saveSessionModes" | "loadLastToolPermissionMode" | "saveLastToolPermissionMode">;
+  recordControlEvent: SelectionDependencies["recordControlEvent"];
+  getComposerSessionId: () => string;
+}): Pick<ReturnType<typeof createRuntimeSelectionController>,
+  "clearSessionMode" | "currentToolPermissionMode" | "initializeSessionMode" |
+  "renderPermissionMode" | "setToolPermissionMode"
+>;