@andocorp/cli 0.1.3 → 0.3.0

package/dist/format.js

@@ -0,0 +1,297 @@
+const LINK_START_MARKER = "\u0000";
+const LINK_END_MARKER = "\u0001";
+const LINK_SEPARATOR_MARKER = "\u0002";
+const ANSI_RESET = "\u001b[0m";
+const ANSI_LINK = "\u001b[34m";
+const ANSI_CURRENT_MEMBER = "\u001b[38;2;0;224;224m";
+const ANSI_ESCAPE_PATTERN = new RegExp(`${ANSI_RESET[0]}\\[[0-9;]*m`, "g");
+const ANSI_ESCAPE_AT_START_PATTERN = new RegExp(`^${ANSI_RESET[0]}\\[[0-9;]*m`);
+function pad(value) {
+    return value.toString().padStart(2, "0");
+}
+function stripLinkMarkers(text) {
+    let result = "";
+    let index = 0;
+    while (index < text.length) {
+        const character = text[index];
+        if (character == null) {
+            break;
+        }
+        if (character === LINK_START_MARKER) {
+            index += 1;
+            while (index < text.length && text[index] !== LINK_SEPARATOR_MARKER) {
+                index += 1;
+            }
+            if (text[index] === LINK_SEPARATOR_MARKER) {
+                index += 1;
+            }
+            while (index < text.length && text[index] !== LINK_END_MARKER) {
+                const linkCharacter = text[index];
+                if (linkCharacter != null) {
+                    result += linkCharacter;
+                }
+                index += 1;
+            }
+            if (text[index] === LINK_END_MARKER) {
+                index += 1;
+            }
+            continue;
+        }
+        if (character !== LINK_END_MARKER && character !== LINK_SEPARATOR_MARKER) {
+            result += character;
+        }
+        index += 1;
+    }
+    return result;
+}
+function stripAnsi(text) {
+    return text.replace(ANSI_ESCAPE_PATTERN, "");
+}
+export function getVisibleText(text) {
+    return stripAnsi(stripLinkMarkers(text));
+}
+export function getVisibleTextLength(text) {
+    return getVisibleText(text).length;
+}
+export function renderTerminalText(text) {
+    let rendered = "";
+    let index = 0;
+    while (index < text.length) {
+        const character = text[index];
+        if (character == null) {
+            break;
+        }
+        if (character === LINK_START_MARKER) {
+            index += 1;
+            while (index < text.length && text[index] !== LINK_SEPARATOR_MARKER) {
+                index += 1;
+            }
+            if (text[index] === LINK_SEPARATOR_MARKER) {
+                index += 1;
+            }
+            rendered += ANSI_LINK;
+            continue;
+        }
+        if (character === LINK_END_MARKER) {
+            rendered += ANSI_RESET;
+            index += 1;
+            continue;
+        }
+        if (character !== LINK_SEPARATOR_MARKER) {
+            rendered += character;
+        }
+        index += 1;
+    }
+    return rendered;
+}
+function formatLink(url, label) {
+    return `${LINK_START_MARKER}${url}${LINK_SEPARATOR_MARKER}${label}${LINK_END_MARKER}`;
+}
+function isUrlLikeText(text) {
+    try {
+        const url = new URL(text);
+        return url.protocol === "http:" || url.protocol === "https:";
+    }
+    catch {
+        return false;
+    }
+}
+function getLinkLabel(part) {
+    const childText = part.label.trim();
+    if (childText === "") {
+        return part.url;
+    }
+    if (childText === part.url || isUrlLikeText(childText)) {
+        return childText;
+    }
+    return childText;
+}
+function parseMarkdownParts(markdown) {
+    const parts = [];
+    const pattern = /(!?)\[([^\]]*)\]\(([^)]+)\)|\n/g;
+    let lastIndex = 0;
+    let match;
+    while ((match = pattern.exec(markdown)) != null) {
+        if (match.index > lastIndex) {
+            parts.push({
+                type: "text",
+                value: markdown.slice(lastIndex, match.index),
+            });
+        }
+        const raw = match[0];
+        if (raw === "\n") {
+            parts.push({ type: "linebreak" });
+        }
+        else if (match[1] === "!") {
+            parts.push({
+                type: "image",
+                alt: match[2] ?? "",
+            });
+        }
+        else {
+            parts.push({
+                type: "link",
+                label: match[2] ?? "",
+                url: match[3] ?? "",
+            });
+        }
+        lastIndex = pattern.lastIndex;
+    }
+    if (lastIndex < markdown.length) {
+        parts.push({
+            type: "text",
+            value: markdown.slice(lastIndex),
+        });
+    }
+    return parts;
+}
+function getMessageBodyText(markdown) {
+    return parseMarkdownParts(markdown)
+        .map((part) => {
+        switch (part.type) {
+            case "text":
+                return part.value;
+            case "linebreak":
+                return "\n";
+            case "image":
+                return part.alt || "Image";
+            case "link":
+                return formatLink(part.url, getLinkLabel(part));
+        }
+    })
+        .join("");
+}
+function formatDateTime(value) {
+    if (value == null) {
+        return "";
+    }
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime())) {
+        return "";
+    }
+    return `${pad(date.getDate())}/${pad(date.getMonth() + 1)} ${pad(date.getHours())}:${pad(date.getMinutes())}`;
+}
+function truncate(text, width) {
+    if (width <= 0) {
+        return "";
+    }
+    const visibleText = getVisibleText(text);
+    if (visibleText.length <= width) {
+        return text;
+    }
+    if (width <= 1) {
+        return visibleText.slice(0, width);
+    }
+    let visibleCount = 0;
+    let result = "";
+    for (let index = 0; index < text.length; index += 1) {
+        const character = text[index];
+        if (character == null) {
+            break;
+        }
+        if (character === "\u001b") {
+            const ansiMatch = ANSI_ESCAPE_AT_START_PATTERN.exec(text.slice(index));
+            if (ansiMatch != null) {
+                result += ansiMatch[0];
+                index += ansiMatch[0].length - 1;
+                continue;
+            }
+        }
+        if (character === LINK_START_MARKER || character === LINK_END_MARKER) {
+            result += character;
+            if (character === LINK_START_MARKER) {
+                index += 1;
+                while (index < text.length) {
+                    const linkCharacter = text[index];
+                    if (linkCharacter == null) {
+                        break;
+                    }
+                    result += linkCharacter;
+                    if (linkCharacter === LINK_SEPARATOR_MARKER) {
+                        break;
+                    }
+                    index += 1;
+                }
+            }
+            continue;
+        }
+        if (visibleCount >= width - 1) {
+            break;
+        }
+        result += character;
+        visibleCount += 1;
+    }
+    return `${result}…`;
+}
+export function getMessageBody(message) {
+    const body = message.markdown_content?.trim();
+    if (body) {
+        return getMessageBodyText(body).replace(/\s+/g, " ").trim();
+    }
+    if (message.image_urls.length > 0) {
+        return `[${message.image_urls.length} image attachment${message.image_urls.length === 1 ? "" : "s"}]`;
+    }
+    if (message.files.length > 0) {
+        return `[${message.files.length} file attachment${message.files.length === 1 ? "" : "s"}]`;
+    }
+    if (message.call_id != null) {
+        return "[Jam started]";
+    }
+    return "[empty message]";
+}
+export function formatReactionSummary(message) {
+    const reactions = "message_reactions" in message ? message.message_reactions : message.reactions;
+    if (reactions.length === 0) {
+        return "";
+    }
+    const groupedEmojis = [];
+    let currentEmoji = "";
+    let currentCount = 0;
+    const pushCurrentEmoji = () => {
+        if (currentCount === 0) {
+            return;
+        }
+        groupedEmojis.push(currentEmoji.repeat(currentCount));
+    };
+    for (const reaction of reactions) {
+        const count = "count" in reaction && typeof reaction.count === "number" ? reaction.count : 1;
+        if (reaction.emoji_text === currentEmoji) {
+            currentCount += count;
+            continue;
+        }
+        pushCurrentEmoji();
+        currentEmoji = reaction.emoji_text;
+        currentCount = count;
+    }
+    pushCurrentEmoji();
+    return groupedEmojis.join(" ");
+}
+function formatMessageFooter(message) {
+    const parts = [];
+    const reactions = formatReactionSummary(message);
+    if (message.replies_count > 0) {
+        parts.push(`[${message.replies_count} ${message.replies_count === 1 ? "reply" : "replies"}]`);
+    }
+    if (reactions !== "") {
+        parts.push(reactions);
+    }
+    return parts.join(" ");
+}
+function getMessageAuthorLabel(message) {
+    return (message.author.display_name ??
+        ("email" in message.author ? message.author.email : null) ??
+        "Unknown");
+}
+export function formatMessageLine(message, options) {
+    const author = truncate(getMessageAuthorLabel(message), 20);
+    const parts = [
+        formatDateTime(message.created_at),
+        options?.currentMemberId != null && message.author.id === options.currentMemberId
+            ? `${ANSI_CURRENT_MEMBER}${author}${ANSI_RESET}`
+            : author,
+        getMessageBody(message),
+    ];
+    const footer = formatMessageFooter(message);
+    const footerSuffix = footer === "" ? "" : ` | ${footer}`;
+    return renderTerminalText(`${parts.filter(Boolean).join(" | ")}${footerSuffix}`);
+}

package/dist/help.js

@@ -0,0 +1,70 @@
+import { getConfigPath } from "./config.js";
+export function buildHelpText() {
+    return `
+ando
+
+Usage:
+  ando help
+  ando login [--no-browser] [--base-url <url>] [--api-host <url>] [--realtime-host <host>]
+  ando login poll
+  ando login --api-key <key> [--base-url <url>] [--api-host <url>] [--realtime-host <host>]
+  ando logout
+  ando doctor [--json]
+  ando whoami [--json]
+
+Agent-first commands:
+  ando api ls [--json]
+  ando api <path|operation-id> [--method|-X <method>] [--data|-d <json|->]
+                               [name==value] [Header:Value] [field=value] [field:=json]
+  ando api <path|operation-id> --help
+  ando api <path|operation-id> --spec
+  ando messages (--channel <query> | --dm <query> | --conversation <id>) [--limit|-m <n>] [--before <cursor>] [--json]
+  ando search <query> [--type messages|members|conversations|clipboard|calls]
+                      [--author <id>[,<id>]] [--conversation <id>[,<id>]] [--thread <id>]
+                      [--after <iso>] [--before <iso>] [--mode full-text|semantic] [--json]
+  ando get message <message-id> [--json]
+  ando get member <member-id> [--json]
+  ando get clipboard <clipboard-id> [--json]
+  ando get call <call-id> [--json]
+  ando get transcript <call-id> [--limit <n>] [--cursor <cursor>] [--json]
+  ando thread <thread-root-message-id> [--limit <n>] [--after <cursor>] [--json]
+  ando thread -m <message-id> [--json]
+  ando watch messages [--delivery mentions] [--limit|-n <n>] [--timeout <ms>] [--json]
+
+Authentication:
+  login opens a browser authorization page, shows a verification code, and stores
+  the returned Ando API key in the system keyring by default. Non-secret config
+  metadata is stored in:
+    ${getConfigPath()}
+  logout revokes browser-created CLI credentials before removing local auth
+  state. API keys supplied manually or through ANDO_API_KEY remain local-only.
+  Use --api-key or ANDO_API_KEY for headless scripts and CI. Set ANDO_KEYRING=0
+  to use file-based auth instead of the system keyring.
+
+Environment:
+  ANDO_API_KEY           API key for SDK and public API requests
+  ANDO_KEYRING           Set to 0 to use file-based auth instead of keyring
+  ANDO_HOME              Config and auth state directory
+  ANDO_BASE_URL          Login and SDK REST base URL (default: https://api.ando.so)
+  ANDO_API_HOST          Public API base URL for agent-first commands (default: https://api.ando.so/v1)
+  ANDO_REALTIME_HOST     Realtime host for SDK subscriptions
+
+Examples:
+  ando login
+  ando login --no-browser
+  ando login --api-key ando_sk_...
+  ando doctor
+  ando whoami
+  ando logout
+  ando api ls
+  ando api searchMessages q==incident mode==semantic
+  ando api getMember memberId=<member-id>
+  ando api /v1/search/messages q==incident mode==semantic
+  echo '{"markdown_content":"hello"}' | ando api /v1/conversations/<conversation-id>/messages --data -
+  ando messages -c engineering -m 20
+  ando search "incident" --type messages --mode semantic
+  ando get message <message-id>
+  ando thread <thread-root-message-id> --limit 50
+  ando watch messages --limit 1 --json
+`.trim();
+}