Official

settings

Built-in settings UI (JavaScript UI plugin).

The app opens the listing; nothing installs until an agent in your Plugins workspace has read the files and you enable the plugin. In a terminal: dvg install divergence/settings@0.2.5

Permissions in 0.2.5

  • Manage plugins plugins.manageOfficial onlyReloads and enables plugins. Only official plugins can have it.List, enable, disable and reload plugins, install updates, and quit to finish an update
  • Change app settings settings.writeHighChanges the app settings.Change the settings and the theme
  • Manage agents agents.manageHighEnables, disables and signs in agents, and changes their settings.Turn agents on and off, sign in to them and update them
  • Control chats chats.controlHighCreates chats, sends prompts and cancels runs.Import an agent's own sessions as chats, add project folders, and open the first chat and the changes saved in the first-run guide
  • Read chats chats.readMediumReads your transcripts and chat lists.List the workspaces an agent's sessions can be imported into, and hold an agent's update until its chats stop running
  • Read app settings settings.readLowReads the app settings.Show the settings, and the tools and rules of every plugin
  • Show panels ui.slotsAlways grantedShows views in the listed parts of the window.Draw settings, its list of sections in the sidebar's place, and the first-run guideSlots: centerleft

Files

archived.ts3.5 KB
// Settings > Archived Chats: every archived chat, with Restore and Delete.
// The list is read each time the section opens and kept current by the
// host's chat events in between. Delete asks first, since a deleted chat
// cannot come back.
import * as Context from "effect/Context";
import * as Effect from "effect/Effect";
import * as Layer from "effect/Layer";
import { Host, Notify } from "divergence/effect";
import type { Chat, ViewHandle } from "divergence";

const makeArchivedChats = Effect.fn("ArchivedChats.make")(function* () {
  const host = yield* Host;
  const notify = yield* Notify;
  // `chats` is null until the section is first opened; `error` says why the
  // last read failed; `deleting` is the chat whose Delete waits for the
  // user's answer.
  const state = { chats: null as readonly Chat[] | null, error: null as string | null, deleting: null as Chat | null };
  const views: ViewHandle[] = [];
  const redraw = () => {
    for (const view of views) view.update();
  };

  const load = Effect.fn("ArchivedChats.load")(function* () {
    yield* host.call("host/chats.list", {}).pipe(
      Effect.tap(({ chats }) =>
        Effect.sync(() => {
          state.chats = chats.filter((chat) => chat.archived);
          state.error = null;
          redraw();
        }),
      ),
      // The section says why, with Try again.
      Effect.catch((error) =>
        Effect.sync(() => {
          state.error = error.message;
          redraw();
        }),
      ),
    );
  });

  // A chat archived or brought back anywhere joins or leaves the list.
  const chatChanged = (chat: Chat): Effect.Effect<void> =>
    Effect.sync(() => {
      if (!state.chats) return;
      const rest = state.chats.filter((c) => c.id !== chat.id);
      if (!chat.archived && rest.length === state.chats.length) return;
      state.chats = chat.archived ? [chat, ...rest] : rest;
      if (!chat.archived && state.deleting?.id === chat.id) state.deleting = null;
      redraw();
    });

  const chatRemoved = (chatId: string): Effect.Effect<void> =>
    Effect.sync(() => {
      if (!state.chats) return;
      state.chats = state.chats.filter((c) => c.id !== chatId);
      if (state.deleting?.id === chatId) state.deleting = null;
      redraw();
    });

  // A restored chat comes back to the sidebar as a row of its own.
  const restore = Effect.fn("ArchivedChats.restore")(function* (chat: Chat) {
    yield* host.call("host/chats.update", { chatId: chat.id, archived: false }).pipe(
      Effect.flatMap(chatChanged),
      Effect.catch((error) => notify.error(`Could not restore “${chat.title}”: ${error.message}`)),
    );
  });

  // Delete asks first (`chat`), and the answer closes the question (`null`).
  const askDelete = (chat: Chat | null): Effect.Effect<void> =>
    Effect.sync(() => {
      state.deleting = chat;
      redraw();
    });

  const confirmDelete = Effect.fn("ArchivedChats.confirmDelete")(function* () {
    const chat = state.deleting;
    if (!chat) return;
    yield* askDelete(null);
    yield* host.call("host/chats.delete", { chatId: chat.id }).pipe(
      Effect.andThen(chatRemoved(chat.id)),
      Effect.catch((error) => notify.error(`Could not delete “${chat.title}”: ${error.message}`)),
    );
  });

  return { state, views, load, chatChanged, chatRemoved, restore, askDelete, confirmDelete };
});

export class ArchivedChats extends Context.Service<ArchivedChats, Effect.Success<ReturnType<typeof makeArchivedChats>>>()(
  "settings/ArchivedChats",
) {
  static readonly layer = Layer.effect(ArchivedChats, makeArchivedChats());
}

Versions

VersionPublishedPlugin APISizePermissionsStatus
0.2.8latestNov 21, 2026>=5 <668.5 KB7 permissionsListed
0.2.7Nov 18, 2026>=5 <668 KB7 permissionsListed
0.2.6Nov 16, 2026>=5 <666.3 KB7 permissionsListed
0.2.5Nov 11, 2026>=5 <663.6 KB7 permissionsListed
0.2.4Nov 9, 2026>=5 <661.6 KB7 permissionsListed
0.2.3Oct 27, 2026>=2 <446.8 KB7 permissionsListed

Reviews and comments

0 threads · 0 reviews

No comments yet.