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.2

Permissions in 0.2.2

  • 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

artifacts.test.ts3.3 KB
// Saved documents stay outside tool folds and retain readable source when their renderer is absent.
// Use the real chat projection and native element factories, not a browser preview.
import assert from "node:assert/strict";
import test from "node:test";
import { chat, harness, item, nodes, transcript } from "./ui-for-tests.test.ts";
import { renderArtifact, renderItems } from "./views/rows.ts";

test("artifact fallback exposes the exact saved source and keeps expansion local to the document", async () => {
  const h = harness();
  try {
    const first = item({ id: "visual-a", role: "artifact" });
    const second = item({ id: "visual-b", role: "artifact" });
    const t = transcript([first, second]);
    const render = () => renderArtifact(h.v, t, first);
    const initial = render();
    assert.equal(initial.type, "artifact_view");
    assert.equal(nodes(initial).find((node) => node.id === "visual-a")?.artifact, first.artifact);
    assert.ok(nodes(initial).some((node) => node.text === first.artifact.summary));
    assert.equal(
      nodes(initial).some((node) => node.type === "code"),
      false,
    );
    nodes(initial)
      .find((node) => node.id === "source-visual-a")
      ?.onClick();
    const source = nodes(render()).find((node) => node.type === "code");
    assert.ok(source);
    assert.deepEqual(JSON.parse(source.text), first.artifact);
    assert.equal(
      nodes(renderArtifact(h.v, t, second)).some((node) => node.type === "code"),
      false,
    );
    nodes(render())
      .find((node) => node.id === "source-visual-a")
      ?.onClick();
    assert.equal(
      nodes(render()).some((node) => node.type === "code"),
      false,
    );
  } finally {
    await h.close();
  }
});

test("older helpers receive a plain readable artifact fallback without an unsupported embedding", async () => {
  const h = harness();
  try {
    Reflect.deleteProperty(h.controller.api, "artifactRenderers");
    const saved = item({ id: "visual-old-host", role: "artifact" });
    const t = transcript([saved]);
    const initial = renderArtifact(h.v, t, saved);
    assert.equal(initial.type, "div");
    assert.ok(nodes(initial).some((node) => node.text === saved.artifact.title));
    nodes(initial)
      .find((node) => node.id === "source-visual-old-host")
      ?.onClick();
    assert.deepEqual(
      JSON.parse(nodes(renderArtifact(h.v, t, saved)).find((node) => node.type === "code")!.text),
      saved.artifact,
    );
  } finally {
    await h.close();
  }
});

test("visual replies remain placed between collapsed tool groups even without a renderer", async () => {
  const h = harness();
  try {
    const saved = item({ id: "visual-a", role: "artifact" });
    const items = [item({ id: "before", role: "tool" }), saved, item({ id: "after", role: "tool" })];
    const t = transcript(items);
    const rows = renderItems(h.v, chat(), t, items);
    assert.equal(rows.length, 3);
    assert.equal(rows[1]?.type, "artifact_view");
    assert.equal(nodes(rows[1]).find((node) => node.id === saved.id)?.artifact, saved.artifact);
    assert.equal(
      nodes(rows[0]).some((node) => node.type === "artifact_view"),
      false,
    );
    assert.equal(
      nodes(rows[2]).some((node) => node.type === "artifact_view"),
      false,
    );
  } finally {
    await h.close();
  }
});

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.