@mgiles/perk 1.0.1

package/extension/vendor/btw/core.ts

@@ -0,0 +1,153 @@
+// btw — extracted pure core (the perk extracted-core pattern: pure helpers split out so they are
+// unit-testable offline, without constructing a live pi session/overlay).
+//
+// Vendored from `mitsuhiko/agent-stuff` `extensions/btw.ts` (MIT) and adapted for perk: the helpers
+// below were lifted verbatim except for the conformance changes called out inline (the extended
+// `stripDynamicSystemPromptFooter` regex; `sideSessionTools`, the perk gate-mirror; and the §5
+// themed-glyph conformance in `renderToolCallLines`/`renderErrorLine` — `❌`→`✗`, running `⚙`→`▸`).
+
+import { truncateToWidth } from "@earendil-works/pi-tui";
+
+/** The minimal theme surface the pure renderers need (pi's real `Theme` satisfies it). */
+export interface ThemeLike {
+  fg(color: string, text: string): string;
+}
+
+export type ToolCallStatus = "running" | "done" | "error";
+
+export interface ToolCallInfo {
+  toolCallId: string;
+  toolName: string;
+  args: string;
+  status: ToolCallStatus;
+}
+
+/** A thread item as `formatThread` consumes it (the question/answer subset of `BtwDetails`). */
+export interface ThreadItemLike {
+  question: string;
+  answer: string;
+}
+
+/**
+ * Strip pi's dynamic system-prompt footer (the trailing `Current date…` / `Current working
+ * directory:` lines) so the side session's seeded system prompt is stable.
+ *
+ * perk conformance: the live perk/pi prompt footer reads `Current date:` (not `Current date and
+ * time:`), so this also strips the `Current date:` form. The original only matched
+ * `Current date and time:`.
+ */
+export function stripDynamicSystemPromptFooter(systemPrompt: string): string {
+  return systemPrompt
+    .replace(/\nCurrent date(?: and time)?:[^\n]*(?:\nCurrent working directory:[^\n]*)?$/u, "")
+    .replace(/\nCurrent working directory:[^\n]*$/u, "")
+    .trim();
+}
+
+/** Join the text parts of an assistant message's content into a trimmed string. */
+export function extractText(parts: readonly { type: string; text?: string }[]): string {
+  return parts
+    .filter((part) => part.type === "text")
+    .map((part) => part.text ?? "")
+    .join("\n")
+    .trim();
+}
+
+/** Extract the assistant text from a raw stream event message (defensive, untyped input). */
+export function extractEventAssistantText(message: unknown): string {
+  if (!message || typeof message !== "object") {
+    return "";
+  }
+
+  const maybeMessage = message as { role?: unknown; content?: unknown };
+  if (maybeMessage.role !== "assistant" || !Array.isArray(maybeMessage.content)) {
+    return "";
+  }
+
+  return maybeMessage.content
+    .filter((part): part is { type: "text"; text: string } => {
+      return !!part && typeof part === "object" && (part as { type?: unknown }).type === "text";
+    })
+    .map((part) => part.text)
+    .join("\n")
+    .trim();
+}
+
+/**
+ * The pure core of `getLastAssistantMessage`: the last `role === "assistant"` message in an array,
+ * or null. `btw.ts` calls it with `session.state.messages`.
+ */
+export function lastAssistantMessage<T extends { role: string }>(messages: readonly T[]): T | null {
+  for (let i = messages.length - 1; i >= 0; i--) {
+    const message = messages[i];
+    if (message && message.role === "assistant") {
+      return message;
+    }
+  }
+  return null;
+}
+
+/** Format a side thread for summary handoff (`User: …\nAssistant: …`, `---`-separated). */
+export function formatThread(thread: readonly ThreadItemLike[]): string {
+  return thread
+    .map((item) => `User: ${item.question.trim()}\nAssistant: ${item.answer.trim()}`)
+    .join("\n\n---\n\n");
+}
+
+/** Render the first argument of a tool call to a short label (truncated for the transcript). */
+export function formatToolArgs(toolName: string, args: unknown): string {
+  if (!args || typeof args !== "object") return "";
+  const a = args as Record<string, unknown>;
+  switch (toolName) {
+    case "bash":
+      return typeof a.command === "string"
+        ? truncateToWidth(a.command.split("\n")[0] ?? "", 50, "…")
+        : "";
+    case "read":
+    case "write":
+    case "edit":
+      return typeof a.path === "string" ? a.path : "";
+    default: {
+      const first = Object.values(a)[0];
+      return typeof first === "string" ? truncateToWidth(first.split("\n")[0] ?? "", 40, "…") : "";
+    }
+  }
+}
+
+/**
+ * The gate-mirror decision (plan decision 1): the side session's toolset mirrors perk's read-only
+ * gate. When read-only it gets `["read"]` only — a foreign session's `bash` cannot be sandboxed by
+ * perk's `isReadOnlyBashCommand`, so `bash` is excluded under read-only — preserving perk's
+ * structural read-only guarantee; when read-write it gets the full set.
+ */
+export function sideSessionTools(readOnly: boolean): string[] {
+  return readOnly ? ["read"] : ["read", "bash", "edit", "write"];
+}
+
+/**
+ * The themed tool-call transcript lines (§5-conformed glyphs): running `▸` (`accent`), error `✗`
+ * (`error`), done `✓` (`success`). Every line is width-truncated (the §4 D9 never-exceed-`width`
+ * law). The charter-time `⚙` running glyph is conformed to `▸`.
+ */
+export function renderToolCallLines(
+  toolCalls: readonly ToolCallInfo[],
+  theme: ThemeLike,
+  width: number,
+): string[] {
+  const lines: string[] = [];
+  for (const tc of toolCalls) {
+    const icon = tc.status === "running" ? "▸" : tc.status === "error" ? "✗" : "✓";
+    const color = tc.status === "running" ? "accent" : tc.status === "error" ? "error" : "success";
+    const label = theme.fg(color, `${icon} `) + theme.fg("toolTitle", tc.toolName);
+    const argsText = tc.args ? theme.fg("dim", ` ${tc.args}`) : "";
+    lines.push(truncateToWidth(`  ${label}${argsText}`, width, ""));
+  }
+  return lines;
+}
+
+/**
+ * The themed pending-error transcript line (§5-conformed): the charter-time `❌` error glyph is
+ * conformed to the themed `✗` (`error`).
+ */
+export function renderErrorLine(theme: ThemeLike, message: string): string {
+  return theme.fg("error", `✗ ${message}`);
+}

package/extension/vendor/whimsical/whimsical.ts

@@ -0,0 +1,485 @@
+// whimsical — replaces pi's "Working…" streaming message with a random whimsical phrase each turn.
+//
+// Vendored from `mitsuhiko/agent-stuff` `extensions/whimsical.ts` (MIT). Adapted for perk:
+//   - `registerWhimsical(pi)` wrapper (the perk registerX pattern) over the original default export;
+//   - the per-turn `ctx.ui.setWorkingMessage(...)` calls route through the headless-safe
+//     `setWorkingMessage` surfaces seam (charter §6: text-only, permitted, headless-no-op — distinct
+//     from the declined `setWorkingIndicator`).
+//
+// Ships always on — no config toggle (plan decision 3).
+
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { setWorkingMessage } from "../../surfaces/surfaces.ts";
+
+export const messages = [
+  // Short
+  "Schlepping...",
+  "Combobulating...",
+  "Doing...",
+  "Channelling...",
+  "Vibing...",
+  "Concocting...",
+  "Spelunking...",
+  "Transmuting...",
+  "Imagining...",
+  "Pontificating...",
+  "Whirring...",
+  "Cogitating...",
+  "Honking...",
+  "Flibbertigibbeting...",
+  "Noodling...",
+  "Percolating...",
+  "Ruminating...",
+  "Simmering...",
+  "Marinating...",
+  "Fermenting...",
+  "Gestating...",
+  "Hatching...",
+  "Brewing...",
+  "Steeping...",
+  "Contemplating...",
+  "Musing...",
+  "Pondering...",
+  "Mulling...",
+  "Daydreaming...",
+  "Woolgathering...",
+  "Dithering...",
+  "Faffing...",
+  "Puttering...",
+  "Tinkering...",
+  "Fiddling...",
+  "Noodging...",
+  "Finagling...",
+  "Wrangling...",
+  "Jiggling...",
+  "Wiggling...",
+  "Shimmying...",
+  "Galumphing...",
+  "Perambulating...",
+  "Meandering...",
+  "Traipsing...",
+  "Moseying...",
+  "Sauntering...",
+  "Ambling...",
+  "Pottering...",
+  "Bumbling...",
+  "Futzing...",
+  "Schmalzing...",
+  "Kerfuffling...",
+  "Bamboozling...",
+  "Discombobulating...",
+  "Recombobulating...",
+  "Unbefuddling...",
+  "Defenestrating...",
+  "Confabulating...",
+  "Persnicketing...",
+  "Flummoxing...",
+  "Befuddling...",
+  "Snorkeling...",
+  "Yodeling...",
+  "Zigzagging...",
+  "Ricocheting...",
+  "Somersaulting...",
+  "Pirouetting...",
+  "Canoodling...",
+  "Schmoozing...",
+  "Kibbitzing...",
+  "Skedaddling...",
+  "Scampering...",
+  "Skittering...",
+  "Sashaying...",
+  "Swashbuckling...",
+  "Oscillating...",
+  "Undulating...",
+  "Pulsating...",
+  "Effervescing...",
+  "Fizzing...",
+  "Bubbling...",
+  "Perplexing...",
+  "Mystifying...",
+  "Enchanting...",
+  "Bewitching...",
+  "Beguiling...",
+  "Mesmerizing...",
+  "Bedazzling...",
+  "Sparkling...",
+  "Glittering...",
+  "Scintillating...",
+  "Coruscating...",
+  "Phosphorescing...",
+  "Luminescing...",
+  "Sublimating...",
+  "Synthesizing...",
+  "Amalgamating...",
+  "Procrastinating...",
+  "Dillydallying...",
+  "Lollygagging...",
+  "Dawdling...",
+  "Malingering...",
+  "Skulking...",
+  "Lurking...",
+  "Sleuthing...",
+  "Rummaging...",
+  "Fossicking...",
+  "Foraging...",
+  "Scavenging...",
+  "Absquatulating...",
+  "Vamoosing...",
+  "Absconding...",
+  "Grooving...",
+  "Jamming...",
+  "Improvising...",
+  "Extemporizing...",
+  "Freestyling...",
+  "Frolicking...",
+  "Gamboling...",
+  "Blorping...",
+  "Flonking...",
+  "Snurfling...",
+  "Whomping...",
+  "Zorping...",
+  "Biffing...",
+  "Splunging...",
+  "Thwacking...",
+  "Gonkulating...",
+  "Splorfing...",
+  "Wibbling...",
+  "Wobbling...",
+  "Squonking...",
+  "Plonking...",
+  "Bonking...",
+  "Zonking...",
+  "Flumping...",
+  "Clomping...",
+  "Squelching...",
+  "Schlurping...",
+  "Glurping...",
+  "Burbling...",
+  "Gurgling...",
+  "Splooshing...",
+  "Whooshing...",
+  "Swooshing...",
+  "Kerplunking...",
+  "Thunking...",
+  "Clunking...",
+  "Clanking...",
+  "Rattling...",
+  "Jostling...",
+  "Rustling...",
+  "Bustling...",
+  "Hustling...",
+  "Miffing...",
+  "Boffing...",
+  "Snazzifying...",
+  "Pizzazzing...",
+  "Razzmatazzing...",
+  "Bedoodling...",
+  "Doodling...",
+  "Scribbling...",
+  "Squiggling...",
+  "Wriggling...",
+  "Niggling...",
+  "Higgling...",
+  "Piggling...",
+  "Figgling...",
+  "Gibbering...",
+  "Jabbering...",
+  "Blathering...",
+  "Blithering...",
+  "Withering...",
+  "Slithering...",
+  "Tethering...",
+  "Feathering...",
+  "Weathering...",
+  "Leathering...",
+  "Heathering...",
+  "Smoldering...",
+  "Moldering...",
+  "Shouldering...",
+  "Bouldering...",
+  "Tottering...",
+  "Teetering...",
+  "Tittering...",
+  "Flittering...",
+  "Jittering...",
+  "Frittering...",
+  "Twittering...",
+  "Nattering...",
+  "Chattering...",
+  "Clattering...",
+  "Splattering...",
+  "Battering...",
+  "Scattering...",
+  "Shattering...",
+  "Flattering...",
+  "Pattering...",
+  "Tattering...",
+  "Mattering...",
+  "Yammering...",
+  "Hammering...",
+  "Stammering...",
+  "Clamoring...",
+  "Glamoring...",
+  "Enamoring...",
+  "Shimmering...",
+  "Glimmering...",
+  "Brimming...",
+  "Skimming...",
+  "Trimming...",
+  "Primming...",
+  "Whimming...",
+  "Humming...",
+  "Strumming...",
+  "Thrumming...",
+  "Drumming...",
+  "Plumbing...",
+  "Thumbing...",
+  "Numbing...",
+  "Fumbling...",
+  "Grumbling...",
+  "Mumbling...",
+  "Rumbling...",
+  "Stumbling...",
+  "Tumbling...",
+  "Crumbling...",
+  "Jumbling...",
+  "Humbling...",
+  "Bungling...",
+  "Jungling...",
+  "Mangling...",
+  "Wangling...",
+  "Dangling...",
+  "Tangling...",
+  "Jangling...",
+  "Angling...",
+  "Struggling...",
+  "Mingling...",
+  "Tingling...",
+  "Jingling...",
+  "Singling...",
+  "Ringling...",
+  "Kingling...",
+
+  // Long
+  "Consulting the void...",
+  "Asking the electrons...",
+  "Bribing the compiler...",
+  "Negotiating with entropy...",
+  "Whispering to the bits...",
+  "Tickling the stack...",
+  "Massaging the heap...",
+  "Appeasing the garbage collector...",
+  "Summoning semicolons...",
+  "Herding pointers...",
+  "Untangling spaghetti...",
+  "Polishing the algorithms...",
+  "Waxing philosophical...",
+  "Consulting ancient scrolls...",
+  "Reading tea leaves...",
+  "Shaking the magic 8-ball...",
+  "Sacrificing to the demo gods...",
+  "Warming up the hamsters...",
+  "Spinning up the squirrels...",
+  "Caffeinating...",
+  "Existentially questioning...",
+  "Having a little think...",
+  "Stroking chin thoughtfully...",
+  "Squinting at the problem...",
+  "Staring into the abyss...",
+  "Abyss staring back...",
+  "Achieving enlightenment...",
+  "Transcending mere computation...",
+  "Ascending to a higher plane...",
+  "Communing with the machine spirit...",
+  "Performing arcane rituals...",
+  "Invoking elder functions...",
+  "Consulting the oracle...",
+  "Divining the answer...",
+  "Scrying the codebase...",
+  "Dowsing for bugs...",
+  "Rearranging deck chairs...",
+  "Shuffling bits around...",
+  "Aligning the chakras...",
+  "Reticulating splines...",
+  "Reversing the polarity...",
+  "Calibrating the flux capacitor...",
+  "Charging the crystals...",
+  "Tuning the vibrations...",
+  "Adjusting the cosmic frequency...",
+  "Waiting for a sign...",
+  "Hoping for the best...",
+  "Manifesting solutions...",
+  "Willing it into existence...",
+  "Believing really hard...",
+  "Politely asking the CPU...",
+  "Bribing the runtime...",
+  "Flirting with the database...",
+  "Sweet-talking the API...",
+  "Negotiating with deadlines...",
+  "Having words with the cache...",
+  "Reasoning with the memory...",
+  "Pleading with the logs...",
+  "Bargaining with fate...",
+  "Making offerings to the CI...",
+  "Praying to the uptime gods...",
+  "Consulting the rubber duck...",
+  "Interrogating the stack trace...",
+  "Cross-examining the debugger...",
+  "Petitioning the kernel...",
+  "Lobbying the scheduler...",
+  "Schmoozing the network...",
+  "Buttering up the firewall...",
+  "Wining and dining the servers...",
+  "Taking the bytes out for lunch...",
+  "Giving the code a pep talk...",
+  "Reading the room...",
+  "Checking under the hood...",
+  "Kicking the tires...",
+  "Shaking loose the cobwebs...",
+  "Dusting off the neurons...",
+  "Greasing the gears...",
+  "Oiling the cogs...",
+  "Winding up the clockwork...",
+  "Stoking the furnace...",
+  "Feeding the machine...",
+  "Watering the logic tree...",
+  "Pruning the decision branches...",
+  "Harvesting the outputs...",
+  "Planting computational seeds...",
+  "Nurturing the algorithm...",
+  "Raising the exceptions...",
+  "Taming wild pointers...",
+  "Herding cats in memory...",
+  "Teaching old code new tricks...",
+  "Whispering sweet nothings to the compiler...",
+  "Serenading the syntax...",
+  "Dancing with dependencies...",
+  "Waltzing through the codebase...",
+  "Tangoing with type errors...",
+  "Doing the deployment dance...",
+  "Having a moment of clarity...",
+  "Experiencing a flash of insight...",
+  "Channeling the ancient developers...",
+  "Receiving transmissions from the cloud...",
+  "Asking the hamsters to run faster...",
+  "Convincing the pixels to cooperate...",
+  "Teaching electrons new tricks...",
+  "Bribing the byte fairies...",
+  "Whispering passwords to the void...",
+  "Negotiating with cosmic rays...",
+  "Flattering the floating points...",
+  "Seducing the semicolons...",
+  "Wooing the while loops...",
+  "Charming the curly braces...",
+  "Hypnotizing the hash tables...",
+  "Mesmerizing the memory banks...",
+  "Enchanting the error handlers...",
+  "Bewitching the boolean logic...",
+  "Spellbinding the stack frames...",
+  "Hexing the hexadecimals...",
+  "Jinxing the JSON parsers...",
+  "Cursing the cache misses...",
+  "Blessing the build process...",
+  "Anointing the algorithms...",
+  "Consecrating the callbacks...",
+  "Sanctifying the source code...",
+  "Exorcising the exceptions...",
+  "Purifying the parameters...",
+  "Cleansing the closures...",
+  "Baptizing the binary...",
+  "Absolving the abstractions...",
+  "Redeeming the recursion...",
+  "Forgiving the for loops...",
+  "Pardoning the pointers...",
+  "Liberating the lambdas...",
+  "Emancipating the enums...",
+  "Freeing the functions...",
+  "Releasing the references...",
+  "Unbinding the variables...",
+  "Untying the type knots...",
+  "Unraveling the regex...",
+  "Decoding the mysteries...",
+  "Cracking the conundrums...",
+  "Solving the riddles of RAM...",
+  "Unlocking the secrets of silicon...",
+  "Discovering hidden semicolons...",
+  "Unearthing buried bugs...",
+  "Excavating ancient APIs...",
+  "Archeologically analyzing the architecture...",
+  "Fossil hunting in the functions...",
+  "Spelunking through the stack...",
+  "Scuba diving in the data...",
+  "Snorkeling through the streams...",
+  "Parasailing past the parameters...",
+  "Hang gliding through the heap...",
+  "Bungee jumping into the backend...",
+  "Skydiving through the source...",
+  "Surfing the syntax waves...",
+  "Skateboarding down the stack trace...",
+  "Snowboarding through the schemas...",
+  "Mountain climbing the modules...",
+  "Hiking through the headers...",
+  "Trekking through the trees...",
+  "Backpacking through the binaries...",
+  "Camping in the codebase...",
+  "Glamping in the globals...",
+  "Picnicking with the processes...",
+  "Barbecuing the bugs...",
+  "Roasting the race conditions...",
+  "Grilling the glitches...",
+  "Sautéing the syntax errors...",
+  "Flambéing the failures...",
+  "Caramelizing the callbacks...",
+  "Braising the breakpoints...",
+  "Poaching the pointers...",
+  "Blanching the branches...",
+  "Searing the segments...",
+  "Smoking the subroutines...",
+  "Curing the code smells...",
+  "Pickling the packages...",
+  "Preserving the protocols...",
+  "Canning the constants...",
+  "Bottling the buffers...",
+  "Jarring the JavaScript...",
+  "Decanting the data structures...",
+  "Aerating the arrays...",
+  "Letting the logic breathe...",
+  "Aging the algorithms gracefully...",
+  "Maturing the methods...",
+  "Ripening the results...",
+  "Seasoning the solutions...",
+  "Spicing up the specs...",
+  "Garnishing the getters...",
+  "Plating the output nicely...",
+  "Presenting with pizzazz...",
+  "Adding a dash of elegance...",
+  "Sprinkling some magic dust...",
+  "Drizzling debug sauce...",
+  "Folding in the features...",
+  "Whisking the widgets...",
+  "Kneading the namespaces...",
+  "Rolling out the runtime...",
+  "Proofing the promises...",
+  "Letting the dough rise...",
+  "Baking at 350 kilobytes...",
+  "Frosting the functions...",
+  "Decorating the deployment...",
+  "Icing the interfaces...",
+  "Glazing the graphics...",
+  "Topping with tests...",
+  "Cherry-picking the commits...",
+];
+
+export function pickRandom(): string {
+  return messages[Math.floor(Math.random() * messages.length)] ?? messages[0] ?? "Working...";
+}
+
+export function registerWhimsical(pi: ExtensionAPI): void {
+  pi.on("turn_start", async (_event, ctx) => {
+    setWorkingMessage(ctx, pickRandom());
+  });
+
+  pi.on("turn_end", async (_event, ctx) => {
+    setWorkingMessage(ctx); // Reset for next time (undefined restores pi's default)
+  });
+}