pi-usereq 0.48.0 → 0.50.0

package/pi.dev-src/pi-mono/coding-agent/src/core/keybindings.ts

@@ -1,370 +0,0 @@
-import {
-	type Keybinding,
-	type KeybindingDefinitions,
-	type KeybindingsConfig,
-	type KeyId,
-	TUI_KEYBINDINGS,
-	KeybindingsManager as TuiKeybindingsManager,
-} from "@mariozechner/pi-tui";
-import { existsSync, readFileSync } from "fs";
-import { join } from "path";
-import { getAgentDir } from "../config.js";
-
-export interface AppKeybindings {
-	"app.interrupt": true;
-	"app.clear": true;
-	"app.exit": true;
-	"app.suspend": true;
-	"app.thinking.cycle": true;
-	"app.model.cycleForward": true;
-	"app.model.cycleBackward": true;
-	"app.model.select": true;
-	"app.tools.expand": true;
-	"app.thinking.toggle": true;
-	"app.session.toggleNamedFilter": true;
-	"app.editor.external": true;
-	"app.message.followUp": true;
-	"app.message.dequeue": true;
-	"app.clipboard.pasteImage": true;
-	"app.session.new": true;
-	"app.session.tree": true;
-	"app.session.fork": true;
-	"app.session.resume": true;
-	"app.tree.foldOrUp": true;
-	"app.tree.unfoldOrDown": true;
-	"app.tree.editLabel": true;
-	"app.tree.toggleLabelTimestamp": true;
-	"app.session.togglePath": true;
-	"app.session.toggleSort": true;
-	"app.session.rename": true;
-	"app.session.delete": true;
-	"app.session.deleteNoninvasive": true;
-	"app.models.save": true;
-	"app.models.enableAll": true;
-	"app.models.clearAll": true;
-	"app.models.toggleProvider": true;
-	"app.models.reorderUp": true;
-	"app.models.reorderDown": true;
-	"app.tree.filter.default": true;
-	"app.tree.filter.noTools": true;
-	"app.tree.filter.userOnly": true;
-	"app.tree.filter.labeledOnly": true;
-	"app.tree.filter.all": true;
-	"app.tree.filter.cycleForward": true;
-	"app.tree.filter.cycleBackward": true;
-}
-
-export type AppKeybinding = keyof AppKeybindings;
-
-declare module "@mariozechner/pi-tui" {
-	interface Keybindings extends AppKeybindings {}
-}
-
-export const KEYBINDINGS = {
-	...TUI_KEYBINDINGS,
-	"app.interrupt": { defaultKeys: "escape", description: "Cancel or abort" },
-	"app.clear": { defaultKeys: "ctrl+c", description: "Clear editor" },
-	"app.exit": { defaultKeys: "ctrl+d", description: "Exit when editor is empty" },
-	"app.suspend": {
-		defaultKeys: process.platform === "win32" ? [] : "ctrl+z",
-		description: "Suspend to background",
-	},
-	"app.thinking.cycle": {
-		defaultKeys: "shift+tab",
-		description: "Cycle thinking level",
-	},
-	"app.model.cycleForward": {
-		defaultKeys: "ctrl+p",
-		description: "Cycle to next model",
-	},
-	"app.model.cycleBackward": {
-		defaultKeys: "shift+ctrl+p",
-		description: "Cycle to previous model",
-	},
-	"app.model.select": { defaultKeys: "ctrl+l", description: "Open model selector" },
-	"app.tools.expand": { defaultKeys: "ctrl+o", description: "Toggle tool output" },
-	"app.thinking.toggle": {
-		defaultKeys: "ctrl+t",
-		description: "Toggle thinking blocks",
-	},
-	"app.session.toggleNamedFilter": {
-		defaultKeys: "ctrl+n",
-		description: "Toggle named session filter",
-	},
-	"app.editor.external": {
-		defaultKeys: "ctrl+g",
-		description: "Open external editor",
-	},
-	"app.message.followUp": {
-		defaultKeys: "alt+enter",
-		description: "Queue follow-up message",
-	},
-	"app.message.dequeue": {
-		defaultKeys: "alt+up",
-		description: "Restore queued messages",
-	},
-	"app.clipboard.pasteImage": {
-		defaultKeys: process.platform === "win32" ? "alt+v" : "ctrl+v",
-		description: "Paste image from clipboard",
-	},
-	"app.session.new": { defaultKeys: [], description: "Start a new session" },
-	"app.session.tree": { defaultKeys: [], description: "Open session tree" },
-	"app.session.fork": { defaultKeys: [], description: "Fork current session" },
-	"app.session.resume": { defaultKeys: [], description: "Resume a session" },
-	"app.tree.foldOrUp": {
-		defaultKeys: ["ctrl+left", "alt+left"],
-		description: "Fold tree branch or move up",
-	},
-	"app.tree.unfoldOrDown": {
-		defaultKeys: ["ctrl+right", "alt+right"],
-		description: "Unfold tree branch or move down",
-	},
-	"app.tree.editLabel": {
-		defaultKeys: "shift+l",
-		description: "Edit tree label",
-	},
-	"app.tree.toggleLabelTimestamp": {
-		defaultKeys: "shift+t",
-		description: "Toggle tree label timestamps",
-	},
-	"app.session.togglePath": {
-		defaultKeys: "ctrl+p",
-		description: "Toggle session path display",
-	},
-	"app.session.toggleSort": {
-		defaultKeys: "ctrl+s",
-		description: "Toggle session sort mode",
-	},
-	"app.session.rename": {
-		defaultKeys: "ctrl+r",
-		description: "Rename session",
-	},
-	"app.session.delete": {
-		defaultKeys: "ctrl+d",
-		description: "Delete session",
-	},
-	"app.session.deleteNoninvasive": {
-		defaultKeys: "ctrl+backspace",
-		description: "Delete session when query is empty",
-	},
-	"app.models.save": {
-		defaultKeys: "ctrl+s",
-		description: "Save model selection",
-	},
-	"app.models.enableAll": {
-		defaultKeys: "ctrl+a",
-		description: "Enable all models",
-	},
-	"app.models.clearAll": {
-		defaultKeys: "ctrl+x",
-		description: "Clear all models",
-	},
-	"app.models.toggleProvider": {
-		defaultKeys: "ctrl+p",
-		description: "Toggle all models for provider",
-	},
-	"app.models.reorderUp": {
-		defaultKeys: "alt+up",
-		description: "Move model up in order",
-	},
-	"app.models.reorderDown": {
-		defaultKeys: "alt+down",
-		description: "Move model down in order",
-	},
-	"app.tree.filter.default": {
-		defaultKeys: "ctrl+d",
-		description: "Tree filter: default view",
-	},
-	"app.tree.filter.noTools": {
-		defaultKeys: "ctrl+t",
-		description: "Tree filter: hide tool results",
-	},
-	"app.tree.filter.userOnly": {
-		defaultKeys: "ctrl+u",
-		description: "Tree filter: user messages only",
-	},
-	"app.tree.filter.labeledOnly": {
-		defaultKeys: "ctrl+l",
-		description: "Tree filter: labeled entries only",
-	},
-	"app.tree.filter.all": {
-		defaultKeys: "ctrl+a",
-		description: "Tree filter: show all entries",
-	},
-	"app.tree.filter.cycleForward": {
-		defaultKeys: "ctrl+o",
-		description: "Tree filter: cycle forward",
-	},
-	"app.tree.filter.cycleBackward": {
-		defaultKeys: "shift+ctrl+o",
-		description: "Tree filter: cycle backward",
-	},
-} as const satisfies KeybindingDefinitions;
-
-const KEYBINDING_NAME_MIGRATIONS = {
-	cursorUp: "tui.editor.cursorUp",
-	cursorDown: "tui.editor.cursorDown",
-	cursorLeft: "tui.editor.cursorLeft",
-	cursorRight: "tui.editor.cursorRight",
-	cursorWordLeft: "tui.editor.cursorWordLeft",
-	cursorWordRight: "tui.editor.cursorWordRight",
-	cursorLineStart: "tui.editor.cursorLineStart",
-	cursorLineEnd: "tui.editor.cursorLineEnd",
-	jumpForward: "tui.editor.jumpForward",
-	jumpBackward: "tui.editor.jumpBackward",
-	pageUp: "tui.editor.pageUp",
-	pageDown: "tui.editor.pageDown",
-	deleteCharBackward: "tui.editor.deleteCharBackward",
-	deleteCharForward: "tui.editor.deleteCharForward",
-	deleteWordBackward: "tui.editor.deleteWordBackward",
-	deleteWordForward: "tui.editor.deleteWordForward",
-	deleteToLineStart: "tui.editor.deleteToLineStart",
-	deleteToLineEnd: "tui.editor.deleteToLineEnd",
-	yank: "tui.editor.yank",
-	yankPop: "tui.editor.yankPop",
-	undo: "tui.editor.undo",
-	newLine: "tui.input.newLine",
-	submit: "tui.input.submit",
-	tab: "tui.input.tab",
-	copy: "tui.input.copy",
-	selectUp: "tui.select.up",
-	selectDown: "tui.select.down",
-	selectPageUp: "tui.select.pageUp",
-	selectPageDown: "tui.select.pageDown",
-	selectConfirm: "tui.select.confirm",
-	selectCancel: "tui.select.cancel",
-	interrupt: "app.interrupt",
-	clear: "app.clear",
-	exit: "app.exit",
-	suspend: "app.suspend",
-	cycleThinkingLevel: "app.thinking.cycle",
-	cycleModelForward: "app.model.cycleForward",
-	cycleModelBackward: "app.model.cycleBackward",
-	selectModel: "app.model.select",
-	expandTools: "app.tools.expand",
-	toggleThinking: "app.thinking.toggle",
-	toggleSessionNamedFilter: "app.session.toggleNamedFilter",
-	externalEditor: "app.editor.external",
-	followUp: "app.message.followUp",
-	dequeue: "app.message.dequeue",
-	pasteImage: "app.clipboard.pasteImage",
-	newSession: "app.session.new",
-	tree: "app.session.tree",
-	fork: "app.session.fork",
-	resume: "app.session.resume",
-	treeFoldOrUp: "app.tree.foldOrUp",
-	treeUnfoldOrDown: "app.tree.unfoldOrDown",
-	treeEditLabel: "app.tree.editLabel",
-	treeToggleLabelTimestamp: "app.tree.toggleLabelTimestamp",
-	toggleSessionPath: "app.session.togglePath",
-	toggleSessionSort: "app.session.toggleSort",
-	renameSession: "app.session.rename",
-	deleteSession: "app.session.delete",
-	deleteSessionNoninvasive: "app.session.deleteNoninvasive",
-} as const satisfies Record<string, Keybinding>;
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
-function isLegacyKeybindingName(key: string): key is keyof typeof KEYBINDING_NAME_MIGRATIONS {
-	return key in KEYBINDING_NAME_MIGRATIONS;
-}
-
-function toKeybindingsConfig(value: unknown): KeybindingsConfig {
-	if (!isRecord(value)) return {};
-
-	const config: KeybindingsConfig = {};
-	for (const [key, binding] of Object.entries(value)) {
-		if (typeof binding === "string") {
-			config[key] = binding as KeyId;
-			continue;
-		}
-		if (Array.isArray(binding) && binding.every((entry) => typeof entry === "string")) {
-			config[key] = binding as KeyId[];
-		}
-	}
-	return config;
-}
-
-export function migrateKeybindingsConfig(rawConfig: Record<string, unknown>): {
-	config: Record<string, unknown>;
-	migrated: boolean;
-} {
-	const config: Record<string, unknown> = {};
-	let migrated = false;
-
-	for (const [key, value] of Object.entries(rawConfig)) {
-		const nextKey = isLegacyKeybindingName(key) ? KEYBINDING_NAME_MIGRATIONS[key] : key;
-		if (nextKey !== key) {
-			migrated = true;
-		}
-		if (key !== nextKey && Object.hasOwn(rawConfig, nextKey)) {
-			migrated = true;
-			continue;
-		}
-		config[nextKey] = value;
-	}
-
-	return { config: orderKeybindingsConfig(config), migrated };
-}
-
-function orderKeybindingsConfig(config: Record<string, unknown>): Record<string, unknown> {
-	const ordered: Record<string, unknown> = {};
-	for (const keybinding of Object.keys(KEYBINDINGS)) {
-		if (Object.hasOwn(config, keybinding)) {
-			ordered[keybinding] = config[keybinding];
-		}
-	}
-
-	const extras = Object.keys(config)
-		.filter((key) => !Object.hasOwn(ordered, key))
-		.sort();
-	for (const key of extras) {
-		ordered[key] = config[key];
-	}
-
-	return ordered;
-}
-
-function loadRawConfig(path: string): Record<string, unknown> | undefined {
-	if (!existsSync(path)) return undefined;
-	try {
-		const parsed = JSON.parse(readFileSync(path, "utf-8")) as unknown;
-		return isRecord(parsed) ? parsed : undefined;
-	} catch {
-		return undefined;
-	}
-}
-
-export class KeybindingsManager extends TuiKeybindingsManager {
-	private configPath: string | undefined;
-
-	constructor(userBindings: KeybindingsConfig = {}, configPath?: string) {
-		super(KEYBINDINGS, userBindings);
-		this.configPath = configPath;
-	}
-
-	static create(agentDir: string = getAgentDir()): KeybindingsManager {
-		const configPath = join(agentDir, "keybindings.json");
-		const userBindings = KeybindingsManager.loadFromFile(configPath);
-		return new KeybindingsManager(userBindings, configPath);
-	}
-
-	reload(): void {
-		if (!this.configPath) return;
-		this.setUserBindings(KeybindingsManager.loadFromFile(this.configPath));
-	}
-
-	getEffectiveConfig(): KeybindingsConfig {
-		return this.getResolvedBindings();
-	}
-
-	private static loadFromFile(path: string): KeybindingsConfig {
-		const rawConfig = loadRawConfig(path);
-		if (!rawConfig) return {};
-		return toKeybindingsConfig(migrateKeybindingsConfig(rawConfig).config);
-	}
-}
-
-export type { Keybinding, KeyId, KeybindingsConfig };

package/pi.dev-src/pi-mono/coding-agent/src/core/messages.ts

@@ -1,195 +0,0 @@
-/**
- * Custom message types and transformers for the coding agent.
- *
- * Extends the base AgentMessage type with coding-agent specific message types,
- * and provides a transformer to convert them to LLM-compatible messages.
- */
-
-import type { AgentMessage } from "@mariozechner/pi-agent-core";
-import type { ImageContent, Message, TextContent } from "@mariozechner/pi-ai";
-
-export const COMPACTION_SUMMARY_PREFIX = `The conversation history before this point was compacted into the following summary:
-
-<summary>
-`;
-
-export const COMPACTION_SUMMARY_SUFFIX = `
-</summary>`;
-
-export const BRANCH_SUMMARY_PREFIX = `The following is a summary of a branch that this conversation came back from:
-
-<summary>
-`;
-
-export const BRANCH_SUMMARY_SUFFIX = `</summary>`;
-
-/**
- * Message type for bash executions via the ! command.
- */
-export interface BashExecutionMessage {
-	role: "bashExecution";
-	command: string;
-	output: string;
-	exitCode: number | undefined;
-	cancelled: boolean;
-	truncated: boolean;
-	fullOutputPath?: string;
-	timestamp: number;
-	/** If true, this message is excluded from LLM context (!! prefix) */
-	excludeFromContext?: boolean;
-}
-
-/**
- * Message type for extension-injected messages via sendMessage().
- * These are custom messages that extensions can inject into the conversation.
- */
-export interface CustomMessage<T = unknown> {
-	role: "custom";
-	customType: string;
-	content: string | (TextContent | ImageContent)[];
-	display: boolean;
-	details?: T;
-	timestamp: number;
-}
-
-export interface BranchSummaryMessage {
-	role: "branchSummary";
-	summary: string;
-	fromId: string;
-	timestamp: number;
-}
-
-export interface CompactionSummaryMessage {
-	role: "compactionSummary";
-	summary: string;
-	tokensBefore: number;
-	timestamp: number;
-}
-
-// Extend CustomAgentMessages via declaration merging
-declare module "@mariozechner/pi-agent-core" {
-	interface CustomAgentMessages {
-		bashExecution: BashExecutionMessage;
-		custom: CustomMessage;
-		branchSummary: BranchSummaryMessage;
-		compactionSummary: CompactionSummaryMessage;
-	}
-}
-
-/**
- * Convert a BashExecutionMessage to user message text for LLM context.
- */
-export function bashExecutionToText(msg: BashExecutionMessage): string {
-	let text = `Ran \`${msg.command}\`\n`;
-	if (msg.output) {
-		text += `\`\`\`\n${msg.output}\n\`\`\``;
-	} else {
-		text += "(no output)";
-	}
-	if (msg.cancelled) {
-		text += "\n\n(command cancelled)";
-	} else if (msg.exitCode !== null && msg.exitCode !== undefined && msg.exitCode !== 0) {
-		text += `\n\nCommand exited with code ${msg.exitCode}`;
-	}
-	if (msg.truncated && msg.fullOutputPath) {
-		text += `\n\n[Output truncated. Full output: ${msg.fullOutputPath}]`;
-	}
-	return text;
-}
-
-export function createBranchSummaryMessage(summary: string, fromId: string, timestamp: string): BranchSummaryMessage {
-	return {
-		role: "branchSummary",
-		summary,
-		fromId,
-		timestamp: new Date(timestamp).getTime(),
-	};
-}
-
-export function createCompactionSummaryMessage(
-	summary: string,
-	tokensBefore: number,
-	timestamp: string,
-): CompactionSummaryMessage {
-	return {
-		role: "compactionSummary",
-		summary: summary,
-		tokensBefore,
-		timestamp: new Date(timestamp).getTime(),
-	};
-}
-
-/** Convert CustomMessageEntry to AgentMessage format */
-export function createCustomMessage(
-	customType: string,
-	content: string | (TextContent | ImageContent)[],
-	display: boolean,
-	details: unknown | undefined,
-	timestamp: string,
-): CustomMessage {
-	return {
-		role: "custom",
-		customType,
-		content,
-		display,
-		details,
-		timestamp: new Date(timestamp).getTime(),
-	};
-}
-
-/**
- * Transform AgentMessages (including custom types) to LLM-compatible Messages.
- *
- * This is used by:
- * - Agent's transormToLlm option (for prompt calls and queued messages)
- * - Compaction's generateSummary (for summarization)
- * - Custom extensions and tools
- */
-export function convertToLlm(messages: AgentMessage[]): Message[] {
-	return messages
-		.map((m): Message | undefined => {
-			switch (m.role) {
-				case "bashExecution":
-					// Skip messages excluded from context (!! prefix)
-					if (m.excludeFromContext) {
-						return undefined;
-					}
-					return {
-						role: "user",
-						content: [{ type: "text", text: bashExecutionToText(m) }],
-						timestamp: m.timestamp,
-					};
-				case "custom": {
-					const content = typeof m.content === "string" ? [{ type: "text" as const, text: m.content }] : m.content;
-					return {
-						role: "user",
-						content,
-						timestamp: m.timestamp,
-					};
-				}
-				case "branchSummary":
-					return {
-						role: "user",
-						content: [{ type: "text" as const, text: BRANCH_SUMMARY_PREFIX + m.summary + BRANCH_SUMMARY_SUFFIX }],
-						timestamp: m.timestamp,
-					};
-				case "compactionSummary":
-					return {
-						role: "user",
-						content: [
-							{ type: "text" as const, text: COMPACTION_SUMMARY_PREFIX + m.summary + COMPACTION_SUMMARY_SUFFIX },
-						],
-						timestamp: m.timestamp,
-					};
-				case "user":
-				case "assistant":
-				case "toolResult":
-					return m;
-				default:
-					// biome-ignore lint/correctness/noSwitchDeclarations: fine
-					const _exhaustiveCheck: never = m;
-					return undefined;
-			}
-		})
-		.filter((m) => m !== undefined);
-}