pi-roundtable-web 0.7.18 → 0.8.0

package/dist/index.html

@@ -5,7 +5,7 @@
 		<meta name="viewport" content="width=device-width, initial-scale=1" />
 		<title>Console</title>
 		
-	<link rel="stylesheet" crossorigin href="./chunk-e8z9q554.css"><script type="module" crossorigin src="./chunk-mr32cg74.js"></script></head>
+	<link rel="stylesheet" crossorigin href="./chunk-e8z9q554.css"><script type="module" crossorigin src="./chunk-2cm6wak5.js"></script></head>
 	<body>
 		<div id="root"></div>
 		

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-roundtable-web",
-	"version": "0.7.18",
+	"version": "0.8.0",
 	"description": "An owner-only web console for pi-roundtable: conversations, transcripts, and memory notes, with live updates",
 	"type": "module",
 	"license": "MIT",
@@ -40,14 +40,14 @@
 		"jose": "6.2.12"
 	},
 	"peerDependencies": {
-		"pi-roundtable": ">=0.7.0 <0.8.0"
+		"pi-roundtable": ">=0.8.0 <0.9.0"
 	},
 	"devDependencies": {
 		"@biomejs/biome": "2.5.15",
 		"@types/bun": "1.4.2",
 		"@types/react": "19.3.0",
 		"@types/react-dom": "19.3.0",
-		"pi-roundtable": "0.7.18",
+		"pi-roundtable": "0.8.0",
 		"react": "19.3.0",
 		"react-dom": "19.3.0",
 		"react-markdown": "10.1.0",

package/src/api-types.ts

@@ -80,8 +80,16 @@ export interface DashboardView {
 	party: PartyView[];
 }
 
-/** Who a stored conversation belongs to. */
-export type ConversationKind = "agent" | "group" | "owner" | "outside";
+/**
+ * Who a stored conversation belongs to; `plugin` is one a plugin runs through `context.turns`,
+ * such as a web chat, as the host's registry records it.
+ */
+export type ConversationKind =
+	| "agent"
+	| "group"
+	| "owner"
+	| "outside"
+	| "plugin";
 
 export interface ConversationView {
 	/** The channel key: `discord:<id>`, `agentgroup:<channel>.<agent>`, or `mcp:<session>`. */
@@ -97,9 +105,11 @@ export interface ConversationView {
 	liveBytes: number;
 	archives: number;
 	lastActive?: string;
-	/** Outside-agent conversations only: up to 80 characters of the first message. */
+	/** Outside-agent and plugin conversations only: up to 80 characters of the first message. */
 	firstMessage?: string;
 	startedAt?: string;
+	/** Plugin conversations only: the name the registry gives it. */
+	title?: string;
 	/** Turns running or waiting in the channel. */
 	busy: number;
 }

package/src/console-api.ts

@@ -2,12 +2,13 @@ import { join } from "node:path";
 import type {
 	AgentTeam,
 	ChannelKey,
+	ConversationRegistry,
 	Logger,
 	MemoryKind,
 	QueuePort,
 	SpeakerMemory,
 } from "pi-roundtable";
-import { MemoryError } from "pi-roundtable";
+import { MemoryError, parseChannelKey } from "pi-roundtable";
 import { thinkingLabel } from "pi-roundtable/kit";
 import type {
 	ApiError,
@@ -28,10 +29,12 @@ import {
 	conversationFiles,
 	parseKey,
 	readTranscript,
+	registeredConversations,
+	registeredDir,
 	type StoredConversation,
+	type StoredKind,
 	storedConversations,
 } from "./conversations.ts";
-
 import {
 	type ConsoleFeatures,
 	type ConsolePresentation,
@@ -61,6 +64,8 @@ export interface ConsolePorts {
 	>;
 	/** Conversations the console must not list or read. */
 	exclude?: (key: ChannelKey) => boolean;
+	/** The host's conversation registry; without it only the conversations found by name are listed. */
+	registry?: Pick<ConversationRegistry, "list" | "get">;
 	/** Text a relayed message begins with, which is not the owner's words. */
 	relayNotes: readonly string[];
 	/** Called after a note is written, so every open page refreshes. */
@@ -272,29 +277,56 @@ export class ConsoleApi {
 	// ── Conversations ──────────────────────────────────────────────────────
 
 	async conversations(): Promise<ConversationsView> {
-		const { sessionsDir, relayNotes, exclude } = this.#ports;
-		const stored = storedConversations(sessionsDir, {
-			excluded: (key) =>
-				(exclude?.(key) ?? false) ||
-				(this.#ports.features?.party?.contains(key) ?? false),
+		const { sessionsDir, relayNotes, registry } = this.#ports;
+		const filter = {
+			excluded: (key: ChannelKey) => this.#hidden(key),
 			relayNotes,
-		});
+		};
+		// The registry first; the directory scan reads the conversations from before it, by name.
+		const recorded = registry
+			? registeredConversations(sessionsDir, await registry.list(), filter)
+			: [];
+		const stored = [
+			...recorded,
+			...storedConversations(sessionsDir, filter),
+		].sort((a, b) => (b.lastActive ?? "").localeCompare(a.lastActive ?? ""));
 		return {
 			conversations: await Promise.all(stored.map((c) => this.#view(c))),
 		};
 	}
 
+	#hidden(key: ChannelKey): boolean {
+		return (
+			(this.#ports.exclude?.(key) ?? false) ||
+			(this.#ports.features?.party?.contains(key) ?? false)
+		);
+	}
+
+	/** The session directory and identity of a conversation the console may read, or undefined. */
+	async #located(
+		key: string,
+	): Promise<
+		{ dir: string; kind: StoredKind; id: string; member?: string } | undefined
+	> {
+		const parsed = parseKey(key);
+		if (parsed) return parsed;
+		const record = await this.#ports.registry?.get(key as ChannelKey);
+		return record
+			? {
+					dir: registeredDir(record.key),
+					kind: "registered",
+					id: parseChannelKey(record.key).id,
+				}
+			: undefined;
+	}
+
 	async transcript(
 		key: string,
 		archive: string | undefined,
 	): Promise<TranscriptView> {
-		const { sessionsDir, relayNotes, exclude } = this.#ports;
-		const parsed = parseKey(key);
-		if (
-			!parsed ||
-			exclude?.(key as ChannelKey) ||
-			this.#ports.features?.party?.contains(key as ChannelKey)
-		)
+		const { sessionsDir, relayNotes } = this.#ports;
+		const parsed = await this.#located(key);
+		if (!parsed || this.#hidden(key as ChannelKey))
 			throw new HttpError(404, "There is no such conversation.");
 		const dir = join(sessionsDir, parsed.dir);
 		const files = conversationFiles(dir);
@@ -324,17 +356,20 @@ export class ConsoleApi {
 		const kind: ConversationKind =
 			stored.kind === "mcp"
 				? "outside"
-				: stored.kind === "group"
-					? "group"
-					: (team?.owns(stored.key) ?? "owner");
+				: stored.kind === "registered"
+					? "plugin"
+					: stored.kind === "group"
+						? "group"
+						: (team?.owns(stored.key) ?? "owner");
 		return {
 			key: stored.key,
 			kind,
 			id: stored.id,
 			...(stored.member ? { member: stored.member } : {}),
-			...(stored.kind === "mcp"
+			...(stored.kind === "mcp" || stored.kind === "registered"
 				? {}
 				: { channel: await this.#name(stored.id) }),
+			...(stored.title === undefined ? {} : { title: stored.title }),
 			liveBytes: stored.liveBytes,
 			archives: stored.archives,
 			...(stored.lastActive ? { lastActive: stored.lastActive } : {}),

package/src/conversations.ts

@@ -9,8 +9,12 @@ import {
 	statSync,
 } from "node:fs";
 import { join } from "node:path";
-import type { ChannelKey } from "pi-roundtable";
-import { textOf } from "pi-roundtable/kit";
+import {
+	type ChannelKey,
+	type ConversationRecord,
+	parseChannelKey,
+} from "pi-roundtable";
+import { channelSegment, textOf } from "pi-roundtable/kit";
 import type { TranscriptEntry } from "./api-types.ts";
 
 const FIRST_MESSAGE_CHARS = 80;
@@ -41,8 +45,11 @@ export interface ConversationFiles {
 	lastActive?: string;
 }
 
-/** The kinds of session directory the console reads. */
-export type StoredKind = "discord" | "group" | "mcp";
+/**
+ * The kinds of session directory the console reads: the three it recognises by name, and any
+ * other conversation the host's registry records.
+ */
+export type StoredKind = "discord" | "group" | "mcp" | "registered";
 
 /** An owner, agent, group-member, or outside-agent conversation found on disk. */
 export interface StoredConversation extends ConversationFiles {
@@ -52,9 +59,11 @@ export interface StoredConversation extends ConversationFiles {
 	id: string;
 	/** Group conversations only: the agent whose conversation inside the group this is. */
 	member?: string;
-	/** Outside-agent conversations only. */
+	/** Outside-agent and registered conversations only. */
 	firstMessage?: string;
 	startedAt?: string;
+	/** Registered conversations only: the name the registry gives it. */
+	title?: string;
 }
 
 /** The session directory a channel key names, or undefined when the key is not one the console reads. */
@@ -253,6 +262,41 @@ export function storedConversations(
 	);
 }
 
+/** The session directory of a conversation the registry records, by its key. */
+export function registeredDir(key: ChannelKey): string {
+	return channelSegment(key);
+}
+
+/**
+ * The conversations the host's registry records and the directory scan does not recognise, with
+ * their files; one whose first turn left no session file has nothing to read and is left out.
+ */
+export function registeredConversations(
+	sessionsDir: string,
+	records: readonly ConversationRecord[],
+	options: {
+		excluded: (key: ChannelKey) => boolean;
+		relayNotes: readonly string[];
+	},
+): StoredConversation[] {
+	const found: StoredConversation[] = [];
+	for (const record of records) {
+		if (parseKey(record.key) || options.excluded(record.key)) continue;
+		const dir = join(sessionsDir, registeredDir(record.key));
+		const files = conversationFiles(dir);
+		if (!files) continue;
+		found.push({
+			key: record.key,
+			kind: "registered",
+			id: parseChannelKey(record.key).id,
+			...files,
+			...opening(dir, options.relayNotes),
+			...(record.title === undefined ? {} : { title: record.title }),
+		});
+	}
+	return found;
+}
+
 /** The archive folders of a conversation, newest first. */
 export function archiveNames(dir: string): string[] {
 	const archiveDir = join(dir, "archive");

package/src/web-plugin.ts

@@ -1,5 +1,6 @@
 import {
 	AGENTS,
+	CONVERSATIONS,
 	definePlugin,
 	MEMORY,
 	type RoundtablePlugin,
@@ -45,6 +46,8 @@ async function build(settings: ResolvedOptions, context: Context) {
 	}
 	const team = services.find(AGENTS)?.team;
 	const connection = services.find(DISCORD)?.connection;
+	// Absent on a host without the registry: the console then lists conversations found by name only.
+	const registry = services.find(CONVERSATIONS);
 	const listeners: (() => void)[] = [];
 	const changed = () => {
 		for (const listener of listeners) listener();
@@ -65,6 +68,7 @@ async function build(settings: ResolvedOptions, context: Context) {
 			? { memory: services.get(MEMORY).forSpeaker(settings.ownerId) }
 			: {}),
 		...(settings.exclude ? { exclude: settings.exclude } : {}),
+		...(registry ? { registry } : {}),
 		relayNotes: settings.relayNotes,
 		changed,
 		logger,