@turri-dev/cli 0.0.0-stage → 0.1.2-next.48dacfc

package/assets/jellyfish/fallback.txt

@@ -0,0 +1,252 @@
+
+          ▄▄▆▆██▆▆▄▄
+       ▄▆█▓▒░░░░░░▒▓█▆▄
+     ▄█▓▒░  ░▒▒▒▒░  ░▒▓█▄
+    ▐█▒░  ░▒▓████▓▒░  ░▒█▌
+    ▝█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█▘
+       )  ) )  ║║ ╱ ) )
+      (  ╱ ╱ ╱╱ (  ( )
+     ╱ ╱ ) ))  )  )  )
+   ╱ (  ( ) ⁏  )  )  (
+ )  ⁏  )  ⁏ @  )  ⁏ )
+ ⁏  $  ⁏  ;   ⁏  * ⁏
+ #     %     &   .
+---
+
+           ▄▆▆██▆▆▄
+        ▄▆█▓▒░░░░▒▓█▆▄
+      ▄█▓▒░ ░▒▒▒▒░ ░▒▓█▄
+     ▐█▒░ ░▒▓████▓▒░ ░▒█▌
+     ▝█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█▘
+       )  ) ) ║║ ) )  )
+       ( ( ( (╱ ( (  (
+      ╱ ╱ ╱ ╱  ) )  )
+    ╱ ( ) ) ⁏ )  )  )
+  )  ⁏  ) ⁏ @ )  ⁏  ╱
+  ⁏ $  ⁏  ;   ⁏ * ⁏
+  #    %    &   .
+---
+            ▄▆██▆▄
+         ▄▆█▓▒░░▒▓█▆▄
+       ▄█▓▒░░▒▓▓▒░░▒▓█▄
+      ▐█▒░░▒▓████▓▒░░▒█▌
+      ▝█▄▄▄▄▄▄▄▄▄▄▄▄▄▄█▘
+        ) ) ) ║║ ) ) )
+       ( ( ( (( ( ( )
+      ) ) ) )) ) )  )
+     ╱ ╱ ( (⁏ )  ) )
+   ) ⁏  ) ⁏ @ )  ⁏ ╱
+   ⁏ $  ⁏ ;   ⁏ *⁏
+  #     %   &   .
+
+---
+            ▄▆██▆▄
+         ▄▆█▓▒░░▒▓█▆▄
+       ▄█▓▒░░▒▓▓▒░░▒▓█▄
+      ▐█▒░░▒▓████▓▒░░▒█▌
+      ▝█▄▄▄▄▄▄▄▄▄▄▄▄▄▄█▘
+        ) ) ) ║║ ) ) )
+       ( ( ) (( ( )  (
+      ) )  ))) )  ) )
+      ╱ ╱ ( (⁏ ( ( )
+    ) ⁏  ) ⁏@ ) ⁏  )
+   ⁏  $ ⁏ ;   ⁏ * ⁏
+   #    %   &   .
+
+---
+            ▄▆██▆▄
+         ▄▆█▓▒░░▒▓█▆▄
+       ▄█▓▒░░▒▓▓▒░░▒▓█▄
+      ▐█▒░░▒▓████▓▒░░▒█▌
+      ▝█▄▄▄▄▄▄▄▄▄▄▄▄▄▄█▘
+        ) ) ) ║║ ) ) )
+       ( ) ) )) ) )  (
+      )  ) ) )) ) ) )
+      ( ( ( (⁏ ( ( )
+     ) ⁏ ) ⁏@ ) ⁏  )
+    ⁏ $  ⁏ ;  ⁏ * ⁏
+   #    %   &   .
+
+---
+            ▄▆██▆▄
+         ▄▆█▓▒░░▒▓█▆▄
+       ▄█▓▒░░▒▓▓▒░░▒▓█▄
+      ▐█▒░░▒▓████▓▒░░▒█▌
+      ▝█▄▄▄▄▄▄▄▄▄▄▄▄▄▄█▘
+        ) ) ) ║║ ) ) )
+       ( ( ) )) ( ) )
+      ) )  ) )))  ) )
+      ( ( ( (⁏ ( ( )
+     ) ⁏ ) ⁏@ ) ⁏  )
+    ⁏ $  ⁏ ;  ⁏ * ⁏
+   #    %    &   .
+
+---
+            ▄▆██▆▄
+         ▄▆█▓▒░░▒▓█▆▄
+       ▄█▓▒░░▒▓▓▒░░▒▓█▄
+      ▐█▒░░▒▓████▓▒░░▒█▌
+      ▝█▄▄▄▄▄▄▄▄▄▄▄▄▄▄█▘
+        ) ) ) ║║ ) ) )
+       ( (  ((( ( ) )
+      ) )  ))) )  ) )
+     )  ( ( (⁏ ( ( )
+     ) ⁏ ) ⁏@ ) ⁏  )
+    ⁏ $  ⁏ ;  ⁏ * ⁏
+    #   %    &   .
+
+---
+
+           ▄▆▆██▆▆▄
+        ▄▆█▓▒░░░░▒▓█▆▄
+      ▄█▓▒░ ░▒▒▒▒░ ░▒▓█▄
+     ▐█▒░ ░▒▓████▓▒░ ░▒█▌
+     ▝█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█▘
+       )  ) ) ║║ )  ) )
+       ( ( ( (( (  ( )
+      ) ) ) )) )  )  )
+     ( ( ) ) ⁏ (  ( (
+    ) ⁏  ) ⁏@ )  ⁏ )
+   ⁏  $ ⁏ ;   ⁏ *  ⁏
+   #    %    &    .
+---
+
+           ▄▆▆██▆▆▄
+        ▄▆█▓▒░░░░▒▓█▆▄
+      ▄█▓▒░ ░▒▒▒▒░ ░▒▓█▄
+     ▐█▒░ ░▒▓████▓▒░ ░▒█▌
+     ▝█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█▘
+       )  ) ) ║║ ) )  )
+       ( ( ( (( ( )  )
+      ╱ ) ) )) )  )  )
+    )  ( ) )⁏  (  ( )
+    ) ⁏  ) ⁏@ )  ⁏  )
+   ⁏ $  ⁏ ;   ⁏ *  ⁏
+   #    %    &    .
+---
+
+           ▄▆▆██▆▆▄
+        ▄▆█▓▒░░░░▒▓█▆▄
+      ▄█▓▒░ ░▒▒▒▒░ ░▒▓█▄
+     ▐█▒░ ░▒▓████▓▒░ ░▒█▌
+     ▝█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█▘
+       )  ) ) ║║ ) )  )
+       ( ( ( (( ( )  (
+      ╱ ) ) )) )  ) )
+    (  ( ( )⁏  ( )  )
+   )  ⁏ )  ⁏@ )  ⁏  )
+   ⁏ $  ⁏ ;   ⁏ *  ⁏
+  #     %    &    .
+---
+
+           ▄▆▆██▆▆▄
+        ▄▆█▓▒░░░░▒▓█▆▄
+      ▄█▓▒░ ░▒▒▒▒░ ░▒▓█▄
+     ▐█▒░ ░▒▓████▓▒░ ░▒█▌
+     ▝█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█▘
+       )  ) )  ║ ) )  )
+       ( ( ( (( ( )  (
+      ╱ ╱ ) )) )  ) )
+    ( )  ( )⁏  ( )  )
+   )  ⁏ )  ⁏@ )  ⁏  )
+   ⁏ $  ⁏ ;   ⁏ *  ⁏
+  #     %    &   .
+---
+
+          ▄▄▆▆██▆▆▄▄
+       ▄▆█▓▒░░░░░░▒▓█▆▄
+     ▄█▓▒░  ░▒▒▒▒░  ░▒▓█▄
+    ▐█▒░  ░▒▓████▓▒░  ░▒█▌
+    ▝█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█▘
+      )  )  )  ║  ╱ ) )
+      (  ╱ ( (( (  ( )
+     ╱ )  ╱ )) )  )  )
+   (  ( )  (⁏  )  )  (
+  )  ⁏  ) ⁏ @  )  ⁏ )
+  ⁏ $   ⁏ ;   ⁏  * ⁏
+ #     %     &    .
+---
+
+          ▄▄▆▆██▆▆▄▄
+       ▄▆█▓▒░░░░░░▒▓█▆▄
+     ▄█▓▒░  ░▒▒▒▒░  ░▒▓█▄
+    ▐█▒░  ░▒▓████▓▒░  ░▒█▌
+    ▝█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█▘
+      )  )  )  ║║ ╱ ) )
+      (  ╱ ( (( (  ( )
+     ╱ )  ╱ )) )  )  )
+   (  ( )  (⁏  )  )  (
+  )  ⁏  ) ⁏ @  )  ⁏ )
+ ⁏  $  ⁏  ;   ⁏  * ⁏
+ #     %     &    .
+---
+
+          ▄▄▆▆██▆▆▄▄
+       ▄▆█▓▒░░░░░░▒▓█▆▄
+     ▄█▓▒░  ░▒▒▒▒░  ░▒▓█▄
+    ▐█▒░  ░▒▓████▓▒░  ░▒█▌
+    ▝█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█▘
+       )  ) )  ║║ ╱ ) )
+      (  ╱ ( (( (  ( )
+     ╱ )  ╱ )) )  )  )
+   (  ( )  (⁏  )  )  (
+  )  ⁏  ) ⁏ @  )  ⁏ )
+ ⁏  $  ⁏  ;   ⁏  * ⁏
+ #     %     &    .
+---
+
+          ▄▄▆▆██▆▆▄▄
+       ▄▆█▓▒░░░░░░▒▓█▆▄
+     ▄█▓▒░  ░▒▒▒▒░  ░▒▓█▄
+    ▐█▒░  ░▒▓████▓▒░  ░▒█▌
+    ▝█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█▘
+       )  ) )  ║║ ╱ ╱ )
+      (  ╱ ╱ ╱╱ ( )  )
+     ╱ ╱ ) ))  )  )  )
+   ( (  ( ) ⁏  )  )  (
+  ) ⁏  )  ⁏ @  )  ⁏ )
+ ⁏  $  ⁏  ;   ⁏  * ⁏
+ #     %     &    .
+---
+
+          ▄▄▆▆██▆▆▄▄
+       ▄▆█▓▒░░░░░░▒▓█▆▄
+     ▄█▓▒░  ░▒▒▒▒░  ░▒▓█▄
+    ▐█▒░  ░▒▓████▓▒░  ░▒█▌
+    ▝█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█▘
+       )  )  ╱ ║║ ╱ ╱ )
+      (  ╱ ╱ ╱╱ ( )  )
+     ╱ ╱ ) ))  )  )  )
+   ( (  ( ) ⁏  )  )  (
+  ) ⁏  )  ⁏ @  )  ⁏ )
+ ⁏  $  ⁏  ;   ⁏  * ⁏
+ #     %     &    .
+---
+
+          ▄▄▆▆██▆▆▄▄
+       ▄▆█▓▒░░░░░░▒▓█▆▄
+     ▄█▓▒░  ░▒▒▒▒░  ░▒▓█▄
+    ▐█▒░  ░▒▓████▓▒░  ░▒█▌
+    ▝█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█▘
+       )  )  ╱ ║║ ╱ ╱ )
+      (  ╱ ╱ ╱╱ ( )  )
+     ╱ ╱ ) ))  )  )  )
+   ( (  ( ) ⁏  )  )  (
+  ) ⁏  )  ⁏ @  )  ⁏ )
+ ⁏  $  ⁏  ;   ⁏  * ⁏
+ #     %     &    .
+---
+
+          ▄▄▆▆██▆▆▄▄
+       ▄▆█▓▒░░░░░░▒▓█▆▄
+     ▄█▓▒░  ░▒▒▒▒░  ░▒▓█▄
+    ▐█▒░  ░▒▓████▓▒░  ░▒█▌
+    ▝█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█▘
+       )  ) )  ║║ ╱ ╱ )
+      (  ╱ ╱ ╱╱ ( )  )
+     ╱ ╱ ) ))  )  )  )
+   ( (  ( ) ⁏  )  )  (
+  ) ⁏  )  ⁏ @  )  ⁏ )
+ ⁏  $  ⁏  ;   ⁏  * ⁏
+ #     %     &   .
+---

package/bin/turri.mjs

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+// The launcher: plain JavaScript, so it runs on any Node and can say what is wrong before turri itself is loaded -
+// the TypeScript sources in a clone, which Node runs itself, or in an installed package the files compiled from them
+// (npm run build), as Node runs no .ts file inside node_modules.
+const [major, minor] = process.versions.node.split(".").map(Number);
+if (major < 22 || (major === 22 && minor < 19)) {
+  console.error(
+    `turri needs Node 22.19 or newer; this is ${process.versions.node}.\n` +
+      (process.platform === "darwin"
+        ? "Install a newer one (`brew install node`, or https://nodejs.org) and run it again."
+        : "Install a newer one - a Linux distribution's own package is often older: use https://nodejs.org/en/download " +
+          "(nvm, or NodeSource's packages) - and run it again."),
+  );
+  process.exit(1);
+}
+// A terminal still sitting in a folder that was removed - or removed and made again under the same
+// path - has no working directory, and everything after this needs one.
+try {
+  process.cwd();
+} catch {
+  console.error(
+    "The folder this terminal is in no longer exists - it was removed, or removed and made again, while the terminal was in it.\n" +
+      `Go into it again - cd "${process.env.PWD ?? "<your project>"}" - or into your project, and run turri again.`,
+  );
+  process.exit(1);
+}
+const { existsSync } = await import("node:fs");
+const sources = new URL("../src/cli.ts", import.meta.url);
+await import(existsSync(sources) ? sources.href : new URL("../dist/cli.js", import.meta.url).href);

package/dist/ask.js

@@ -0,0 +1,149 @@
+/**
+ * How a skill step puts a question to the person running it.
+ *
+ * The interaction policy lives here rather than in the extension so it is the same from
+ * the TUI and the CLI, and so it can be tested without a terminal.
+ */
+import { isKeyRelease, isKeyRepeat, matchesKey } from "@earendil-works/pi-tui";
+import { PANEL_KEY } from "./regenerate/job-panel.js";
+export const OTHER_OPTION = "Something else…";
+export const CHAT_OPTION = "Chat about this";
+export const DONE_OPTION = "Done — that's all of them";
+export const DISMISSED = "The user dismissed the question without answering.";
+/** How an answer that is no answer starts: the person chose to talk about the question first. */
+export const CHAT_PREFIX = "The user has not answered this question yet: they chose to talk about it first.";
+/** What comes back when the person chose "Chat about this": what they said, and what they had picked so far. */
+export function chatAnswer(said, picked = []) {
+    return [CHAT_PREFIX, `They said: ${said.trim()}`, ...(picked.length > 0 ? [`They had picked so far: ${picked.join(", ")}.`] : [])].join("\n");
+}
+/** Whether an answer is the person choosing to talk about the question, rather than answering it. */
+export function isChat(answer) {
+    return answer.startsWith(CHAT_PREFIX);
+}
+/** The input after "Something else…" or "Chat about this": with nothing typed, or Esc, the options again. */
+const BACK = "(Esc, or nothing typed: back to the options)";
+const typedNothing = (typed) => typed === undefined || typed.trim() === "";
+/**
+ * A question with no options and no `free_form` is refused rather than asked.
+ *
+ * Offering choices is the thing that makes an interview quick to answer, and an optional
+ * field is one a model quietly skips. Making the free-form case explicit means asking
+ * without options is a decision rather than an omission.
+ */
+export function missingOptions(request) {
+    const hasOptions = request.options !== undefined && request.options.length > 0;
+    if (hasOptions || request.freeForm === true)
+        return null;
+    return ("This question was not asked. Offer concrete options so the user can pick one, or set " +
+        "free_form to true if the answer genuinely cannot be anticipated (\"What is the app?\"). " +
+        "Call ask_user again.");
+}
+/**
+ * A model's own tool-call syntax, leaked into an argument: `<parameter name="multi_select">false`
+ * written inside an option instead of as the argument it is. Never shown to the person.
+ */
+const TOOL_MARKUP = /<\/?(?:antml:)?(?:parameter|invoke|function_calls|function|tool_call|arg_key|arg_value)\b[^>]*>/i;
+/**
+ * The request as the person should see it: tool-call markup cut out of the question and the
+ * options - an option that was nothing but markup dropped - and a `multi_select` that leaked into
+ * the text taken as the argument it was meant to be. `leaked` when there was any.
+ */
+export function cleanRequest(request) {
+    let leaked = false;
+    let multiSelect = request.multiSelect;
+    const clean = (text) => {
+        const flag = /<(?:antml:)?parameter\s+name="multi_select"\s*>\s*(true|false)/i.exec(text);
+        if (flag && multiSelect === undefined)
+            multiSelect = flag[1].toLowerCase() === "true";
+        const at = text.search(TOOL_MARKUP);
+        if (at === -1)
+            return text.trim();
+        leaked = true;
+        return text.slice(0, at).trim();
+    };
+    const question = clean(request.question);
+    const options = request.options === undefined ? undefined : [...new Set(request.options.map(clean).filter((option) => option !== ""))];
+    return { request: { ...request, question, options, multiSelect }, leaked };
+}
+export async function runAsk(asked, io) {
+    const { request, leaked } = cleanRequest(asked);
+    // What was left once the markup was cut out is not a question worth putting to anyone.
+    if (leaked && (request.question === "" || (request.options?.length === 0 && request.freeForm !== true))) {
+        return ("This question was not asked: its question or options held tool-call markup (<parameter ...>) " +
+            "instead of text. Call ask_user again, with question, options and multi_select as separate arguments.");
+    }
+    const refusal = missingOptions(request);
+    if (refusal !== null)
+        return refusal;
+    // The question, and apart from it what it is about: the dialog shows that above it.
+    const trimmed = request.context?.trim() ?? "";
+    const context = trimmed !== "" ? trimmed : undefined;
+    const options = request.options ?? [];
+    if (options.length === 0) {
+        return (await io.input(request.question, context)) ?? DISMISSED;
+    }
+    // Beside the options: typing an answer instead, and - when an agent asked - talking about the question first. Either
+    // can be backed out of, to the options again: picked by accident, it costs nothing.
+    const extras = [OTHER_OPTION, ...(request.chattable === true ? [CHAT_OPTION] : [])];
+    const typeInstead = () => io.input(`${request.question}\n\n${BACK}`, context);
+    const chatAbout = () => io.input(`${request.question}\n\nWhat would you like to talk about? ${BACK}`, context);
+    if (request.multiSelect !== true) {
+        for (;;) {
+            const choice = await io.select(request.question, [...options, ...extras], context);
+            if (choice === undefined)
+                return DISMISSED;
+            if (choice === OTHER_OPTION) {
+                const typed = await typeInstead();
+                if (typedNothing(typed))
+                    continue;
+                return typed;
+            }
+            if (choice === CHAT_OPTION) {
+                const said = await chatAbout();
+                if (typedNothing(said))
+                    continue;
+                return chatAnswer(said);
+            }
+            return choice;
+        }
+    }
+    // Pick several: keep offering what is left until they say they are done.
+    const chosen = [];
+    let remaining = [...options];
+    while (remaining.length > 0) {
+        const title = chosen.length === 0 ? request.question : `${request.question}  [so far: ${chosen.join(", ")}]`;
+        const choice = await io.select(title, [...remaining, ...extras, DONE_OPTION], context);
+        if (choice === undefined)
+            break;
+        if (choice === DONE_OPTION)
+            break;
+        if (choice === OTHER_OPTION) {
+            const typed = await typeInstead();
+            if (!typedNothing(typed))
+                chosen.push(typed.trim());
+            continue;
+        }
+        if (choice === CHAT_OPTION) {
+            const said = await chatAbout();
+            if (typedNothing(said))
+                continue;
+            return chatAnswer(said, chosen);
+        }
+        chosen.push(choice);
+        remaining = remaining.filter((option) => option !== choice);
+    }
+    return chosen.length > 0 ? chosen.join(", ") : DISMISSED;
+}
+/**
+ * While a question is open, what catches ctrl+h on the terminal's input: pi gives an extension's shortcut only the keys
+ * its editor sees, and a question has the focus. It opens the side panel - the question waits under it - unless the
+ * panel shows already: its own listener has ctrl+h then, to close it. A key's release and its repeats are left alone.
+ */
+export function peekKeyListener(panel) {
+    return (data) => {
+        if (isKeyRelease(data) || isKeyRepeat(data) || !matchesKey(data, PANEL_KEY) || panel.shown())
+            return undefined;
+        panel.open();
+        return { consume: true };
+    };
+}

package/dist/brand.js

@@ -0,0 +1,50 @@
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+/**
+ * turri's colours for what its command line prints - the ones its themes use (.pi/themes): on a dark terminal its lime
+ * accent and green, on a light one its blue. Nothing is coloured when the output is not a terminal, or NO_COLOR is set;
+ * a terminal without 24-bit colour gets the nearest of its sixteen.
+ */
+/** Whether the terminal is light: COLORFGBG says so (a light background, 7 or 15), or pi's theme is a light one. */
+function lightTerminal() {
+    const background = process.env.COLORFGBG?.split(";").at(-1);
+    if (background === "7" || background === "15")
+        return true;
+    try {
+        const settings = join(process.env.PI_CODING_AGENT_DIR ?? join(homedir(), ".pi", "agent"), "settings.json");
+        if (existsSync(settings))
+            return /light/i.test(String(JSON.parse(readFileSync(settings, "utf8")).theme ?? ""));
+    }
+    catch {
+        /* no settings to go by */
+    }
+    return false;
+}
+function paint(stream = process.stdout) {
+    const on = stream.isTTY === true && process.env.NO_COLOR === undefined;
+    const truecolor = /truecolor|24bit/i.test(process.env.COLORTERM ?? "");
+    const light = on && lightTerminal();
+    const ink = (hex, basic) => (text) => {
+        if (!on)
+            return text;
+        if (!truecolor)
+            return `\x1b[${basic}m${text}\x1b[39m`;
+        const [r, g, b] = [1, 3, 5].map((at) => Number.parseInt(hex.slice(at, at + 2), 16));
+        return `\x1b[38;2;${r};${g};${b}m${text}\x1b[39m`;
+    };
+    return {
+        /** turri's accent: what to look at - a heading, a choice's number, the command to run. */
+        accent: light ? ink("#0a1fd4", 34) : ink("#e0ff6e", 93),
+        /** Done, and what was written. */
+        success: light ? ink("#223936", 32) : ink("#79fc96", 92),
+        /** What is wrong: what stops turri. */
+        error: light ? ink("#d00505", 31) : ink("#dd5353", 91),
+        /** What works, with limits. */
+        warning: ink("#dc6803", 33),
+        /** What goes with it, and can be skimmed. */
+        muted: ink("#808080", 90),
+        bold: (text) => (on ? `\x1b[1m${text}\x1b[22m` : text),
+    };
+}
+export const brand = paint();