@selesai/code 0.6.3 → 0.8.0

package/dist/extensions/pi-powerline-footer/lifecycle.ts

@@ -0,0 +1,10 @@
+export function shouldShowStartupWelcome(reason: unknown, welcomeEnabled: boolean): boolean {
+  return reason === "startup" && welcomeEnabled;
+}
+
+export function isStaleExtensionContextError(error: unknown): boolean {
+  return error instanceof Error && (
+    error.message.includes("This extension instance is stale")
+    || error.message.includes("This extension ctx is stale")
+  );
+}

package/dist/extensions/pi-powerline-footer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-powerline-footer",
-  "version": "0.5.4",
+  "version": "0.12.3",
   "description": "Powerline-style status bar extension for pi coding agent",
   "type": "module",
   "files": [
@@ -9,7 +9,8 @@
     "*.json",
     "!progress.md",
     "bash-mode/**/*.ts",
-    "fixed-editor/**/*.ts"
+    "fixed-editor/**/*.ts",
+    "queue/**/*.ts"
   ],
   "keywords": [
     "pi-package",
@@ -26,17 +27,20 @@
     "url": "git+https://github.com/nicobailon/pi-powerline-footer.git"
   },
   "scripts": {
+    "typecheck": "tsc --noEmit",
     "test": "node --experimental-strip-types --test tests/**/*.test.ts"
   },
   "peerDependencies": {
-    "@earendil-works/pi-ai": "^0.75.0",
+    "@earendil-works/pi-ai": ">=0.81.0 <0.84.0",
     "@selesai/code": "*",
-    "@earendil-works/pi-tui": "^0.75.0"
+    "@earendil-works/pi-tui": ">=0.81.0 <0.84.0"
   },
   "devDependencies": {
-    "@earendil-works/pi-ai": "^0.75.0",
+    "@earendil-works/pi-ai": "^0.83.0",
     "@selesai/code": "^0.1.0",
-    "@earendil-works/pi-tui": "^0.75.0"
+    "@earendil-works/pi-tui": "^0.83.0",
+    "@types/node": "24.13.3",
+    "typescript": "5.9.3"
   },
   "pi": {
     "extensions": [

package/dist/extensions/pi-powerline-footer/paths.ts

@@ -0,0 +1,22 @@
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { CONFIG_DIR_NAME, getAgentDir } from "@selesai/code";
+
+export function getHomeDir(): string {
+  return process.env.HOME || process.env.USERPROFILE || homedir();
+}
+
+export function getAgentPath(...segments: string[]): string {
+  return join(getAgentDir(), ...segments);
+}
+
+export function getLegacyPiPath(...segments: string[]): string {
+  return join(getHomeDir(), CONFIG_DIR_NAME, ...segments);
+}
+
+export function getAgentSessionDirs(): string[] {
+  const primary = getAgentPath("sessions");
+  const legacy = getLegacyPiPath("sessions");
+  return existsSync(legacy) && legacy !== primary ? [primary, legacy] : [primary];
+}

package/dist/extensions/pi-powerline-footer/powerline-config.ts

@@ -1,5 +1,7 @@
 import { visibleWidth } from "@earendil-works/pi-tui";
-import type { ColorValue, CustomItemPosition, CustomStatusItem, PresetDef, StatusLinePreset, StatusLineSegmentId } from "./types.ts";
+import { normalizeCostCurrency } from "./currency-rates.ts";
+import { BUILTIN_STATUS_LINE_SEGMENT_IDS } from "./types.ts";
+import type { ColorValue, CustomItemPosition, CustomStatusItem, PowerlinePlacement, PresetDef, StatusLineLayout, StatusLinePreset, StatusLineSegmentId, StatusLineSegmentOptions, StatusLineSeparatorStyle } from "./types.ts";
 
 export interface PowerlineConfig {
   preset: StatusLinePreset;
@@ -7,6 +9,17 @@ export interface PowerlineConfig {
   mouseScroll: boolean;
   fixedEditor: boolean;
   fixedEditorPromptGlyph: string;
+  disabledSegments: StatusLineSegmentId[];
+  invalidDisabledSegments: string[];
+  layout: StatusLineLayout | null;
+  invalidLayoutSegments: string[];
+  separator: StatusLineSeparatorStyle | null;
+  segmentOptions: StatusLineSegmentOptions;
+  placement: PowerlinePlacement;
+  invalidPlacement: string | null;
+  welcome: boolean;
+  stashSharpSShortcut: boolean;
+  queue: { captureSigil: string | false };
 }
 
 function isRecord(value: unknown): value is Record<string, unknown> {
@@ -19,6 +32,41 @@ function normalizePreset(value: unknown, presets: readonly StatusLinePreset[]):
   return (presets as readonly string[]).includes(normalized) ? (normalized as StatusLinePreset) : null;
 }
 
+function normalizePlacement(value: unknown): { placement: PowerlinePlacement; invalidPlacement: string | null } {
+  if (value === undefined) return { placement: "above", invalidPlacement: null };
+
+  const normalized = typeof value === "string" ? value.trim().toLowerCase() : "";
+  if (normalized === "above" || normalized === "below") {
+    return { placement: normalized, invalidPlacement: null };
+  }
+
+  return {
+    placement: "above",
+    invalidPlacement: typeof value === "string" ? value.trim() : String(value),
+  };
+}
+
+const SEPARATOR_STYLES = [
+  "powerline",
+  "powerline-thin",
+  "slash",
+  "pipe",
+  "block",
+  "none",
+  "ascii",
+  "dot",
+  "chevron",
+  "star",
+] as const satisfies readonly StatusLineSeparatorStyle[];
+
+function normalizeSeparator(value: unknown): StatusLineSeparatorStyle | null {
+  if (typeof value !== "string") return null;
+  const normalized = value.trim().toLowerCase();
+  return (SEPARATOR_STYLES as readonly string[]).includes(normalized)
+    ? (normalized as StatusLineSeparatorStyle)
+    : null;
+}
+
 function normalizeCustomItemId(value: unknown): string | null {
   if (typeof value !== "string") return null;
   const normalized = value.trim();
@@ -43,6 +91,13 @@ function normalizeCustomPrefix(value: unknown): string | undefined {
   return normalized ? normalized : undefined;
 }
 
+function normalizeCaptureSigil(value: unknown): string | false {
+  if (value === false) return false;
+  if (typeof value !== "string") return "#";
+  const normalized = value.trim();
+  return normalized && !/\s/.test(normalized) ? normalized : "#";
+}
+
 function normalizeCustomStatusItem(raw: unknown, idOverride?: string): CustomStatusItem | null {
   if (!isRecord(raw)) return null;
   const id = normalizeCustomItemId(idOverride ?? raw.id);
@@ -84,40 +139,267 @@ function normalizeCustomItems(raw: unknown): CustomStatusItem[] {
   return [...deduped.values()];
 }
 
+const BUILTIN_STATUS_LINE_SEGMENT_ID_SET = new Set<string>(BUILTIN_STATUS_LINE_SEGMENT_IDS);
+
+function normalizeStatusLineSegmentId(value: unknown, customItemIds: ReadonlySet<string>): StatusLineSegmentId | null {
+  if (typeof value !== "string") return null;
+
+  const normalized = value.trim();
+  if (BUILTIN_STATUS_LINE_SEGMENT_ID_SET.has(normalized)) {
+    return normalized as StatusLineSegmentId;
+  }
+
+  const customId = normalized.startsWith("custom:")
+    ? normalizeCustomItemId(normalized.slice("custom:".length))
+    : null;
+  return customId && customItemIds.has(customId) ? `custom:${customId}` : null;
+}
+
+function normalizeDisabledSegments(
+  raw: unknown,
+  customItems: readonly CustomStatusItem[],
+): { disabledSegments: StatusLineSegmentId[]; invalidDisabledSegments: string[] } {
+  if (!Array.isArray(raw)) return { disabledSegments: [], invalidDisabledSegments: [] };
+
+  const disabledSegments: StatusLineSegmentId[] = [];
+  const invalidDisabledSegments: string[] = [];
+  const customItemIds = new Set(customItems.map((item) => item.id));
+  const seen = new Set<StatusLineSegmentId>();
+
+  for (const entry of raw) {
+    const segmentId = normalizeStatusLineSegmentId(entry, customItemIds);
+    if (!segmentId) {
+      invalidDisabledSegments.push(typeof entry === "string" ? entry.trim() : String(entry));
+    } else if (!seen.has(segmentId)) {
+      seen.add(segmentId);
+      disabledSegments.push(segmentId);
+    }
+  }
+
+  return { disabledSegments, invalidDisabledSegments };
+}
+
+function normalizeLayout(
+  raw: unknown,
+  customItems: readonly CustomStatusItem[],
+): { layout: StatusLineLayout | null; invalidLayoutSegments: string[] } {
+  if (!isRecord(raw)) return { layout: null, invalidLayoutSegments: [] };
+
+  const layout: StatusLineLayout = {};
+  const invalidLayoutSegments: string[] = [];
+  const customItemIds = new Set(customItems.map((item) => item.id));
+  const globallyPlaced = new Set<StatusLineSegmentId>();
+
+  for (const row of ["left", "right", "secondary"] as const) {
+    const entries = raw[row];
+    if (!Array.isArray(entries)) continue;
+
+    const segments: StatusLineSegmentId[] = [];
+    const seen = new Set<StatusLineSegmentId>();
+    for (const entry of entries) {
+      const segmentId = normalizeStatusLineSegmentId(entry, customItemIds);
+      if (!segmentId) {
+        invalidLayoutSegments.push(`${row}:${typeof entry === "string" ? entry.trim() : String(entry)}`);
+      } else if (!seen.has(segmentId)) {
+        seen.add(segmentId);
+        if (globallyPlaced.has(segmentId)) {
+          invalidLayoutSegments.push(`${row}:${segmentId}`);
+        } else {
+          globallyPlaced.add(segmentId);
+          segments.push(segmentId);
+        }
+      }
+    }
+    layout[row] = segments;
+  }
+
+  return Object.keys(layout).length > 0
+    ? { layout, invalidLayoutSegments }
+    : { layout: null, invalidLayoutSegments };
+}
+
+function normalizeSegmentOptions(raw: Record<string, unknown>): StatusLineSegmentOptions {
+  const options: StatusLineSegmentOptions = {};
+
+  if (isRecord(raw.model)) {
+    options.model = {
+      ...(typeof raw.model.showThinkingLevel === "boolean" ? { showThinkingLevel: raw.model.showThinkingLevel } : {}),
+      ...(raw.model.display === "name" || raw.model.display === "qualified" ? { display: raw.model.display } : {}),
+    };
+  }
+
+  if (isRecord(raw.path)) {
+    options.path = {
+      ...(raw.path.mode === "basename" || raw.path.mode === "abbreviated" || raw.path.mode === "full" ? { mode: raw.path.mode } : {}),
+      ...(typeof raw.path.maxLength === "number" && Number.isFinite(raw.path.maxLength) && raw.path.maxLength > 0
+        ? { maxLength: Math.floor(raw.path.maxLength) }
+        : {}),
+    };
+  }
+
+  if (isRecord(raw.git)) {
+    options.git = {
+      ...(typeof raw.git.showBranch === "boolean" ? { showBranch: raw.git.showBranch } : {}),
+      ...(typeof raw.git.showStaged === "boolean" ? { showStaged: raw.git.showStaged } : {}),
+      ...(typeof raw.git.showUnstaged === "boolean" ? { showUnstaged: raw.git.showUnstaged } : {}),
+      ...(typeof raw.git.showUntracked === "boolean" ? { showUntracked: raw.git.showUntracked } : {}),
+      ...(raw.git.polling === "full" || raw.git.polling === "branch" || raw.git.polling === "off" ? { polling: raw.git.polling } : {}),
+      ...(typeof raw.git.hostIcon === "boolean" ? { hostIcon: raw.git.hostIcon } : {}),
+    };
+  }
+
+  if (isRecord(raw.time)) {
+    options.time = {
+      ...(raw.time.format === "12h" || raw.time.format === "24h" ? { format: raw.time.format } : {}),
+      ...(typeof raw.time.showSeconds === "boolean" ? { showSeconds: raw.time.showSeconds } : {}),
+    };
+  }
+
+  if (isRecord(raw.cost)) {
+    const currency = normalizeCostCurrency(raw.cost.currency);
+    options.cost = {
+      ...(raw.cost.subscriptionDisplay === "subscription"
+        || raw.cost.subscriptionDisplay === "reported-cost"
+        || raw.cost.subscriptionDisplay === "both"
+        ? { subscriptionDisplay: raw.cost.subscriptionDisplay }
+        : {}),
+      ...(currency ? { currency } : {}),
+    };
+  }
+
+  if (isRecord(raw.context)) {
+    options.context = {
+      ...(raw.context.format === "full" || raw.context.format === "percent" ? { format: raw.context.format } : {}),
+    };
+  }
+
+  if (isRecord(raw.cache_read)) {
+    options.cache_read = {
+      ...(raw.cache_read.format === "tokens" || raw.cache_read.format === "percent" || raw.cache_read.format === "both"
+        ? { format: raw.cache_read.format }
+        : {}),
+    };
+  }
+
+  return options;
+}
+
+export function mergeSegmentOptions(
+  defaults: StatusLineSegmentOptions = {},
+  overrides: StatusLineSegmentOptions = {},
+): StatusLineSegmentOptions {
+  return {
+    ...defaults,
+    ...overrides,
+    model: { ...defaults.model, ...overrides.model },
+    path: { ...defaults.path, ...overrides.path },
+    git: { ...defaults.git, ...overrides.git },
+    time: { ...defaults.time, ...overrides.time },
+    cost: { ...defaults.cost, ...overrides.cost },
+    context: { ...defaults.context, ...overrides.context },
+    cache_read: { ...defaults.cache_read, ...overrides.cache_read },
+  };
+}
+
 export function parsePowerlineConfig(value: unknown, presets: readonly StatusLinePreset[]): PowerlineConfig {
-  const defaultConfig: PowerlineConfig = { preset: "default", customItems: [], mouseScroll: true, fixedEditor: true, fixedEditorPromptGlyph: "" };
+  const defaultConfig: PowerlineConfig = {
+    preset: "default",
+    customItems: [],
+    mouseScroll: true,
+    fixedEditor: true,
+    fixedEditorPromptGlyph: "",
+    disabledSegments: [],
+    invalidDisabledSegments: [],
+    layout: null,
+    invalidLayoutSegments: [],
+    separator: null,
+    segmentOptions: {},
+    placement: "above",
+    invalidPlacement: null,
+    welcome: true,
+    stashSharpSShortcut: false,
+    queue: { captureSigil: "#" },
+  };
 
   const directPreset = normalizePreset(value, presets);
   if (directPreset) return { ...defaultConfig, preset: directPreset };
 
   if (!isRecord(value)) return defaultConfig;
 
+  const customItems = normalizeCustomItems(value.customItems);
+  const { disabledSegments, invalidDisabledSegments } = normalizeDisabledSegments(value.disabledSegments, customItems);
+  const { layout, invalidLayoutSegments } = normalizeLayout(value.layout, customItems);
+  const { placement, invalidPlacement } = normalizePlacement(value.placement);
+  const queue = isRecord(value.queue)
+    ? { captureSigil: normalizeCaptureSigil(value.queue.captureSigil) }
+    : defaultConfig.queue;
+
   return {
     preset: normalizePreset(value.preset, presets) ?? defaultConfig.preset,
-    customItems: normalizeCustomItems(value.customItems),
+    customItems,
     mouseScroll: value.mouseScroll !== false,
     fixedEditor: value.fixedEditor !== false,
     fixedEditorPromptGlyph: typeof value.fixedEditorPromptGlyph === "string" ? value.fixedEditorPromptGlyph : defaultConfig.fixedEditorPromptGlyph,
+    disabledSegments,
+    invalidDisabledSegments,
+    layout,
+    invalidLayoutSegments,
+    separator: normalizeSeparator(value.separator),
+    segmentOptions: normalizeSegmentOptions(value),
+    placement,
+    invalidPlacement,
+    welcome: value.welcome !== false,
+    stashSharpSShortcut: value.stashSharpSShortcut === true,
+    queue,
   };
 }
 
-export function mergeSegmentsWithCustomItems(presetDef: PresetDef, customItems: readonly CustomStatusItem[]): {
+export function mergeSegmentsWithCustomItems(
+  presetDef: PresetDef,
+  customItems: readonly CustomStatusItem[],
+  options: {
+    layout?: StatusLineLayout | null;
+    disabledSegments?: readonly StatusLineSegmentId[];
+  } = {},
+): {
   leftSegments: StatusLineSegmentId[];
   rightSegments: StatusLineSegmentId[];
   secondarySegments: StatusLineSegmentId[];
 } {
-  const left: StatusLineSegmentId[] = [...presetDef.leftSegments];
-  const right: StatusLineSegmentId[] = [...presetDef.rightSegments];
-  const secondary: StatusLineSegmentId[] = [...(presetDef.secondarySegments ?? [])];
+  const layout = options.layout ?? null;
+  const explicitlyPlaced = new Set([
+    ...(layout?.left ?? []),
+    ...(layout?.right ?? []),
+    ...(layout?.secondary ?? []),
+  ]);
+  const disabled = new Set(options.disabledSegments ?? []);
 
-  for (const item of customItems) {
-    const segmentId: StatusLineSegmentId = `custom:${item.id}`;
-    if (item.position === "left") left.push(segmentId);
-    else if (item.position === "secondary") secondary.push(segmentId);
-    else right.push(segmentId);
-  }
+  const buildRow = (
+    position: CustomItemPosition,
+    configured: StatusLineSegmentId[] | undefined,
+    presetSegments: readonly StatusLineSegmentId[],
+  ): StatusLineSegmentId[] => {
+    const segments = configured !== undefined
+      ? [...configured]
+      : presetSegments.filter((id) => !explicitlyPlaced.has(id));
+
+    if (configured === undefined) {
+      for (const item of customItems) {
+        const segmentId: StatusLineSegmentId = `custom:${item.id}`;
+        if (item.position === position && !explicitlyPlaced.has(segmentId)) {
+          segments.push(segmentId);
+        }
+      }
+    }
 
-  return { leftSegments: left, rightSegments: right, secondarySegments: secondary };
+    return segments.filter((id) => !disabled.has(id));
+  };
+
+  return {
+    leftSegments: buildRow("left", layout?.left, presetDef.leftSegments),
+    rightSegments: buildRow("right", layout?.right, presetDef.rightSegments),
+    secondarySegments: buildRow("secondary", layout?.secondary, presetDef.secondarySegments ?? []),
+  };
 }
 
 export function nextPowerlineSettingWithPreset(existingPowerlineSetting: unknown, preset: StatusLinePreset): unknown {
@@ -129,7 +411,7 @@ export function nextPowerlineSettingWithPreset(existingPowerlineSetting: unknown
 
 export function nextPowerlineSettingWithOptions(
   existingPowerlineSetting: unknown,
-  updates: Partial<Pick<PowerlineConfig, "mouseScroll" | "fixedEditor">>,
+  updates: Partial<Pick<PowerlineConfig, "welcome" | "stashSharpSShortcut" | "placement">>,
   currentPreset: StatusLinePreset,
 ): unknown {
   if (!isRecord(existingPowerlineSetting)) {

package/dist/extensions/pi-powerline-footer/presets.ts

@@ -23,9 +23,9 @@ const NERD_COLORS: ColorScheme = {
 
 export const PRESETS: Record<StatusLinePreset, PresetDef> = {
   default: {
-    leftSegments: ["model", "thinking", "shell_mode", "path", "git", "context_pct", "cache_read", "cost"],
+    leftSegments: ["model", "thinking", "shell_mode", "path", "git", "queue", "context_pct", "cache_read", "cost"],
     rightSegments: [],
-    secondarySegments: ["session_name", "extension_statuses"],
+    secondarySegments: ["extension_statuses"],
     separator: "powerline-thin",
     colors: DEFAULT_COLORS,
     segmentOptions: {
@@ -38,7 +38,6 @@ export const PRESETS: Record<StatusLinePreset, PresetDef> = {
   minimal: {
     leftSegments: ["shell_mode", "path", "git"],
     rightSegments: ["context_pct"],
-    secondarySegments: ["session_name"],
     separator: "slash",
     colors: MINIMAL_COLORS,
     segmentOptions: {
@@ -49,8 +48,7 @@ export const PRESETS: Record<StatusLinePreset, PresetDef> = {
 
   compact: {
     leftSegments: ["model", "shell_mode", "git"],
-    rightSegments: ["cost", "context_pct"],
-    secondarySegments: ["session_name"],
+    rightSegments: ["queue", "cost", "context_pct"],
     separator: "powerline-thin",
     colors: DEFAULT_COLORS,
     segmentOptions: {
@@ -60,9 +58,8 @@ export const PRESETS: Record<StatusLinePreset, PresetDef> = {
   },
 
   full: {
-    leftSegments: ["hostname", "model", "thinking", "shell_mode", "path", "git", "subagents"],
+    leftSegments: ["hostname", "model", "thinking", "shell_mode", "path", "git", "queue", "subagents"],
     rightSegments: ["token_in", "token_out", "cache_read", "cost", "context_pct", "time_spent", "time", "extension_statuses"],
-    secondarySegments: ["session_name"],
     separator: "powerline",
     colors: DEFAULT_COLORS,
     segmentOptions: {
@@ -74,9 +71,8 @@ export const PRESETS: Record<StatusLinePreset, PresetDef> = {
   },
 
   nerd: {
-    leftSegments: ["hostname", "model", "thinking", "shell_mode", "path", "git", "session", "subagents"],
+    leftSegments: ["hostname", "model", "thinking", "shell_mode", "path", "git", "queue", "session", "subagents"],
     rightSegments: ["token_in", "token_out", "cache_read", "cache_write", "cost", "context_pct", "context_total", "time_spent", "time", "extension_statuses"],
-    secondarySegments: ["session_name"],
     separator: "powerline",
     colors: NERD_COLORS,
     segmentOptions: {
@@ -89,8 +85,7 @@ export const PRESETS: Record<StatusLinePreset, PresetDef> = {
 
   ascii: {
     leftSegments: ["model", "shell_mode", "path", "git"],
-    rightSegments: ["token_total", "cost", "context_pct"],
-    secondarySegments: ["session_name"],
+    rightSegments: ["queue", "token_total", "cost", "context_pct"],
     separator: "ascii",
     colors: MINIMAL_COLORS,
     segmentOptions: {
@@ -100,20 +95,6 @@ export const PRESETS: Record<StatusLinePreset, PresetDef> = {
     },
   },
 
-  custom: {
-    // {model} {thinking-without-think-prefix} | {path-full-relative-home} | {git} | {subagents}
-    // | {token_in}({cache_read}) · {token_out} {token_total} · {cost} | {context_pct}
-    leftSegments: ["identity_group", "path", "git", "subagents"],
-    rightSegments: ["context_pct"],
-    secondarySegments: ["session_name", "usage_group"],
-    separator: "pipe",
-    colors: DEFAULT_COLORS,
-    segmentOptions: {
-      model: { showThinkingLevel: false },
-      path: { mode: "full" },
-      git: { showBranch: true, showStaged: true, showUnstaged: true, showUntracked: true },
-    },
-  },
 };
 
 export function getPreset(name: StatusLinePreset): PresetDef {