pi-incarnate 0.1.0 → 0.2.0

package/src/mood.ts

@@ -50,5 +50,5 @@ export function composeMoodPrompt(config: MoodConfig, presetId: string | undefin
   if (!presetId) return undefined;
   const preset = config.presets.get(presetId);
   if (!preset) return undefined;
-  return `Current mood preset: ${preset.id}\n${preset.instruction}\nThe mood adjusts expression only; it does not override the character's identity, factual standards, or tool rules.`;
+  return `Current mood preset: ${preset.id}\nOnly this named preset is active; do not blend in other preset definitions from the character card.\n${preset.instruction}\nThe response must visibly demonstrate this preset; merely remaining compatible with it is not enough. Make it perceptible in wording, pacing, and response strategy without exaggerating it.\nThe mood adjusts expression only; it does not override the character's identity, factual standards, or tool rules.`;
 }

package/src/persona.ts

@@ -1,5 +1,6 @@
 import type { Character } from "./character-loader.ts";
 import { composeFormsPrompt } from "./forms.ts";
+import { removeLevelTwoSection } from "./markdown.ts";
 import { composeMoodPrompt } from "./mood.ts";
 
 const RUNTIME_RULES = `You are operating with a pi-incarnate character persona.
@@ -13,12 +14,13 @@ const RUNTIME_RULES = `You are operating with a pi-incarnate character persona.
 export function composePersonaPrompt(character: Character, currentMood?: string): string {
   const formsPrompt = composeFormsPrompt(character.forms);
   const moodPrompt = composeMoodPrompt(character.mood, currentMood);
+  const runtimeCard = removeLevelTwoSection(character.markdown, "Current Mood");
   return `${RUNTIME_RULES}
 
 Active character: ${character.name} (${character.id})
 
 <character-card>
-${character.markdown}
+${runtimeCard}
 </character-card>${formsPrompt ? `\n\n${formsPrompt}` : ""}${moodPrompt ? `\n\n${moodPrompt}` : ""}`;
 }
 

package/src/select-menu.ts

@@ -0,0 +1,70 @@
+import type { ExtensionCommandContext, Theme } from "@earendil-works/pi-coding-agent";
+import { Container, SelectList, Text, truncateToWidth, type TUI } from "@earendil-works/pi-tui";
+
+function supportsThemedMenu(ctx: ExtensionCommandContext): boolean {
+  return typeof ctx.ui.custom === "function" && ctx.ui.theme !== undefined;
+}
+
+function menuComponent(
+  tui: TUI,
+  theme: Theme,
+  title: string,
+  options: readonly string[],
+  done: (result: string | undefined) => void,
+) {
+  const container = new Container();
+  container.addChild(new Text(theme.fg("accent", theme.bold(title)), 1, 0));
+
+  const list = new SelectList(
+    options.map((option) => ({ value: option, label: option })),
+    Math.min(options.length, 12),
+    {
+      selectedPrefix: (text) => theme.fg("accent", text),
+      selectedText: (text) => theme.fg("accent", text),
+      description: (text) => theme.fg("muted", text),
+      scrollInfo: (text) => theme.fg("muted", text),
+      noMatch: (text) => theme.fg("warning", text),
+    },
+    {
+      truncatePrimary: ({ text, maxWidth, isSelected }) => {
+        const clipped = truncateToWidth(text, maxWidth, "");
+        // Keep the terminal's own foreground color so this remains readable even
+        // when Pi's configured theme does not match the terminal background.
+        return isSelected ? clipped : theme.bold(clipped);
+      },
+    },
+  );
+  list.onSelect = (item) => done(item.value);
+  list.onCancel = () => done(undefined);
+  container.addChild(list);
+  container.addChild(new Text(theme.fg("muted", "↑↓ navigate · Enter select · Esc cancel"), 1, 0));
+
+  return {
+    render: (width: number) => container.render(width),
+    invalidate: () => container.invalidate(),
+    handleInput(data: string) {
+      list.handleInput(data);
+      tui.requestRender();
+    },
+  };
+}
+
+export async function selectMenu(
+  ctx: ExtensionCommandContext,
+  title: string,
+  options: readonly string[],
+): Promise<string | undefined> {
+  if (options.length === 0) return undefined;
+  if (!supportsThemedMenu(ctx)) return ctx.ui.select(title, [...options]);
+  return ctx.ui.custom<string | undefined>((tui, theme, _keybindings, done) =>
+    menuComponent(tui, theme, title, options, done));
+}
+
+export async function confirmMenu(
+  ctx: ExtensionCommandContext,
+  title: string,
+  message: string,
+): Promise<boolean> {
+  if (!supportsThemedMenu(ctx)) return ctx.ui.confirm(title, message);
+  return await selectMenu(ctx, `${title}\n${message}`, ["Yes", "No"]) === "Yes";
+}

package/src/session-state.ts

@@ -1,15 +1,18 @@
 import type { Character } from "./character-loader.ts";
 
+export type AvatarMode = "auto" | "full" | "compact" | "off";
+
 export interface IncarnateStateSnapshot {
   activeCharacter?: Character;
   currentMood?: string;
+  avatarMode: AvatarMode;
   avatarEnabled: boolean;
 }
 
 export class IncarnateSessionState {
   #activeCharacter: Character | undefined;
   #currentMood: string | undefined;
-  #avatarEnabled = true;
+  #avatarMode: AvatarMode = "auto";
 
   get activeCharacter(): Character | undefined {
     return this.#activeCharacter;
@@ -20,7 +23,11 @@ export class IncarnateSessionState {
   }
 
   get avatarEnabled(): boolean {
-    return this.#avatarEnabled;
+    return this.#avatarMode !== "off";
+  }
+
+  get avatarMode(): AvatarMode {
+    return this.#avatarMode;
   }
 
   activate(character: Character): void {
@@ -41,19 +48,24 @@ export class IncarnateSessionState {
   }
 
   setAvatarEnabled(enabled: boolean): void {
-    this.#avatarEnabled = enabled;
+    this.#avatarMode = enabled ? "auto" : "off";
+  }
+
+  setAvatarMode(mode: AvatarMode): void {
+    this.#avatarMode = mode;
   }
 
   reset(): void {
     this.deactivate();
-    this.#avatarEnabled = true;
+    this.#avatarMode = "auto";
   }
 
   snapshot(): IncarnateStateSnapshot {
     return {
       activeCharacter: this.#activeCharacter,
       currentMood: this.#currentMood,
-      avatarEnabled: this.#avatarEnabled,
+      avatarMode: this.#avatarMode,
+      avatarEnabled: this.avatarEnabled,
     };
   }
 }

package/src/ui-protocol.ts

@@ -0,0 +1,66 @@
+import { visibleWidth } from "@earendil-works/pi-tui";
+
+import type { Avatar } from "./avatar.ts";
+import { characterSource, type CharacterLocations, type CharacterSource } from "./character-catalog.ts";
+import type { AvatarMode, IncarnateSessionState } from "./session-state.ts";
+
+export const UI_REQUEST_STATE_EVENT = "pi-incarnate:ui:request-state-v1";
+export const UI_STATE_EVENT = "pi-incarnate:ui:state-v1";
+
+export interface IncarnateUiStateV1 {
+  version: 1;
+  active: boolean;
+  avatarMode: AvatarMode;
+  character?: {
+    id: string;
+    name: string;
+    mood?: string;
+    source: CharacterSource;
+    forms: {
+      available: number;
+      total: number;
+    };
+  };
+  avatar?: {
+    lines: string[];
+    width: number;
+    height: number;
+    truncated: boolean;
+  };
+}
+
+export function isUiProtocolV1(value: unknown): boolean {
+  return Boolean(value && typeof value === "object" && (value as { version?: unknown }).version === 1);
+}
+
+export function createUiStateSnapshot(
+  state: IncarnateSessionState,
+  locations: CharacterLocations,
+  avatar: Avatar | undefined,
+): IncarnateUiStateV1 {
+  const character = state.activeCharacter;
+  if (!character) return { version: 1, active: false, avatarMode: state.avatarMode };
+
+  const availableForms = character.forms.filter((form) => form.status === "available").length;
+  const snapshot: IncarnateUiStateV1 = {
+    version: 1,
+    active: true,
+    avatarMode: state.avatarMode,
+    character: {
+      id: character.id,
+      name: character.name,
+      mood: state.currentMood,
+      source: characterSource(character, locations),
+      forms: { available: availableForms, total: character.forms.length },
+    },
+  };
+  if (avatar && state.avatarEnabled) {
+    snapshot.avatar = {
+      lines: [...avatar.lines],
+      width: avatar.lines.reduce((maximum, line) => Math.max(maximum, visibleWidth(line)), 0),
+      height: avatar.lines.length,
+      truncated: avatar.truncated,
+    };
+  }
+  return snapshot;
+}