Official

tabs

The tabbed detail pane beside the chat: files to edit and diffs (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 convergence/tabs@0.2.4

Permissions in 0.2.4

  • Read files fs.readMediumReads files in the listed places.Open workspace files in tabsPlaces: the open workspace
  • Write files fs.writeMediumCreates, changes and deletes files in the listed places.Save the files edited in tabsPlaces: the open workspace
  • Read chats chats.readMediumReads your transcripts and chat lists.Reload the open file when an agent finishes a turn
  • Show panels ui.slotsAlways grantedShows views in the listed parts of the window.Draw the tabbed pane beside the chatSlots: detail

Files

contract.ts1.3 KB
// The convergence/tabs service: other plugins open and close tabs in the
// detail pane and follow which tab is visible. Zod is the contract; the host
// derives JSON Schema from it and checks every call, result and event.
import * as z from "zod";
import { defineService } from "convergence/services";

export const TabKind = z.enum(["file", "diff", "terminal", "view"]);

// Which tab: tabs are known by kind and path (a terminal's path is its id).
export const TabRef = z.object({ kind: TabKind, path: z.string() });

export const OpenTab = z.object({
  kind: TabKind,
  workspaceId: z.string(),
  path: z.string(),
  // A diff tab shows this unified diff; a view tab draws this view id.
  diff: z.string().optional(),
  view: z.number().optional(),
  title: z.string().optional(),
  icon: z.string().optional(),
  // A file tab's editor takes the keyboard once it shows: a file the
  // user picked from a list.
  focus: z.boolean().optional(),
});

export const Tabs = defineService("convergence/tabs", "1.1.0", {
  methods: {
    open: { params: OpenTab, result: z.object({ id: z.string() }) },
    close: { params: TabRef, result: z.null() },
    active: { params: z.object({}), result: TabRef.nullable() },
  },
  events: {
    activeChanged: TabRef.nullable(),
  },
});
export type Tabs = typeof Tabs;

Versions

VersionPublishedPlugin APISizePermissionsStatus
0.2.4latestNov 21, 2026>=2 <422.3 KB4 permissionsListed
0.2.3Oct 25, 2026>=2 <422 KB4 permissionsListed
0.2.2Oct 24, 2026>=2 <419.9 KB3 permissionsListed
0.2.1Oct 23, 2026>=2 <420.1 KB3 permissionsListed
0.2.0Oct 5, 2026>=2 <318.8 KB3 permissionsListed

Reviews and comments

0 threads · 0 reviews

No comments yet.