Official

chat

Built-in chat 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 convergence/chat@0.2.5

Permissions in 0.2.5

  • Control chats chats.controlHighCreates chats, sends prompts and cancels runs.Send prompts, answer agent questions, and create, change, fork, revert, stop and group chats
  • Run other plugins' commands commands.runHighRuns commands of other plugins.Run the sidebar's New chat command from the title bar
  • Read chats chats.readMediumReads your transcripts and chat lists.Show workspaces, tasks, chats and transcripts, and follow them as agents work
  • Read files fs.readMediumReads files in the listed places.Suggest workspace files for @ mentionsPlaces: the open workspace
  • Show panels ui.slotsAlways grantedShows views in the listed parts of the window.Draw the chat grid, the title bar, and the Session panel with its rail buttonSlots: centertitlerailright

Files

context-service.ts3 KB
import * as Effect from "effect/Effect";
import type { Api, ArchiveRecord, ContextArtifact } from "convergence";
import type { Params } from "convergence/services";
import { ChatContext } from "./context-contract.ts";
import { contextFormat, detailedTranscript, transcriptContext } from "./context.ts";

const failed = (error: unknown) => ({
  _tag: "ContextPreparationFailed" as const,
  message: error instanceof Error ? error.message : String(error),
});

export function transcriptPolicy(api: Api) {
  return {
    render: (params: Params<ChatContext, "render">) =>
      Effect.try({
        try: () => {
          if (params.configuration.format !== contextFormat)
            throw new Error("The pinned transcript format/configuration is unavailable.");
          return detailedTranscript(params.records as ArchiveRecord[]);
        },
        catch: failed,
      }),
    prepare: (params: Params<ChatContext, "prepare">) =>
      Effect.tryPromise({
        try: async () => {
          if (api.settings.get("handoffEnabled") === false)
            throw new Error(
              "Built-in handoff is disabled. Select a replacement context policy to continue with another agent or recover a lost session.",
            );
          let detailedRecords = params.records as readonly ArchiveRecord[];
          // Returning sessions receive only missing revisions inline, but their
          // detailed file and section references still cover the complete chat.
          if (params.records.length !== params.snapshot.records) {
            const all: ArchiveRecord[] = [];
            for (let offset = 0; offset < params.snapshot.records; offset += 256) {
              const page = await api.host.archive.records({
                chatId: params.snapshot.chatId,
                snapshotId: params.snapshot.id,
                offset,
                limit: 256,
              });
              all.push(...page.records);
            }
            detailedRecords = all;
          }
          const artifacts: ContextArtifact[] = [];
          if (detailedRecords.length) {
            if (!params.destination.capabilities.ordinaryFiles)
              throw new Error(
                "Detailed transcript requires ordinary workspace file access; no sandbox permission was broadened.",
              );
            artifacts.push(
              await api.host.artifacts.create({
                chatId: params.snapshot.chatId,
                snapshotId: params.snapshot.id,
                configuration: { format: contextFormat },
                stubAfterSeconds: 86_400,
                deleteAfterSeconds: 2_592_000,
              }),
            );
          }
          const context = transcriptContext(params.records as ArchiveRecord[], {
            detailedRecords,
            artifact: artifacts[0],
          });
          return {
            instructions: context.instructions,
            text: context.text,
            artifacts,
            covers: [...context.exportedRecords],
          };
        },
        catch: failed,
      }),
  };
}

Versions

VersionPublishedPlugin APISizePermissionsStatus
0.2.5latestNov 21, 2026>=2 <4174.6 KB5 permissionsListed
0.2.4Oct 25, 2026>=2 <4174.2 KB5 permissionsListed
0.2.3Oct 24, 2026>=2 <4165.4 KB5 permissionsListed
0.2.2Oct 23, 2026>=2 <4165 KB5 permissionsListed
0.2.1Oct 6, 2026>=2 <3111.8 KB5 permissionsListed
0.2.0Oct 5, 2026>=2 <3105.1 KB5 permissionsListed

Reviews and comments

0 threads · 0 reviews

No comments yet.