pi-roundtable 0.22.5 → 0.23.1

package/src/core/tool-set.snapshot.json

@@ -46,6 +46,7 @@
 		},
 		"agent": {
 			"tools": [
+				"agent_avatar",
 				"agent_create",
 				"agent_get",
 				"agent_list",
@@ -107,6 +108,7 @@
 				"skill_update"
 			],
 			"selection": [
+				"agent_avatar",
 				"agent_create",
 				"agent_get",
 				"agent_list",
@@ -134,6 +136,7 @@
 		},
 		"group seat": {
 			"tools": [
+				"agent_avatar",
 				"agent_create",
 				"agent_get",
 				"agent_list",
@@ -194,6 +197,7 @@
 				"skill_update"
 			],
 			"selection": [
+				"agent_avatar",
 				"agent_create",
 				"agent_get",
 				"agent_list",
@@ -220,6 +224,7 @@
 		}
 	},
 	"tiers": {
+		"agent_avatar": "admin",
 		"agent_create": "admin",
 		"agent_get": "member",
 		"agent_list": "member",

package/src/index.ts

@@ -4,6 +4,7 @@ export {
 	AGENT_SERVER_PRIORITY,
 	OWNER_TARGET,
 } from "./core/agents/agent-claim.ts";
+export { characterOf } from "./core/agents/agent-rules.ts";
 export type {
 	Agent,
 	AgentGroup,
@@ -11,11 +12,17 @@ export type {
 	AgentStatus,
 } from "./core/agents/agent-store.ts";
 export type { AvatarMode } from "./core/agents/agent-tools.ts";
+export {
+	agentRoomKey,
+	groupRoomKey,
+	roomOf,
+} from "./core/agents/team-keys.ts";
 export type {
 	AgentStatus as TeamAgentStatus,
 	GroupStatus,
 	TeamStatus,
 } from "./core/agents/team-status.ts";
+export { MAX_ATTACHMENT_BYTES } from "./core/attachments/attachment-fetcher.ts";
 export type { AttachmentRetention } from "./core/attachments/attachment-retention.ts";
 export type {
 	ToolAttachment,
@@ -24,6 +31,7 @@ export type {
 export {
 	AGENT_SERVER_PLUGIN,
 	AGENT_TEAM_SERVICE,
+	LOCAL_TEAM_ID,
 } from "./core/builtin/agent-server.ts";
 export type {
 	AccessConfig,
@@ -39,6 +47,7 @@ export type {
 	RoundtableConfig,
 	TierConfig,
 } from "./core/config/config.ts";
+export type { LimitsConfig } from "./core/config/limits.ts";
 export type { SkillsConfig } from "./core/config/skills-config.ts";
 export type {
 	AttachmentPort,
@@ -51,6 +60,8 @@ export type {
 export { AttachmentRefusal } from "./core/contract/attachments.ts";
 export type {
 	Admission,
+	AttachmentContent,
+	AttachmentFile,
 	AttachmentRef,
 	BackgroundRunsAs,
 	BackgroundTarget,
@@ -80,7 +91,11 @@ export type {
 } from "./core/contract/runtime.ts";
 export type { ServiceKey, Services } from "./core/contract/services.ts";
 export { serviceKey } from "./core/contract/services.ts";
-export type { ChatSurface, SurfacePort } from "./core/contract/surface.ts";
+export type {
+	ChatSurface,
+	SurfacePort,
+	SurfaceThreads,
+} from "./core/contract/surface.ts";
 export { channelKey, parseChannelKey } from "./core/contract/surface.ts";
 export type {
 	ConversationRecord,
@@ -120,6 +135,7 @@ export type {
 	HeldCall,
 	OutboundReply,
 	PendingConfirmation,
+	PostAuthor,
 	ReplyFile,
 	TranscriptEntry,
 	TurnResult,
@@ -155,6 +171,7 @@ export {
 	ProviderError,
 } from "./core/errors.ts";
 export type {
+	ClassedHold,
 	HoldCheck,
 	HoldContext,
 	HoldDescription,
@@ -168,6 +185,7 @@ export type {
 	ListenerAddress,
 	ListenerConfig,
 } from "./core/http/listeners.ts";
+export { DEFAULT_MAX_REQUEST_BODY_BYTES } from "./core/http/listeners.ts";
 export type {
 	RouteSocket,
 	WebSocketAccept,
@@ -226,6 +244,12 @@ export {
 export type { JudgeModel } from "./core/judging/model-judge.ts";
 export type { LogEntry, LogFn, Logger } from "./core/log.ts";
 export type { ThinkingLevel, ThinkingSetting } from "./core/models.ts";
+export type {
+	AutoApproval,
+	ConversationMode,
+	ConversationModes,
+	ModeChange,
+} from "./core/modes/conversation-modes.ts";
 export {
 	PERSONAL_TARGET,
 	type PerPrincipalLimits,
@@ -328,10 +352,12 @@ export {
 	IDENTITY,
 	IDENTITY_LINKS,
 	MEMORY,
+	MODES,
 	PRECHECKS,
 	RUNTIME,
 	SCHEDULES,
 	SKILLS,
+	THREADS,
 	WORKER_SESSIONS,
 } from "./core/services.ts";
 export type {

package/src/kit/characters.ts

@@ -0,0 +1,5 @@
+/**
+ * A character as a PNG: `composeSvg` rasterized by canvas. `size` defaults to 512; the other
+ * options are the composer's, defaulting to the idle face on the modern light disc as Discord shows it.
+ */
+export { characterPng as renderCharacterPng } from "../core/agents/character-png.ts";

package/src/kit/index.ts

@@ -17,6 +17,7 @@ export {
 	withAttachmentsBlock,
 	withReference,
 } from "./channels.ts";
+export { renderCharacterPng } from "./characters.ts";
 export type {
 	CompactionEngine,
 	CompactionHistory,
@@ -134,6 +135,7 @@ export {
 	SHELL_TOOLS,
 	shellHoldRule,
 	shellHoldRuleFor,
+	YOLO_CARDED_SHELL_CLASSES,
 } from "./shell.ts";
 export {
 	checkRepoName,

package/src/kit/shell.ts

@@ -6,4 +6,5 @@ export {
 	SHELL_TOOLS,
 	shellHoldRule,
 	shellHoldRuleFor,
+	YOLO_CARDED_SHELL_CLASSES,
 } from "../core/modules/host-shell/shell-policy.ts";

package/src/kit/support.ts

@@ -12,7 +12,6 @@ export type {
 } from "../core/agents/agent-ports.ts";
 export type { Backlog, GroupMessage } from "../core/agents/agent-rules.ts";
 export type { AgentOps } from "../core/agents/agent-tools.ts";
-export type { ThreadHost } from "../core/discord/dispatch-threads.ts";
 export type { Notifier, OwnerNotifier } from "../core/domain/ports.ts";
 export type {
 	EffortPolicy,
@@ -24,3 +23,4 @@ export type { DelegationWorker } from "../core/modules/delegation/delegator.ts";
 export type { AgentChannelLookup } from "../core/modules/schedules/schedules.ts";
 export type { AssistantLike } from "../core/shared/session-messages.ts";
 export type { SpeakerFacts, SpeakerPolicy } from "../core/speakers.ts";
+export type { ThreadHost } from "../core/threads/dispatch-threads.ts";

package/src/kit/threads.ts

@@ -4,4 +4,4 @@ export type {
 	DispatchThread,
 	DispatchThreads,
 	DispatchThreadsOptions,
-} from "../core/discord/dispatch-threads.ts";
+} from "../core/threads/dispatch-threads.ts";

package/src/testing.ts

@@ -38,6 +38,7 @@ import type {
 import { NotLinkedError, PluginError } from "./core/errors.ts";
 import { EventBus } from "./core/events.ts";
 import type { HoldCheck } from "./core/holds.ts";
+import { type ListenerConfig, listenerAddress } from "./core/http/listeners.ts";
 import { contactsOf } from "./core/identity/identity-view.ts";
 import type { OwnerIdentity } from "./core/identity.ts";
 import { ConfirmationJudge } from "./core/judging/confirmation-judge.ts";
@@ -256,6 +257,8 @@ export interface TestPluginOptions {
 	apiKeys?: Readonly<Record<string, string>>;
 	/** How long the router holds a bare forward for the message that follows it; the host option `conversations.forwardJoinMs`. */
 	forwardJoinMs?: number;
+	/** The addresses `context.listener(id)` reports; a plugin that reads one gets `undefined` for any not listed. */
+	listeners?: readonly ListenerConfig[];
 }
 
 export interface RecordedEvent {
@@ -542,6 +545,7 @@ export async function testPlugin(
 			Object.hasOwn(options.apiKeys ?? {}, provider)
 				? options.apiKeys?.[provider]
 				: undefined,
+		listener: (id) => listenerAddress(options.listeners ?? [], id),
 	};
 	const registry = await collectContributions(
 		[plugin],

package/templates/agents.ts

@@ -10,7 +10,7 @@ export const agents: AgentSeed[] = [
 		displayName: "Guide",
 		prompt:
 			"You are Guide, a friendly assistant. Answer briefly and ask when a request is unclear.",
-		avatarPrompt: "A friendly lighthouse keeper with a warm lantern",
+		character: { class: "wizard", palette: "teal" },
 		// The agent in the entry channel is the coordinator: it answers there and can create the others.
 		channelId: env("DISCORD_ENTRY_CHANNEL_ID"),
 	},

package/src/core/discord/dispatch-threads.ts

@@ -1,194 +0,0 @@
-import {
-	existsSync,
-	mkdirSync,
-	readFileSync,
-	renameSync,
-	writeFileSync,
-} from "node:fs";
-import { dirname } from "node:path";
-import type { ChannelKey } from "../domain/conversation.ts";
-import type { InterimMessage, InterimPosts } from "../domain/interim.ts";
-import { messages } from "../i18n/index.ts";
-import type { Logger } from "../log.ts";
-
-const PREFIX = "discord:";
-/** Discord's limit on a thread name. */
-const THREAD_NAME_LIMIT = 100;
-
-/** The chat side of dispatch threads; the Discord surface implements it. */
-export interface ThreadHost {
-	/**
-	 * Posts the start line in the parent and opens a public thread from it; `line` gets the
-	 * thread's mention once it exists. Undefined when the parent cannot host threads, such as a
-	 * DM or a thread; throws when Discord refuses.
-	 */
-	open(
-		parentId: string,
-		name: string,
-		line: (thread?: string) => string,
-	): Promise<string | undefined>;
-	post(threadId: string, text: string): Promise<void>;
-	/**
-	 * Posts one message of at most Discord's 2000 characters and resolves to it, so it can be
-	 * edited in place; without it a thread has no `interim` posts.
-	 */
-	send?(threadId: string, text: string): Promise<InterimMessage>;
-	/** Archives the thread, and locks it when allowed. */
-	close(threadId: string): Promise<void>;
-}
-
-/** One background dispatch's thread: its progress while it runs, then its report. */
-export interface DispatchThread {
-	readonly id: string;
-	/** The thread as a conversation channel, where its owner cards are posted. */
-	readonly channel: ChannelKey;
-	/** `<#id>`, for the report turn and the start line. */
-	readonly mention: string;
-	/** Posts in the thread; a failure is logged. */
-	post(text: string): Promise<void>;
-	/**
-	 * Where the dispatch posts its progress as it goes, under the same name as its report, such
-	 * as a coding worker's interim text; absent when the host cannot edit a message it posted.
-	 * Unlike `post`, a failure rejects.
-	 */
-	readonly interim?: InterimPosts;
-	/** Posts the final report, if any, then archives the thread. Runs once; never rejects. */
-	close(report?: string): Promise<void>;
-}
-
-export interface DispatchThreadsOptions {
-	host: ThreadHost;
-	/** Threads still open, so a start after a crash can archive them. */
-	ledgerPath: string;
-	/** Channels whose claims keep reports in place rather than opening threads. */
-	excluded?: (channel: ChannelKey) => boolean;
-	logger: Logger;
-}
-
-interface LedgerEntry {
-	title: string;
-	parent: ChannelKey;
-	startedAt: string;
-}
-
-/** The thread's name: the title on one line, within Discord's limit. */
-export function threadName(title: string): string {
-	const line = title.replace(/\s+/g, " ").trim() || "dispatch";
-	return line.length > THREAD_NAME_LIMIT
-		? `${line.slice(0, THREAD_NAME_LIMIT - 1)}…`
-		: line;
-}
-
-/**
- * Background dispatches (coding tasks, delegated tasks, messages between agents) each get a
- * thread in the channel that started them, leaving one start line there. A channel that cannot
- * host one, or a failed creation, gets no thread, and the dispatch posts as before.
- */
-export class DispatchThreads {
-	readonly #options: DispatchThreadsOptions;
-	readonly #open = new Map<string, LedgerEntry>();
-
-	constructor(options: DispatchThreadsOptions) {
-		this.#options = options;
-		const { ledgerPath } = options;
-		if (!existsSync(ledgerPath)) return;
-		let parsed: unknown;
-		try {
-			parsed = JSON.parse(readFileSync(ledgerPath, "utf8"));
-		} catch (error) {
-			throw new Error(`${ledgerPath} is not valid JSON`, { cause: error });
-		}
-		if (typeof parsed !== "object" || parsed === null)
-			throw new Error(`${ledgerPath} must hold a JSON object`);
-		for (const [id, entry] of Object.entries(parsed))
-			this.#open.set(id, entry as LedgerEntry);
-	}
-
-	/** Opens the dispatch's thread under `origin`, posting `intro` first; never rejects. */
-	async open(
-		origin: ChannelKey | undefined,
-		title: string,
-		intro?: string,
-	): Promise<DispatchThread | undefined> {
-		const { host, excluded, logger } = this.#options;
-		if (!origin?.startsWith(PREFIX) || excluded?.(origin)) return undefined;
-		const name = threadName(title);
-		let id: string | undefined;
-		try {
-			id = await host.open(origin.slice(PREFIX.length), name, (thread) =>
-				messages().threadStarted(name, thread),
-			);
-		} catch (error) {
-			logger.warn({ origin, err: error }, "dispatch thread not opened");
-			return undefined;
-		}
-		if (!id) return undefined;
-		this.#open.set(id, {
-			title: name,
-			parent: origin,
-			startedAt: new Date().toISOString(),
-		});
-		this.#write();
-		logger.info({ origin, thread: id }, "dispatch thread opened");
-		const thread = this.#thread(id);
-		if (intro) await thread.post(intro);
-		return thread;
-	}
-
-	/** Archives the threads a restart left open; their dispatches never report. */
-	async sweep(): Promise<void> {
-		for (const id of [...this.#open.keys()])
-			await this.#thread(id).close(messages().restartNotice);
-	}
-
-	#thread(id: string): DispatchThread {
-		const { host, logger } = this.#options;
-		let closed = false;
-		const send = host.send?.bind(host);
-		const post = async (text: string) => {
-			try {
-				await host.post(id, text);
-			} catch (error) {
-				logger.warn({ thread: id, err: error }, "dispatch thread post failed");
-			}
-		};
-		return {
-			id,
-			channel: `${PREFIX}${id}`,
-			mention: `<#${id}>`,
-			post,
-			...(send ? { interim: { post: (text: string) => send(id, text) } } : {}),
-			close: async (report) => {
-				if (closed) return;
-				closed = true;
-				if (report) await post(report);
-				try {
-					await host.close(id);
-				} catch (error) {
-					logger.warn(
-						{ thread: id, err: error },
-						"dispatch thread not archived",
-					);
-				}
-				this.#open.delete(id);
-				this.#write();
-			},
-		};
-	}
-
-	#write(): void {
-		const path = this.#options.ledgerPath;
-		try {
-			mkdirSync(dirname(path), { recursive: true });
-			const temporary = `${path}.tmp`;
-			writeFileSync(
-				temporary,
-				`${JSON.stringify(Object.fromEntries(this.#open), null, 2)}\n`,
-				{ mode: 0o600 },
-			);
-			renameSync(temporary, path);
-		} catch (error) {
-			this.#options.logger.warn({ err: error }, "dispatch threads not saved");
-		}
-	}
-}