pi-roundtable-line 0.16.0 → 0.17.0

package/CHANGELOG.md

@@ -5,6 +5,14 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [0.17.0] - 2026-10-16
+
+### Added
+
+- The `line` surface tells the model that LINE shows plain text only: its `formatting` text is appended to the system prompt of every turn that replies in a LINE chat, after the persona. `line({ formatting })` replaces it and `false` tells the model nothing. Needs pi-roundtable with `ChatSurface.formatting`.
+- `LINE_FORMATTING`: the built-in guidance text, for a host that wants the same words elsewhere, such as in the description of a tool that sends to LINE.
+- Release in lockstep with pi-roundtable 0.17.0. The core peer range moves to `>=0.17.0 <0.18.0`.
+
 ## [0.16.0] - 2026-10-16
 
 ### Added

package/README.md

@@ -390,6 +390,10 @@ What the host writes there (`sendReply`) is queued as text objects, one per chun
 The surface shows no typing indicator, stop control, progress, files or approval prompts: LINE has none the bot can show.
 It passes `describeSurfaceContract` (`pi-roundtable/testing`).
 
+LINE shows plain text only, so the surface tells the model so: its `formatting` text is appended to the system prompt of every turn that replies in a LINE chat, after the persona, and says to use no headings, tables, bold, code fences or link syntax and to keep replies short.
+`formatting: "…"` in the plugin options replaces the text, and `formatting: false` tells the model nothing.
+The built-in text is exported as `LINE_FORMATTING`, so a host can reuse it, such as in the description of a tool that sends to LINE.
+
 ## The sender icon route
 
 ```ts

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-roundtable-line",
-	"version": "0.16.0",
+	"version": "0.17.0",
 	"description": "A LINE Messaging API transport for pi-roundtable: a signed webhook that persists events before it answers, a durable inbox worker, and an allowlist of the groups and chats it mirrors",
 	"type": "module",
 	"license": "MIT",
@@ -33,14 +33,14 @@
 		"test": "bun test"
 	},
 	"peerDependencies": {
-		"pi-roundtable": ">=0.16.0 <0.17.0"
+		"pi-roundtable": ">=0.17.0 <0.18.0"
 	},
 	"devDependencies": {
 		"@biomejs/biome": "2.5.15",
 		"@earendil-works/pi-ai": ">=1.0.0 <2",
 		"@earendil-works/pi-coding-agent": ">=1.0.0 <2",
 		"@types/bun": "1.4.2",
-		"pi-roundtable": "0.16.0",
+		"pi-roundtable": "0.17.0",
 		"typebox": "1.3.34",
 		"typescript": "7.0.2"
 	}

package/src/index.ts

@@ -67,7 +67,7 @@ export type {
 	LineSources,
 	SourceStatus,
 } from "./sources.ts";
-export { LineSurface } from "./surface.ts";
+export { LINE_FORMATTING, LineSurface } from "./surface.ts";
 export type { LineCredentials, TokenMode } from "./token.ts";
 export type { WebhookHealth } from "./webhook.ts";
 export { WEBHOOK_MAX_BYTES } from "./webhook.ts";

package/src/options.ts

@@ -38,6 +38,13 @@ export interface LineOptions {
 	 * through `everyone`.
 	 */
 	route?: boolean;
+	/**
+	 * What the model is told, English, about how a reply shows in LINE, appended to the system
+	 * prompt of every turn that replies there, after the persona. The default says LINE shows plain
+	 * text only, so Markdown appears as literal symbols. A text replaces it; `false` tells the
+	 * model nothing.
+	 */
+	formatting?: string | false;
 	/** Serves one fixed PNG at `path`, so a sender can name it as its icon without another service. */
 	senderIconRoute?: SenderIconRoute;
 	/** Replaces `fetch` for every call to LINE, for tests. */
@@ -83,6 +90,13 @@ export function checkOptions(options: LineOptions): {
 		throw new Error(
 			`line: webhookPath ${JSON.stringify(path)} must start with / and not end with one, such as /line/webhook`,
 		);
+	if (
+		typeof options.formatting === "string" &&
+		options.formatting.trim() === ""
+	)
+		throw new Error(
+			"line: formatting is empty; write the guidance, or false to give the model none",
+		);
 	for (const [key, value] of Object.entries(options.inbox ?? {})) {
 		if (!INBOX_KEYS.includes(key as keyof InboxOptions))
 			throw new Error(`line: inbox.${key} is not an inbox option`);

package/src/plugin.ts

@@ -68,7 +68,7 @@ export function line(options: LineOptions): RoundtablePlugin {
 				...(options.sender ? { sender: options.sender } : {}),
 				queued: (readyInMs) => outboxWorker?.kickIn(readyInMs),
 			});
-			const surface = new LineSurface(outbox);
+			const surface = new LineSurface(outbox, options.formatting);
 			const joins = new JoinNotifier({
 				sql,
 				api,

package/src/surface.ts

@@ -13,6 +13,14 @@ import type { LineOutbox, LineOutMessage } from "./outbox.ts";
 /** The longest text one LINE message holds. */
 const TEXT_MAX = 5000;
 
+/**
+ * What the model is told about LINE's rendering, as the surface's `formatting` unless the host
+ * replaces it; exported so a host can reuse it, such as in the description of a tool that sends to
+ * LINE. English: it is model-facing text, not a message-catalog string.
+ */
+export const LINE_FORMATTING =
+	"Reply formatting (LINE): plain text only. Markdown is not rendered and shows as literal symbols, so use no headings, tables, bold, code fences or link syntax. Write short paragraphs, and lists with plain dashes or numbers. Keep replies short.";
+
 /** `text` cut into pieces LINE takes, never inside a surrogate pair. */
 function pieces(text: string): string[] {
 	const parts: string[] = [];
@@ -39,11 +47,21 @@ function pieces(text: string): string[] {
  */
 export class LineSurface implements ChatSurface {
 	readonly surface = "line";
+	readonly formatting: string | undefined;
 	readonly #outbox: LineOutbox;
 	#deliver: ((message: InboundMessage) => void) | undefined;
 
-	constructor(outbox: LineOutbox) {
+	/** `formatting` replaces what the model is told about LINE's plain text, and `false` tells it nothing. */
+	constructor(outbox: LineOutbox, formatting?: string | false) {
 		this.#outbox = outbox;
+		if (formatting === false) this.formatting = undefined;
+		else if (formatting === undefined) this.formatting = LINE_FORMATTING;
+		else if (formatting.trim() === "")
+			throw new LineError(
+				"formatting_empty",
+				"line: formatting is empty; write the guidance, or false to give the model none",
+			);
+		else this.formatting = formatting;
 	}
 
 	async start(deliver: (message: InboundMessage) => void): Promise<void> {