Files
ponytail/pi-extension/index.js
DietrichGebert c8b12b6384 fix(pi-extension): guard status bar render when ui has no theme (#279)
syncStatus guarded setStatus but used theme.fg unguarded, so a Pi host
exposing setStatus without a theme threw TypeError on session_start (and
agent_start/agent_end/setMode). Require both before rendering.

Add tests for the render path (previously untested) and the theme-absent
degradation. Follow-up to #275 / #84.
2026-06-24 01:10:04 +02:00

190 lines
6.0 KiB
JavaScript

import { createRequire } from "node:module";
const require = createRequire(import.meta.url);
const {
DEFAULT_MODE,
getDefaultMode,
normalizeMode,
normalizeConfigMode,
normalizePersistedMode,
isDeactivationCommand,
writeDefaultMode,
} = require("../hooks/ponytail-config.js");
const { getPonytailInstructions, filterSkillBodyForMode } = require("../hooks/ponytail-instructions.js");
export { filterSkillBodyForMode };
export const readDefaultMode = getDefaultMode;
export function resolveSessionMode(entries, fallbackMode = DEFAULT_MODE) {
const fallback = normalizePersistedMode(fallbackMode) || DEFAULT_MODE;
if (!Array.isArray(entries)) return fallback;
for (let i = entries.length - 1; i >= 0; i -= 1) {
const entry = entries[i];
if (entry?.type !== "custom" || entry?.customType !== "ponytail-mode") continue;
const mode = normalizePersistedMode(entry?.data?.mode);
if (mode) return mode;
}
return fallback;
}
export function parsePonytailCommand(text, defaultMode = DEFAULT_MODE) {
const fallback = normalizePersistedMode(defaultMode) || DEFAULT_MODE;
const normalizedText = String(text || "").trim().toLowerCase();
if (!normalizedText) {
return { type: "set-mode", mode: fallback === "off" ? "full" : fallback };
}
const [primary, secondary] = normalizedText.split(/\s+/);
if (primary === "status") return { type: "status" };
if (primary === "default") {
const mode = normalizeConfigMode(secondary);
return mode ? { type: "set-default", mode } : { type: "invalid", reason: "invalid-default-mode" };
}
const mode = normalizeMode(primary);
return mode ? { type: "set-mode", mode } : { type: "invalid", reason: "invalid-mode", mode: primary };
}
export { writeDefaultMode };
export default function ponytailExtension(pi) {
let currentMode = DEFAULT_MODE;
let configuredDefaultMode = getDefaultMode();
let isActive = false;
let lastCtx = null;
// -- Status bar --
function syncStatus(ctx) {
if (ctx) lastCtx = ctx;
const c = ctx || lastCtx;
if (!c?.ui?.setStatus || !c.ui.theme?.fg) return;
const theme = c.ui.theme;
if (currentMode === "off") {
c.ui.setStatus("ponytail", "");
return;
}
const levelIcons = { lite: "🌿", full: "⚡", ultra: "🔥" };
const icon = levelIcons[currentMode] || "";
const label = currentMode.toUpperCase();
const indicator = isActive ? theme.fg("accent", "●") : theme.fg("dim", "○");
c.ui.setStatus("ponytail", indicator + " 🐴 " + theme.fg("muted", "ponytail: ") + theme.fg("text", icon + " " + label));
}
const setMode = (mode, ctx) => {
const normalized = normalizePersistedMode(mode);
if (!normalized) return;
currentMode = normalized;
pi.appendEntry("ponytail-mode", { mode: normalized });
syncStatus(ctx);
ctx?.ui?.notify?.(`Ponytail mode set to ${normalized}.`, "info");
};
const sendAlias = (skillName, args, ctx) => {
const normalized = String(args || "").trim();
const message = normalized ? `${skillName} ${normalized}` : skillName;
if (ctx?.isIdle?.() === false) {
pi.sendUserMessage(message, { deliverAs: "followUp" });
ctx?.ui?.notify?.(`${skillName} queued as follow-up.`, "info");
return;
}
pi.sendUserMessage(message);
};
pi.registerCommand("ponytail", {
description: "Set or report Ponytail mode",
handler: async (args, ctx) => {
const parsed = parsePonytailCommand(args, configuredDefaultMode);
if (parsed.type === "status") {
ctx?.ui?.notify?.(`Ponytail: current ${currentMode} • default ${configuredDefaultMode}`, "info");
return;
}
if (parsed.type === "set-default") {
const written = writeDefaultMode(parsed.mode);
if (written) {
configuredDefaultMode = getDefaultMode();
const message = configuredDefaultMode === written
? `Default Ponytail mode set to ${written}.`
: `Saved default ${written}, but env override keeps default at ${configuredDefaultMode}.`;
ctx?.ui?.notify?.(message, "info");
}
return;
}
if (parsed.type === "set-mode") {
setMode(parsed.mode, ctx);
return;
}
ctx?.ui?.notify?.("Unknown or unsupported /ponytail mode.", "warning");
},
});
pi.registerCommand("ponytail-review", {
description: "Run /skill:ponytail-review",
handler: (_args, ctx) => sendAlias("/skill:ponytail-review", "", ctx),
});
pi.registerCommand("ponytail-audit", {
description: "Run /skill:ponytail-audit",
handler: (_args, ctx) => sendAlias("/skill:ponytail-audit", "", ctx),
});
pi.registerCommand("ponytail-gain", {
description: "Run /skill:ponytail-gain",
handler: (_args, ctx) => sendAlias("/skill:ponytail-gain", "", ctx),
});
pi.registerCommand("ponytail-debt", {
description: "Run /skill:ponytail-debt",
handler: (_args, ctx) => sendAlias("/skill:ponytail-debt", "", ctx),
});
pi.registerCommand("ponytail-help", {
description: "Run /skill:ponytail-help",
handler: (_args, ctx) => sendAlias("/skill:ponytail-help", "", ctx),
});
pi.on("input", async (event) => {
if (event?.source === "extension") return;
const text = String(event?.text || "");
if (currentMode !== "off" && isDeactivationCommand(text)) {
setMode("off");
}
});
pi.on("session_start", async (_event, ctx) => {
const entries = ctx?.sessionManager?.getBranch?.() || ctx?.sessionManager?.getEntries?.() || [];
configuredDefaultMode = getDefaultMode();
currentMode = resolveSessionMode(entries, configuredDefaultMode);
syncStatus(ctx);
ctx?.ui?.notify?.(`Ponytail loaded: ${currentMode}`, "info");
});
pi.on("agent_start", async (_event, ctx) => {
isActive = true;
syncStatus(ctx);
});
pi.on("agent_end", async (_event, ctx) => {
isActive = false;
syncStatus(ctx);
});
pi.on("before_agent_start", async (event) => {
if (!currentMode || currentMode === "off") return;
return { systemPrompt: `${event.systemPrompt}\n\n${getPonytailInstructions(currentMode)}` };
});
}