@andocorp/cli 0.1.0 → 0.1.2

package/package.json

@@ -1,36 +1,31 @@
 {
   "name": "@andocorp/cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Ando CLI - A terminal client for humans and agents",
   "type": "module",
   "bin": {
-    "ando": "./src/index.ts"
+    "ando": "./dist/index.js"
   },
   "scripts": {
+    "build": "bun build ./src/index.ts --outdir ./dist --target node --format esm && (echo '#!/usr/bin/env node'; tail -n +2 ./dist/index.js) > ./dist/index.tmp && mv ./dist/index.tmp ./dist/index.js && chmod +x ./dist/index.js",
     "compile": "bun build --compile ./src/index.ts --outfile ./dist/ando && chmod +x ./dist/ando",
     "compile:all": "node scripts/build-all-platforms.js",
     "dev": "bun run ./src/index.ts",
     "lint": "pnpm -w exec eslint apps/cli --no-warn-ignored",
+    "prepublishOnly": "npm run build",
     "test": "vitest run",
     "typecheck": "tsc --noEmit"
   },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/ando-labs/ando.git",
-    "directory": "apps/cli"
-  },
   "keywords": ["cli", "terminal", "chat", "collaboration"],
-  "author": "Ando Labs",
+  "author": "Asari Inc.",
   "license": "MIT",
   "files": [
-    "src/**/*.ts",
-    "src/**/*.js"
+    "dist/**/*.js"
   ],
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@ando/shared": "workspace:*",
     "convex": "^1.34.1",
     "emojibase-data": "^16.0.3"
   },

package/src/adapters.test.ts

@@ -1,50 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { adaptBootstrap, adaptConversationPage } from "./adapters.js";
-import { createMe, createMembership, createMessage } from "./test-helpers.js";
-
-describe("adapters", () => {
-  it("adapts bootstrap payloads into date-backed objects", () => {
-    const result = adaptBootstrap({
-      me: createMe({
-        created_at: 1_700_000_000_000 as unknown as Date,
-      }) as unknown as Record<string, unknown>,
-      memberships: [
-        createMembership({
-          created_at: 1_700_000_000_000 as unknown as Date,
-        }) as unknown as Record<string, unknown>,
-      ],
-    });
-
-    expect(result.me?.created_at).toBeInstanceOf(Date);
-    expect(result.memberships[0]?.created_at).toBeInstanceOf(Date);
-  });
-
-  it("reverses paginated conversation results into chronological order", () => {
-    const newest = createMessage({
-      id: "message-3",
-      created_at: 3 as unknown as Date,
-    });
-    const middle = createMessage({
-      id: "message-2",
-      created_at: 2 as unknown as Date,
-    });
-    const oldest = createMessage({
-      id: "message-1",
-      created_at: 1 as unknown as Date,
-    });
-
-    const page = adaptConversationPage({
-      page: [newest, middle, oldest],
-      isDone: false,
-      continueCursor: "cursor-2",
-    });
-
-    expect(page.items.map((item) => item.id)).toEqual([
-      "message-1",
-      "message-2",
-      "message-3",
-    ]);
-    expect(page.cursor).toBe("cursor-2");
-    expect(page.hasMore).toBe(true);
-  });
-});

package/src/adapters.ts

@@ -1,215 +0,0 @@
-import * as Shared from "@ando/shared";
-import { ConversationPage, DiscoveredWorkspace, Me, Membership, Message } from "./types.js";
-
-type BootstrapResult = {
-  me: Record<string, unknown> | null;
-  memberships: Record<string, unknown>[];
-};
-
-type ConvexPaginatedResult<T> = {
-  page: T[];
-  isDone: boolean;
-  continueCursor: string;
-};
-
-function adaptTimestamp(value: Date | number | string | null | undefined): Date {
-  if (value instanceof Date) {
-    return value;
-  }
-
-  if (typeof value === "number") {
-    return new Date(value);
-  }
-
-  if (typeof value === "string") {
-    return new Date(value);
-  }
-
-  return new Date(0);
-}
-
-function adaptNullableTimestamp(value: Date | number | string | null | undefined) {
-  if (value == null) {
-    return null;
-  }
-
-  return adaptTimestamp(value);
-}
-
-export function adaptDiscoveredWorkspace(
-  workspace: Shared.Contracts.DiscoveredWorkspace
-): DiscoveredWorkspace {
-  return {
-    ...workspace,
-    created_at: adaptTimestamp(workspace.created_at),
-    updated_at: adaptTimestamp(workspace.updated_at),
-  };
-}
-
-function adaptFile(file: Shared.Contracts.FileExtended): Shared.Contracts.FileExtended {
-  return {
-    ...file,
-    created_at: adaptTimestamp(file.created_at),
-    updated_at: adaptTimestamp(file.updated_at),
-  };
-}
-
-function adaptPreviewMember(member: Shared.Models.Member): Shared.Models.Member {
-  return {
-    ...member,
-    created_at: adaptTimestamp(member.created_at),
-    updated_at: adaptTimestamp(member.updated_at),
-    last_active_at: adaptTimestamp(member.last_active_at),
-    last_caught_up_at: adaptTimestamp(member.last_caught_up_at),
-    archived_at: adaptNullableTimestamp(member.archived_at),
-    onboarding_completed_at: adaptNullableTimestamp(member.onboarding_completed_at),
-    last_summary_at: adaptNullableTimestamp(member.last_summary_at),
-  };
-}
-
-export function adaptMember(member: Shared.Contracts.MemberExtended): Shared.Contracts.MemberExtended {
-  return {
-    ...member,
-    created_at: adaptTimestamp(member.created_at),
-    updated_at: adaptTimestamp(member.updated_at),
-    last_active_at: adaptTimestamp(member.last_active_at),
-    last_caught_up_at: adaptTimestamp(member.last_caught_up_at),
-    archived_at: adaptNullableTimestamp(member.archived_at),
-    onboarding_completed_at: adaptNullableTimestamp(member.onboarding_completed_at),
-    last_summary_at: adaptNullableTimestamp(member.last_summary_at),
-    profile_image_file:
-      member.profile_image_file == null ? null : adaptFile(member.profile_image_file),
-  };
-}
-
-export function adaptConversation(
-  conversation: Shared.Contracts.ConversationExtended
-): Shared.Contracts.ConversationExtended {
-  return {
-    ...conversation,
-    created_at: adaptTimestamp(conversation.created_at),
-    updated_at: adaptTimestamp(conversation.updated_at),
-    last_message_at: adaptNullableTimestamp(conversation.last_message_at),
-    last_summary_at: adaptNullableTimestamp(conversation.last_summary_at),
-    archived_at: adaptNullableTimestamp(conversation.archived_at),
-    preview_members: (conversation.preview_members ?? []).map(adaptPreviewMember),
-    creator_member:
-      conversation.creator_member == null
-        ? null
-        : adaptPreviewMember(conversation.creator_member),
-  };
-}
-
-function adaptThreadSubscription(
-  subscription: Shared.Contracts.ThreadSubscriptionExtended
-): Shared.Contracts.ThreadSubscriptionExtended {
-  return {
-    ...subscription,
-    created_at: adaptTimestamp(subscription.created_at),
-    updated_at: adaptTimestamp(subscription.updated_at),
-    last_seen_at: adaptNullableTimestamp(subscription.last_seen_at),
-    thread_root: {
-      ...subscription.thread_root,
-      created_at: adaptTimestamp(subscription.thread_root.created_at),
-      updated_at: adaptTimestamp(subscription.thread_root.updated_at),
-      edited_at: adaptNullableTimestamp(subscription.thread_root.edited_at),
-      pinned_at: adaptNullableTimestamp(subscription.thread_root.pinned_at),
-      last_reply_at: adaptNullableTimestamp(subscription.thread_root.last_reply_at),
-      archived_at: adaptNullableTimestamp(subscription.thread_root.archived_at),
-    },
-  };
-}
-
-export function adaptMembership(
-  membership: Shared.Contracts.MembershipExtended
-): Membership {
-  return {
-    ...membership,
-    created_at: adaptTimestamp(membership.created_at),
-    updated_at: adaptTimestamp(membership.updated_at),
-    last_seen_at: adaptTimestamp(membership.last_seen_at),
-    member: adaptMember(membership.member),
-    conversation: adaptConversation(membership.conversation),
-    thread_subscriptions: (membership.thread_subscriptions ?? []).map(
-      adaptThreadSubscription
-    ),
-  };
-}
-
-export function adaptMessage(
-  message: Shared.Contracts.ConversationMessageExtended
-): Message {
-  return {
-    ...message,
-    created_at: adaptTimestamp(message.created_at),
-    updated_at: adaptTimestamp(message.updated_at),
-    edited_at: adaptNullableTimestamp(message.edited_at),
-    pinned_at: adaptNullableTimestamp(message.pinned_at),
-    last_reply_at: adaptNullableTimestamp(message.last_reply_at),
-    archived_at: adaptNullableTimestamp(message.archived_at),
-    author: adaptMember(message.author),
-    message_reactions: (message.message_reactions ?? []).map((reaction) => ({
-      ...reaction,
-      created_at: adaptTimestamp(reaction.created_at),
-    })),
-    replies_preview_members: (message.replies_preview_members ?? []).map(
-      adaptPreviewMember
-    ),
-    files: (message.files ?? []).map(adaptFile),
-    thread_root_message:
-      message.thread_root_message == null
-        ? null
-        : {
-            ...message.thread_root_message,
-            created_at: adaptTimestamp(message.thread_root_message.created_at),
-            updated_at: adaptTimestamp(message.thread_root_message.updated_at),
-            edited_at: adaptNullableTimestamp(message.thread_root_message.edited_at),
-            pinned_at: adaptNullableTimestamp(message.thread_root_message.pinned_at),
-            last_reply_at: adaptNullableTimestamp(message.thread_root_message.last_reply_at),
-            archived_at: adaptNullableTimestamp(message.thread_root_message.archived_at),
-          },
-  };
-}
-
-function adaptWorkspace(
-  workspace: Shared.Contracts.WorkspaceExtended
-): Shared.Contracts.WorkspaceExtended {
-  return {
-    ...workspace,
-    created_at: adaptTimestamp(workspace.created_at),
-    updated_at: adaptTimestamp(workspace.updated_at),
-    workspace_invite_link: {
-      ...workspace.workspace_invite_link,
-      created_at: adaptTimestamp(workspace.workspace_invite_link.created_at),
-    },
-  };
-}
-
-export function adaptMe(member: Shared.Contracts.MeExtended): Me {
-  return {
-    ...adaptMember(member),
-    workspace: adaptWorkspace(member.workspace),
-  };
-}
-
-export function adaptBootstrap(result: BootstrapResult) {
-  return {
-    me:
-      result.me == null
-        ? null
-        : adaptMe(result.me as unknown as Shared.Contracts.MeExtended),
-    memberships: result.memberships.map((membership) =>
-      adaptMembership(membership as unknown as Shared.Contracts.MembershipExtended)
-    ),
-  };
-}
-
-export function adaptConversationPage(
-  result: ConvexPaginatedResult<Shared.Contracts.ConversationMessageExtended>
-): ConversationPage {
-  return {
-    items: [...result.page].reverse().map(adaptMessage),
-    cursor: result.isDone ? null : result.continueCursor,
-    hasMore: !result.isDone,
-  };
-}

package/src/args.test.ts

@@ -1,28 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { getStringFlag, hasFlag, parseArgs } from "./args.js";
-
-describe("args", () => {
-  it("parses long and short flags with values", () => {
-    const parsed = parseArgs([
-      "list-messages",
-      "--channel",
-      "engineering",
-      "-n",
-      "20",
-      "--json",
-    ]);
-
-    expect(parsed.positionals).toEqual(["list-messages"]);
-    expect(getStringFlag(parsed, "channel", "c")).toBe("engineering");
-    expect(getStringFlag(parsed, "limit", "n")).toBe("20");
-    expect(hasFlag(parsed, "json")).toBe(true);
-  });
-
-  it("parses compact short flags", () => {
-    const parsed = parseArgs(["thread", "-vhm", "message-1"]);
-
-    expect(hasFlag(parsed, "verbose", "v")).toBe(true);
-    expect(hasFlag(parsed, "help", "h")).toBe(true);
-    expect(getStringFlag(parsed, "message-id", "m")).toBe("message-1");
-  });
-});

package/src/args.ts

@@ -1,98 +0,0 @@
-import { ParsedArgs } from "./types.js";
-
-export function parseArgs(argv: string[]): ParsedArgs {
-  const flags = new Map<string, string | true>();
-  const positionals: string[] = [];
-
-  for (let index = 0; index < argv.length; index += 1) {
-    const value = argv[index];
-    if (value == null) {
-      continue;
-    }
-
-    if (!value.startsWith("-")) {
-      positionals.push(value);
-      continue;
-    }
-
-    if (value.startsWith("--")) {
-      const [key, inlineValue] = value.slice(2).split("=", 2);
-      if (inlineValue != null) {
-        flags.set(key, inlineValue);
-        continue;
-      }
-
-      const nextValue = argv[index + 1];
-      if (nextValue != null && !nextValue.startsWith("-")) {
-        flags.set(key, nextValue);
-        index += 1;
-      } else {
-        flags.set(key, true);
-      }
-      continue;
-    }
-
-    const shortFlags = value.slice(1);
-    if (shortFlags.length > 1) {
-      for (let shortIndex = 0; shortIndex < shortFlags.length - 1; shortIndex += 1) {
-        const shortFlag = shortFlags[shortIndex];
-        if (shortFlag != null) {
-          flags.set(shortFlag, true);
-        }
-      }
-
-      const lastFlag = shortFlags[shortFlags.length - 1];
-      const nextValue = argv[index + 1];
-      if (lastFlag == null) {
-        continue;
-      }
-
-      if (nextValue != null && !nextValue.startsWith("-")) {
-        flags.set(lastFlag, nextValue);
-        index += 1;
-      } else {
-        flags.set(lastFlag, true);
-      }
-      continue;
-    }
-
-    const nextValue = argv[index + 1];
-    if (nextValue != null && !nextValue.startsWith("-")) {
-      flags.set(shortFlags, nextValue);
-      index += 1;
-    } else {
-      flags.set(shortFlags, true);
-    }
-  }
-
-  return {
-    flags,
-    positionals,
-  };
-}
-
-export function getStringFlag(
-  parsedArgs: ParsedArgs,
-  longName: string,
-  shortName?: string
-) {
-  const longValue = parsedArgs.flags.get(longName);
-  if (typeof longValue === "string") {
-    return longValue;
-  }
-
-  if (shortName == null) {
-    return undefined;
-  }
-
-  const shortValue = parsedArgs.flags.get(shortName);
-  return typeof shortValue === "string" ? shortValue : undefined;
-}
-
-export function hasFlag(
-  parsedArgs: ParsedArgs,
-  longName: string,
-  shortName?: string
-) {
-  return parsedArgs.flags.has(longName) || (shortName != null && parsedArgs.flags.has(shortName));
-}

package/src/cli-helpers.test.ts

@@ -1,82 +0,0 @@
-import { describe, expect, it } from "vitest";
-import * as Shared from "@ando/shared";
-import { compareByRecentActivity, resolveConversation, resolveWorkspace } from "./cli-helpers.js";
-import { createConversation, createMembership } from "./test-helpers.js";
-
-describe("cli helpers", () => {
-  it("resolves a conversation by exact name", () => {
-    const memberships = [
-      createMembership({
-        id: "membership-a",
-        conversation: createConversation({ id: "conversation-a", name: "engineering" }),
-      }),
-    ];
-
-    const result = resolveConversation(memberships, {
-      allowChannels: true,
-      allowDms: true,
-      query: "engineering",
-    });
-
-    expect(result.id).toBe("membership-a");
-  });
-
-  it("throws when a partial conversation match is ambiguous", () => {
-    const memberships = [
-      createMembership({
-        id: "membership-a",
-        conversation: createConversation({ id: "conversation-a", name: "eng-platform" }),
-      }),
-      createMembership({
-        id: "membership-b",
-        conversation: createConversation({ id: "conversation-b", name: "eng-mobile" }),
-      }),
-    ];
-
-    expect(() =>
-      resolveConversation(memberships, {
-        allowChannels: true,
-        allowDms: true,
-        query: "eng",
-      })
-    ).toThrow(/ambiguous/);
-  });
-
-  it("sorts more recent memberships first", () => {
-    const oldMembership = createMembership({
-      id: "old",
-      conversation: createConversation({
-        id: "conversation-old",
-        last_message_at: new Date("2026-04-08T12:00:00.000Z"),
-      }),
-    });
-    const newMembership = createMembership({
-      id: "new",
-      conversation: createConversation({
-        id: "conversation-new",
-        last_message_at: new Date("2026-04-09T12:00:00.000Z"),
-      }),
-    });
-
-    expect(compareByRecentActivity(newMembership, oldMembership)).toBeLessThan(0);
-  });
-
-  it("resolves workspaces by slug", () => {
-    const workspace = {
-      id: "workspace-1",
-      stytch_organization_id: "org-1",
-      name: "Ando",
-      slug: "ando",
-      image_url: null,
-      icon_image_file_id: null,
-      description: null,
-      invite_link_id: "invite-1",
-      created_at: new Date("2026-04-09T12:00:00.000Z"),
-      updated_at: new Date("2026-04-09T12:00:00.000Z"),
-      member_count: 3,
-    } satisfies Shared.Contracts.DiscoveredWorkspace;
-
-    const result = resolveWorkspace([workspace], "ando");
-    expect(result.id).toBe("workspace-1");
-  });
-});

package/src/cli-helpers.ts

@@ -1,149 +0,0 @@
-import * as Shared from "@ando/shared";
-import { DiscoveredWorkspace, Membership } from "./types.js";
-
-export function isChannel(membership: Membership) {
-  return membership.conversation.type === Shared.Models.ConversationType.CHANNEL;
-}
-
-function normalizeForMatch(value: string) {
-  return value.trim().toLowerCase();
-}
-
-export function compareByRecentActivity(left: Membership, right: Membership) {
-  const leftDate = new Date(
-    left.conversation.last_message_at ?? left.conversation.updated_at
-  ).getTime();
-  const rightDate = new Date(
-    right.conversation.last_message_at ?? right.conversation.updated_at
-  ).getTime();
-
-  return rightDate - leftDate;
-}
-
-export function getWorkspaceLabel(workspace: DiscoveredWorkspace) {
-  return `${workspace.name} (${workspace.slug})`;
-}
-
-export function resolveWorkspace(
-  workspaces: DiscoveredWorkspace[],
-  query: string | null
-) {
-  if (workspaces.length === 0) {
-    throw new Error("No workspaces were returned for this account.");
-  }
-
-  if (query == null || query.trim() === "") {
-    if (workspaces.length === 1) {
-      return workspaces[0] ?? null;
-    }
-
-    throw new Error("Multiple workspaces are available. Pass --workspace or choose one interactively.");
-  }
-
-  const normalizedQuery = normalizeForMatch(query);
-  const exactMatch =
-    workspaces.find((workspace) => {
-      return (
-        workspace.id === query ||
-        normalizeForMatch(workspace.slug) === normalizedQuery ||
-        normalizeForMatch(workspace.name) === normalizedQuery
-      );
-    }) ?? null;
-
-  if (exactMatch != null) {
-    return exactMatch;
-  }
-
-  const partialMatches = workspaces.filter((workspace) => {
-    return [workspace.id, workspace.slug, workspace.name].some((value) =>
-      normalizeForMatch(value).includes(normalizedQuery)
-    );
-  });
-
-  if (partialMatches.length === 1) {
-    return partialMatches[0] ?? null;
-  }
-
-  if (partialMatches.length === 0) {
-    throw new Error(`No workspace matched "${query}".`);
-  }
-
-  throw new Error(
-    `Workspace "${query}" is ambiguous: ${partialMatches
-      .slice(0, 8)
-      .map(getWorkspaceLabel)
-      .join(", ")}`
-  );
-}
-
-export function resolveConversation(
-  memberships: Membership[],
-  options: {
-    allowDms: boolean;
-    allowChannels: boolean;
-    query: string;
-  }
-) {
-  const filtered = memberships
-    .filter((membership) => {
-      if (!options.allowChannels && isChannel(membership)) {
-        return false;
-      }
-
-      if (!options.allowDms && !isChannel(membership)) {
-        return false;
-      }
-
-      return true;
-    })
-    .sort(compareByRecentActivity);
-
-  const normalizedQuery = normalizeForMatch(options.query);
-  const exactMatch =
-    filtered.find((membership) => {
-      return (
-        membership.conversation.id === options.query ||
-        normalizeForMatch(membership.conversation.name ?? "") === normalizedQuery
-      );
-    }) ?? null;
-
-  if (exactMatch != null) {
-    return exactMatch;
-  }
-
-  const partialMatches = filtered.filter((membership) => {
-    const fields = [
-      membership.conversation.id,
-      membership.conversation.name ?? "",
-      getConversationLabel(membership),
-    ];
-
-    return fields.some((value) =>
-      normalizeForMatch(value).includes(normalizedQuery)
-    );
-  });
-
-  if (partialMatches.length === 1) {
-    return partialMatches[0] ?? null;
-  }
-
-  if (partialMatches.length === 0) {
-    throw new Error(`No conversation matched "${options.query}".`);
-  }
-
-  throw new Error(
-    `Conversation "${options.query}" is ambiguous: ${partialMatches
-      .slice(0, 8)
-      .map((membership) => getConversationLabel(membership))
-      .join(", ")}`
-  );
-}
-
-export function getConversationLabel(membership: Membership) {
-  const prefix =
-    membership.conversation.type === Shared.Models.ConversationType.CHANNEL
-      ? "#"
-      : "@";
-
-  return `${prefix}${membership.conversation.name || membership.conversation.id}`;
-}