pi-roundtable 0.10.0 → 0.11.0

package/src/core/discord/owner-cards.ts

@@ -24,6 +24,7 @@ import {
 	type CardAudienceOptions,
 	CardAudiences,
 } from "./card-audience.ts";
+import { CardCopies, copyReply, offeredCopy } from "./card-copies.ts";
 import { DiscordOwners, discordUser } from "./discord-owners.ts";
 import type { InteractionModule } from "./interaction-module.ts";
 import {
@@ -75,6 +76,13 @@ export interface OwnerCardsOptions {
 	 * answered. Without it no turn stops waiting on its cards.
 	 */
 	resume?(turn: LateTurn): void;
+	/**
+	 * Where and how long the text behind approval cards' copy buttons is kept. With a `path` it is
+	 * a JSON file that survives a restart; without one the texts live in memory and a card's copy
+	 * button stops working when the process restarts. `keep` (default 100) is how many cards'
+	 * texts, the newest, and `keepDays` (default 30) how long.
+	 */
+	copies?: { path?: string; keep?: number; keepDays?: number };
 }
 
 /**
@@ -91,11 +99,18 @@ export class OwnerCards implements InteractionModule {
 	readonly #options: OwnerCardsOptions;
 	readonly #audiences: CardAudiences;
 	readonly #open = new Map<string, OpenCard>();
+	readonly #copies: CardCopies;
 
 	constructor(options: OwnerCardsOptions) {
 		this.#options = options;
+		this.#copies = new CardCopies({
+			...options.copies,
+			logger: options.logger,
+		});
 		this.#audiences = new CardAudiences(options, new DiscordOwners(options));
 	}
+	/** Resolves once the remembered copy texts are on disk. */
+	flushCopies = (): Promise<void> => this.#copies.flush();
 
 	commands() {
 		return [];
@@ -114,9 +129,15 @@ export class OwnerCards implements InteractionModule {
 				signal,
 				minTier = "owner",
 				wait,
-				_details,
+				details,
 				options,
 			) => {
+				const copy = offeredCopy(details?.copy, (chars) =>
+					this.#options.logger.warn(
+						{ channelId, chars },
+						"card copy text too long; the card has no copy button",
+					),
+				);
 				const audience = await this.#audiences.approval(
 					scope,
 					minTier,
@@ -154,6 +175,7 @@ export class OwnerCards implements InteractionModule {
 							: {}),
 						title,
 						sections: [message],
+						...(copy ? { copy: copy.text } : {}),
 						rows: (id, disabled) => [
 							new ActionRowBuilder<ButtonBuilder>().addComponents(
 								new ButtonBuilder()
@@ -168,6 +190,16 @@ export class OwnerCards implements InteractionModule {
 									.setEmoji("❌")
 									.setStyle(ButtonStyle.Secondary)
 									.setDisabled(disabled),
+								// Copying answers nothing, so it stays usable once the card has ended.
+								...(copy
+									? [
+											new ButtonBuilder()
+												.setCustomId(`${CARD_PREFIX}${id}:copy`)
+												.setLabel(copy.label)
+												.setEmoji("📋")
+												.setStyle(ButtonStyle.Secondary),
+										]
+									: []),
 							),
 						],
 						footer: messages().cardApprovalFooter,
@@ -221,6 +253,8 @@ export class OwnerCards implements InteractionModule {
 			audience: Audience;
 			title: string;
 			sections: string[];
+			/** The text behind the card's copy button, kept under the card's id. */
+			copy?: string;
 			question?: OwnerQuestion;
 			rows(id: string, disabled: boolean): Rows;
 			footer: string;
@@ -236,6 +270,7 @@ export class OwnerCards implements InteractionModule {
 		if (signal?.aborted) return Promise.resolve(cancelled);
 		const wait = resume ? card.wait : undefined;
 		const id = randomUUID();
+		if (card.copy !== undefined) this.#copies.remember(id, card.copy);
 		const sections = [
 			...card.sections,
 			...(card.audience.note ? [card.audience.note] : []),
@@ -361,6 +396,17 @@ export class OwnerCards implements InteractionModule {
 		const [id = "", action = ""] = interaction.customId
 			.slice(CARD_PREFIX.length)
 			.split(":");
+		// Copying answers nothing: anyone who sees the card may copy, as often as they like, also
+		// once the card has ended or the process restarted.
+		if (interaction.isButton() && action === "copy") {
+			const text = this.#copies.recall(id);
+			await interaction.reply(
+				text === undefined
+					? { content: messages().cardCopyGone, flags: MessageFlags.Ephemeral }
+					: copyReply(text),
+			);
+			return true;
+		}
 		const card = this.#open.get(id);
 		if (!card) {
 			await interaction.reply({

package/src/core/domain/attachment.ts

@@ -19,6 +19,9 @@ export interface AttachmentFailure {
 	fromReference: boolean;
 }
 
+/** The most images one turn carries to the model. */
+export const MAX_TURN_IMAGES = 4;
+
 /** An image in the form the model accepts. */
 export interface ModelImage {
 	data: string;

package/src/core/i18n/cards.ts

@@ -5,6 +5,10 @@ export function cardsEn(ctx: CatalogContext) {
 	return {
 		cardRunLabel: "Run",
 		cardCancelLabel: "Cancel",
+		cardCopyLabel: "Copy",
+		cardCopyGone:
+			"The text of this card is no longer kept; ask the assistant to show it again.",
+		cardCopyFile: "The text is long, so it is attached as a file.",
 		cardApprovalFooter:
 			"Nothing runs until you approve; answer whenever you are ready.",
 		cardQuestionFooter: "Answer whenever you are ready.",
@@ -39,6 +43,9 @@ export function cardsZhTW(ctx: CatalogContext): ReturnType<typeof cardsEn> {
 	return {
 		cardRunLabel: "執行",
 		cardCancelLabel: "取消",
+		cardCopyLabel: "複製",
+		cardCopyGone: "這張卡片的文字已經不在了；請再請助理顯示一次。",
+		cardCopyFile: "文字比較長，所以用檔案附上。",
 		cardApprovalFooter: "你核准之前不會執行；準備好再回覆就好。",
 		cardQuestionFooter: "準備好再回答就好。",
 		cardStopped: "⏹️ 這一輪已停止。",

package/src/core/interactions/prompts.ts

@@ -35,6 +35,16 @@ export interface ApprovalDetails {
 	input: Record<string, unknown>;
 	/** The files the call sends by path; absent when it sends none. */
 	files?: ApprovalFile[];
+	/**
+	 * A text the card offers to copy, such as a command or a message the call would send. A surface
+	 * that can shows a control, usable by anyone who sees the card, any number of times, that hands
+	 * them `text` (`label` names the control, default the surface's own); using it never answers
+	 * the prompt. It is informational: a surface that cannot show it ignores it. The text is
+	 * visible to anyone who can see the card, so it holds nothing they may not read. A text over
+	 * 20,000 characters is not offered (Discord logs a warning), and a surface with a size limit of
+	 * its own leaves it out before it cuts the call's `input`.
+	 */
+	copy?: { label?: string; text: string };
 }
 
 /**

package/src/discord/index.ts

@@ -6,10 +6,15 @@ export { DISCORD } from "../core/builtin/discord.ts";
 export type { DiscordAdapterConfig } from "../core/config/config.ts";
 export type {
 	ChannelContext,
+	ChannelContextAttachment,
+	ChannelContextAttachmentOptions,
 	ChannelContextMessage,
 	ChannelContextOptions,
 } from "../core/contract/channel-context.ts";
-export { withChannelContext } from "../core/contract/channel-context.ts";
+export {
+	withChannelContext,
+	withChannelContextImages,
+} from "../core/contract/channel-context.ts";
 export type { AgentPanelMessage } from "../core/discord/agent-commands.ts";
 export type {
 	AgentPanel,