@ocis/myagent-cli 0.2.0

package/dist/ui/logo.js

@@ -0,0 +1,106 @@
+// -------------------------------------------------------------------
+// The original MyAgent block-letter logo, preserved verbatim, wrapped as a
+// pi-tui component. The gradient shimmer runs once on launch (22 frames ×
+// 38ms) and settles on the static gradient; non-TTY / NO_COLOR prints the
+// plain art once.
+// -------------------------------------------------------------------
+import { truncateToWidth } from "@earendil-works/pi-tui";
+import { isColorEnabled, rgb, style } from "./colors.js";
+// Block-letter "MYAGENT" logo for the welcome screen (5 rows, 41 cols).
+export const LOGO = [
+    "█   █ █   █  ███   ████ █████ █   █ █████",
+    "██ ██  █ █  █   █ █     █     ██  █   █  ",
+    "█ █ █   █   █████ █  ██ ████  █ █ █   █  ",
+    "█   █   █   █   █ █   █ █     █  ██   █  ",
+    "█   █   █   █   █  ████ █████ █   █   █  ",
+];
+/**
+ * Left inset shared by the art and the tagline — the component adds the
+ * transcript's 2-space margin, so the block starts at column 8 and the art
+ * lines up with the words below it.
+ */
+const LOGO_INSET = "      ";
+export const TAGLINE = `${LOGO_INSET}✦ your machine, in the hands of the agent ✦`;
+// Gradient stops the logo sweeps through (cyan → indigo → violet → pink).
+const GRADIENT = [
+    [0x22, 0xd3, 0xee],
+    [0x81, 0x8c, 0xf8],
+    [0xc0, 0x84, 0xfc],
+    [0xf4, 0x72, 0xb6],
+];
+function gradientAt(t) {
+    const clamped = Math.max(0, Math.min(1, t));
+    const span = GRADIENT.length - 1;
+    const x = clamped * span;
+    const i = Math.min(span - 1, Math.floor(x));
+    const f = x - i;
+    const a = GRADIENT[i];
+    const b = GRADIENT[i + 1];
+    const mix = (j) => Math.round(a[j] + (b[j] - a[j]) * f);
+    return [mix(0), mix(1), mix(2)];
+}
+/** Triangle wave, period 2, mapping any x → [0,1] — seamless shimmer. */
+function triangle(x) {
+    const m = ((x % 2) + 2) % 2;
+    return m <= 1 ? m : 2 - m;
+}
+/** Paint the logo for a given gradient phase; returns the 5 colored rows. */
+export function paintLogo(phase) {
+    const width = LOGO[0].length;
+    return LOGO.map((line, row) => {
+        let painted = "";
+        for (let col = 0; col < line.length; col++) {
+            const ch = line[col];
+            if (ch === " ") {
+                painted += " ";
+                continue;
+            }
+            const [r, g, b] = gradientAt(triangle((col + row * 2) / (width + 8) + phase));
+            painted += rgb(r, g, b, ch);
+        }
+        return painted;
+    });
+}
+/**
+ * Transcript component rendering the logo. `start()` kicks off the one-shot
+ * shimmer; the component stops animating after the final frame.
+ */
+export class LogoComponent {
+    options;
+    phase = 0;
+    timer = null;
+    frame = 0;
+    frames = 22;
+    constructor(options = { animate: true }) {
+        this.options = options;
+    }
+    start(tui) {
+        if (!this.options.animate || !isColorEnabled() || !process.stdout.isTTY)
+            return;
+        this.timer = setInterval(() => {
+            this.frame++;
+            this.phase = (this.frame / this.frames) * 2;
+            if (this.frame >= this.frames)
+                this.stop();
+            tui.requestRender();
+        }, 38);
+        this.timer.unref?.();
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    invalidate() { }
+    render(width) {
+        const lines = [""];
+        for (const line of paintLogo(this.phase)) {
+            lines.push(truncateToWidth(`  ${LOGO_INSET}${line}`, width));
+        }
+        if (this.options.tagline !== false)
+            lines.push(truncateToWidth(style.dim(`  ${TAGLINE}`), width));
+        lines.push("");
+        return lines;
+    }
+}

package/dist/ui/model-list.d.ts

@@ -0,0 +1,10 @@
+import type { SelectItem } from "@earendil-works/pi-tui";
+import type { ModelInfo } from "../protocol/types.js";
+/**
+ * The id the picker marks as current: the model in use (a thread's model or a
+ * fresh selection), otherwise the user's pending selection, otherwise the
+ * server default (the entry flagged `default`, falling back to the first).
+ */
+export declare function currentModelId(models: ModelInfo[], activeModel: string | null, selectedModel: string | null): string | undefined;
+/** Build the `/model` picker rows for a model list. */
+export declare function buildModelItems(models: ModelInfo[], currentId: string | undefined): SelectItem[];

package/dist/ui/model-list.js

@@ -0,0 +1,33 @@
+// ---------------------------------------------------------------------------
+// Model picker helpers — turn GET /v1/models entries into `/model` rows.
+//
+// The picker marks the model in use as "current" and myagent's default as
+// "default". Current wins when both apply, so the row the user is actually
+// running carries exactly one marker.
+// ---------------------------------------------------------------------------
+/**
+ * The id the picker marks as current: the model in use (a thread's model or a
+ * fresh selection), otherwise the user's pending selection, otherwise the
+ * server default (the entry flagged `default`, falling back to the first).
+ */
+export function currentModelId(models, activeModel, selectedModel) {
+    if (activeModel)
+        return activeModel;
+    if (selectedModel)
+        return selectedModel;
+    return models.find((m) => m.default)?.id ?? models[0]?.id;
+}
+/** Build the `/model` picker rows for a model list. */
+export function buildModelItems(models, currentId) {
+    // The server flags exactly one entry; older servers only order the list.
+    const hasDefaultFlag = models.some((m) => m.default === true);
+    return models.map((m, index) => {
+        const isCurrent = m.id === currentId;
+        const isDefault = m.default === true || (!hasDefaultFlag && index === 0);
+        return {
+            value: m.id,
+            label: m.label ? `${m.label} (${m.id})` : m.id,
+            description: isCurrent ? "current" : isDefault ? "default" : "",
+        };
+    });
+}

package/dist/ui/quit-confirm.d.ts

@@ -0,0 +1,8 @@
+export interface QuitConfirm {
+    readonly armed: boolean;
+    /** Arm, or extend the window when already armed. */
+    arm(): void;
+    /** Clear the pending confirmation (expired window, quit, or a new run). */
+    disarm(): void;
+}
+export declare function createQuitConfirm(onChange: (armed: boolean) => void, windowMs?: number): QuitConfirm;

package/dist/ui/quit-confirm.js

@@ -0,0 +1,40 @@
+// -------------------------------------------------------------------
+// Two-press quit gate for idle Ctrl+C.
+//
+// The first idle Ctrl+C arms the gate (the caller shows the hint), a second
+// press inside the window quits, and expiry disarms it back to idle.
+// -------------------------------------------------------------------
+/** How long the second Ctrl+C stays valid. */
+const QUIT_CONFIRM_MS = 2000;
+export function createQuitConfirm(onChange, windowMs = QUIT_CONFIRM_MS) {
+    let timer = null;
+    let armed = false;
+    const set = (next) => {
+        if (armed === next)
+            return;
+        armed = next;
+        onChange(armed);
+    };
+    return {
+        get armed() {
+            return armed;
+        },
+        arm() {
+            if (timer)
+                clearTimeout(timer);
+            set(true);
+            timer = setTimeout(() => {
+                timer = null;
+                set(false);
+            }, windowMs);
+            timer.unref?.();
+        },
+        disarm() {
+            if (timer) {
+                clearTimeout(timer);
+                timer = null;
+            }
+            set(false);
+        },
+    };
+}

package/dist/ui/select-popup.d.ts

@@ -0,0 +1,30 @@
+import { type SelectList } from "@earendil-works/pi-tui";
+/** Width ceiling so long session descriptions never span an ultrawide terminal. */
+export declare const MAX_SELECT_CARD_WIDTH = 96;
+/** Columns added around the measured content: borders (2), padding (2), slack (2). */
+export declare const SELECT_CARD_CHROME = 6;
+/**
+ * Rows the list may render inside a card on a `termHeight`-row terminal —
+ * leaves room for the two card edges, the top/bottom padding rows and a
+ * possible scroll indicator row.
+ */
+export declare function selectVisibleRows(termHeight: number, requested?: number): number;
+/** Widest label column SelectList should use, clamped to a readable range. */
+export declare function selectLabelColumn(items: readonly {
+    label: string;
+}[]): number;
+/**
+ * Card width floor that keeps SelectList from silently dropping one-line
+ * descriptions: its inner width must clear the label column plus a 10-char
+ * description minimum and a 4-column safety gap, and the card adds 4 chrome
+ * columns — `labelColumn + 19`.
+ */
+export declare function selectDescriptionMinWidth(labelColumn: number): number;
+/**
+ * Content-adaptive card width. `minWidth` should come from
+ * {@link selectDescriptionMinWidth} whenever the list has descriptions.
+ */
+export declare function selectCardWidth(title: string, list: SelectList, options: {
+    termWidth: number;
+    minWidth?: number;
+}): number;

package/dist/ui/select-popup.js

@@ -0,0 +1,54 @@
+// -------------------------------------------------------------------
+// Popup geometry for the select overlays.
+//
+// pi-tui resolves an overlay's width from the options passed to showOverlay,
+// so the card cannot resize itself at render time. The list is dry-rendered at
+// a wide probe width to measure its intrinsic line widths, and the card is
+// sized from that measurement, clamped to the terminal and a readability
+// ceiling.
+// -------------------------------------------------------------------
+import { visibleWidth } from "@earendil-works/pi-tui";
+/** Width ceiling so long session descriptions never span an ultrawide terminal. */
+export const MAX_SELECT_CARD_WIDTH = 96;
+/** Columns added around the measured content: borders (2), padding (2), slack (2). */
+export const SELECT_CARD_CHROME = 6;
+/** Narrowest unfilled card. */
+const SELECT_CARD_MIN_WIDTH = 30;
+/** Widest probe passed to a dry render when measuring content. */
+const MAX_PROBE_WIDTH = 160;
+/** Fraction of the terminal height a select popup may occupy. */
+const POPUP_HEIGHT_RATIO = 0.6;
+/**
+ * Rows the list may render inside a card on a `termHeight`-row terminal —
+ * leaves room for the two card edges, the top/bottom padding rows and a
+ * possible scroll indicator row.
+ */
+export function selectVisibleRows(termHeight, requested = 12) {
+    return Math.max(3, Math.min(requested, Math.floor(termHeight * POPUP_HEIGHT_RATIO) - 5));
+}
+/** Widest label column SelectList should use, clamped to a readable range. */
+export function selectLabelColumn(items) {
+    const widest = items.reduce((max, item) => Math.max(max, visibleWidth(item.label)), 0);
+    return Math.max(6, Math.min(40, widest + 2));
+}
+/**
+ * Card width floor that keeps SelectList from silently dropping one-line
+ * descriptions: its inner width must clear the label column plus a 10-char
+ * description minimum and a 4-column safety gap, and the card adds 4 chrome
+ * columns — `labelColumn + 19`.
+ */
+export function selectDescriptionMinWidth(labelColumn) {
+    return labelColumn + 19;
+}
+/**
+ * Content-adaptive card width. `minWidth` should come from
+ * {@link selectDescriptionMinWidth} whenever the list has descriptions.
+ */
+export function selectCardWidth(title, list, options) {
+    const termWidth = Math.max(12, options.termWidth);
+    const probeWidth = Math.max(1, Math.min(termWidth - 4, MAX_PROBE_WIDTH));
+    const lines = list.render(probeWidth);
+    const contentWidth = lines.reduce((widest, line) => Math.max(widest, visibleWidth(line)), visibleWidth(title) + 5);
+    const width = Math.max(contentWidth + SELECT_CARD_CHROME, options.minWidth ?? SELECT_CARD_MIN_WIDTH);
+    return Math.max(8, Math.min(width, MAX_SELECT_CARD_WIDTH, termWidth - 2));
+}

package/dist/ui/theme.d.ts

@@ -0,0 +1,4 @@
+import type { EditorTheme, MarkdownTheme, SelectListTheme } from "@earendil-works/pi-tui";
+export declare const markdownTheme: MarkdownTheme;
+export declare const selectListTheme: SelectListTheme;
+export declare function editorTheme(borderColor: (s: string) => string): EditorTheme;

package/dist/ui/theme.js

@@ -0,0 +1,41 @@
+// -------------------------------------------------------------------
+// pi-tui themes: markdown, select lists, editor border.
+// -------------------------------------------------------------------
+import { headingColor, style } from "./colors.js";
+import { highlightCodeBlock } from "./highlight.js";
+export const markdownTheme = {
+    // Bright light-blue + bold so headings read as headings, not bold prose
+    // (h1 is additionally underlined by pi-tui; h2+ render bare — the color
+    // is the only level cue left once the "###" prefixes are stripped).
+    heading: (t) => style.bold(headingColor(t)),
+    link: (t) => style.underline(style.cyan(t)),
+    linkUrl: (t) => style.dim(t),
+    code: (t) => style.yellow(t),
+    codeBlock: (t) => t,
+    codeBlockBorder: (t) => style.dim(t),
+    // Pinned: AssistantMessageComponent swaps this 2-cell indent for the code
+    // bar, so its slice(2) must match whatever lands here.
+    codeBlockIndent: "  ",
+    highlightCode: (code, language) => highlightCodeBlock(code, language),
+    quote: (t) => style.italic(t),
+    quoteBorder: (t) => style.dim(t),
+    hr: (t) => style.dim(t),
+    // Unordered items read as a dot rather than a hyphen flush with prose. The
+    // replacement must stay width-preserving: pi-tui pads wrapped continuation
+    // lines with the ORIGINAL marker's width, so a wider prefix misaligns them.
+    listBullet: (marker) => style.cyan(marker.replace(/^- /, "• ")),
+    bold: (t) => style.bold(t),
+    italic: (t) => style.italic(t),
+    strikethrough: (t) => style.dim(t),
+    underline: (t) => style.underline(t),
+};
+export const selectListTheme = {
+    selectedPrefix: (t) => style.cyan(t),
+    selectedText: (t) => style.bold(style.cyan(t)),
+    description: (t) => style.dim(t),
+    scrollInfo: (t) => style.dim(t),
+    noMatch: (t) => style.dim(t),
+};
+export function editorTheme(borderColor) {
+    return { borderColor, selectList: selectListTheme };
+}

package/dist/ui/tool-view.d.ts

@@ -0,0 +1,20 @@
+/** Bash output lines kept in the expanded body (older lines collapse). */
+export declare const SHELL_TAIL_LINES = 30;
+/** Parse tool arguments whether they arrived as a JSON string or an object. */
+export declare function parseToolArgs(raw: unknown): Record<string, unknown>;
+/** `local_read` → `read`, `load_local_skill` → `load_skill`. */
+export declare function displayToolName(name: string): string;
+/**
+ * One-line argument summary shown after the tool name — important parameters
+ * only, never raw JSON. Tools without a curated summary fall back to a single
+ * parameter shown inline; a call with several parameters shows no summary.
+ *
+ * The result is sanitized: the summary is always visible (collapsed header)
+ * and its values come from model-generated arguments.
+ */
+export declare function toolSummary(name: string, args: Record<string, unknown>): string;
+/**
+ * Expanded body lines for a tool call, rendered for the available `width`
+ * (pair diffs use it for their columns). Callers add the transcript indent.
+ */
+export declare function toolBody(name: string, args: Record<string, unknown>, output: string, isError: boolean, width: number): string[];