@xmtp/convos-cli 0.1.0

package/dist/commands/conversation/invite.js

@@ -0,0 +1,137 @@
+import { Args, Flags } from "@oclif/core";
+import { requireGroup } from "../../utils/xmtp.js";
+import qrcode from "qrcode-terminal";
+import { ConvosBaseCommand } from "../../baseCommand.js";
+import { createClientForIdentity } from "../../utils/client.js";
+import { createIdentityStore } from "../../utils/identities.js";
+import { createInviteSlug } from "../../utils/invite.js";
+import { parseAppData, serializeAppData } from "../../utils/metadata.js";
+import { randomAlphanumeric } from "../../utils/random.js";
+export default class ConversationInvite extends ConvosBaseCommand {
+    static description = `Generate an invite link for a conversation.
+
+Creates a cryptographic invite slug that others can use to request
+to join this conversation (per ADR 001).
+
+The invite contains:
+- An encrypted conversation ID (only the creator can decrypt)
+- The creator's inbox ID (for routing the join request DM)
+- An invite tag (for verification and revocation)
+- Optional metadata (name, description)
+- A secp256k1 ECDSA signature
+
+Displays a QR code in the terminal that can be scanned by the
+Convos app. The QR code encodes the full invite URL.
+
+Invite URLs use the format:
+- Dev:        dev.convos.org/v2?i=<slug>
+- Production: popup.convos.org/v2?i=<slug>`;
+    static examples = [
+        {
+            command: "<%= config.bin %> <%= command.id %> <conversation-id>",
+            description: "Generate an invite with QR code (default)",
+        },
+        {
+            command: "<%= config.bin %> <%= command.id %> <conversation-id> --no-qr",
+            description: "Generate an invite without QR code",
+        },
+        {
+            command: "<%= config.bin %> <%= command.id %> <conversation-id> --expires-in 3600",
+            description: "Generate an invite that expires in 1 hour",
+        },
+        {
+            command: "<%= config.bin %> <%= command.id %> <conversation-id> --single-use --json",
+            description: "Generate a single-use invite with JSON output",
+        },
+    ];
+    static args = {
+        id: Args.string({ description: "The conversation ID", required: true }),
+    };
+    static flags = {
+        ...ConvosBaseCommand.baseFlags,
+        qr: Flags.boolean({
+            description: "Display a QR code in the terminal",
+            default: true,
+            allowNo: true,
+        }),
+        "expires-in": Flags.integer({
+            description: "Invite expires in N seconds from now",
+            helpValue: "<seconds>",
+        }),
+        "single-use": Flags.boolean({
+            description: "Invite expires after first use",
+            default: false,
+        }),
+        "include-metadata": Flags.boolean({
+            description: "Include conversation name/description in invite",
+            default: true,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ConversationInvite);
+        const config = this.getConvosConfig();
+        const store = createIdentityStore();
+        const identity = store.getByConversationId(args.id);
+        if (!identity) {
+            this.error(`No identity found for conversation: ${args.id}`);
+        }
+        const client = await createClientForIdentity(identity, config);
+        const conversation = await client.conversations.getConversationById(args.id);
+        if (!conversation) {
+            this.error(`Conversation not found: ${args.id}`);
+        }
+        const group = requireGroup(conversation);
+        // Get or create invite tag from appData (using proper protobuf metadata)
+        let appData = "";
+        try {
+            appData = group.appData ?? "";
+        }
+        catch {
+            // No appData yet
+        }
+        let metadata = parseAppData(appData);
+        let inviteTag = metadata.tag;
+        if (!inviteTag) {
+            inviteTag = randomAlphanumeric(10);
+            metadata = { ...metadata, tag: inviteTag };
+            await group.updateAppData(serializeAppData(metadata));
+        }
+        const expiresAt = flags["expires-in"]
+            ? new Date(Date.now() + flags["expires-in"] * 1000)
+            : undefined;
+        const slug = await createInviteSlug(args.id, client.inboxId, inviteTag, identity.walletKey, {
+            name: flags["include-metadata"] ? group.name || undefined : undefined,
+            description: flags["include-metadata"]
+                ? group.description || undefined
+                : undefined,
+            expiresAt,
+            expiresAfterUse: flags["single-use"],
+        });
+        // Build invite URL based on environment
+        const env = config.env ?? "dev";
+        const baseUrl = env === "production"
+            ? "https://popup.convos.org/v2"
+            : "https://dev.convos.org/v2";
+        const inviteUrl = `${baseUrl}?i=${encodeURIComponent(slug)}`;
+        // Display QR code unless --no-qr or --json
+        if (flags.qr && !flags.json) {
+            this.log(""); // blank line before QR
+            await new Promise((resolve) => {
+                qrcode.generate(inviteUrl, { small: true }, (code) => {
+                    this.log(code);
+                    resolve();
+                });
+            });
+            this.log(`  ${inviteUrl}\n`);
+        }
+        this.output({
+            conversationId: args.id,
+            slug,
+            url: inviteUrl,
+            tag: inviteTag,
+            env,
+            expiresAt: expiresAt?.toISOString() ?? null,
+            singleUse: flags["single-use"],
+        });
+    }
+}

package/dist/commands/conversation/lock.d.ts

@@ -0,0 +1,24 @@
+import { ConvosBaseCommand } from "../../baseCommand.js";
+export default class ConversationLock extends ConvosBaseCommand {
+    static description: string;
+    static examples: {
+        command: string;
+        description: string;
+    }[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        unlock: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "log-level": import("@oclif/core/interfaces").OptionFlag<"off" | "error" | "warn" | "info" | "debug" | "trace" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "structured-logging": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "app-version": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "env-file": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        env: import("@oclif/core/interfaces").OptionFlag<"local" | "dev" | "production" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "gateway-host": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/conversation/lock.js

@@ -0,0 +1,98 @@
+import { Args, Flags } from "@oclif/core";
+import { requireGroup } from "../../utils/xmtp.js";
+import { ConvosBaseCommand } from "../../baseCommand.js";
+import { createClientForIdentity } from "../../utils/client.js";
+import { createIdentityStore } from "../../utils/identities.js";
+import { parseAppData, serializeAppData } from "../../utils/metadata.js";
+import { randomAlphanumeric } from "../../utils/random.js";
+export default class ConversationLock extends ConvosBaseCommand {
+    static description = `Lock or unlock a conversation.
+
+Locking prevents new members from joining (per ADR 006) by:
+1. Rotating the invite tag (cryptographically invalidates all existing invites)
+2. Setting the XMTP addMember permission to 'deny'
+
+Unlocking restores the ability to add members. Previously shared
+invites remain invalid — generate new ones after unlocking.
+
+Only super admins can lock/unlock.`;
+    static examples = [
+        {
+            command: "<%= config.bin %> <%= command.id %> <conversation-id>",
+            description: "Lock a conversation",
+        },
+        {
+            command: "<%= config.bin %> <%= command.id %> <conversation-id> --unlock",
+            description: "Unlock a conversation",
+        },
+    ];
+    static args = {
+        id: Args.string({ description: "The conversation ID", required: true }),
+    };
+    static flags = {
+        ...ConvosBaseCommand.baseFlags,
+        unlock: Flags.boolean({
+            description: "Unlock instead of locking",
+            default: false,
+        }),
+        force: Flags.boolean({
+            char: "f",
+            description: "Skip confirmation prompt",
+            default: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ConversationLock);
+        const config = this.getConvosConfig();
+        const store = createIdentityStore();
+        const identity = store.getByConversationId(args.id);
+        if (!identity)
+            this.error(`No identity found for conversation: ${args.id}`);
+        if (!flags.unlock) {
+            await this.confirmAction("Locking prevents new members from joining and invalidates all existing invites.", flags.force);
+        }
+        const client = await createClientForIdentity(identity, config);
+        const conversation = await client.conversations.getConversationById(args.id);
+        if (!conversation)
+            this.error(`Conversation not found: ${args.id}`);
+        const group = requireGroup(conversation);
+        if (flags.unlock) {
+            // Rotate invite tag first so the new invite is ready before members can add others
+            let appData = "";
+            try {
+                appData = group.appData ?? "";
+            }
+            catch {
+                // No appData yet
+            }
+            const metadata = parseAppData(appData);
+            metadata.tag = randomAlphanumeric(10);
+            await group.updateAppData(serializeAppData(metadata));
+            await group.updatePermission(0 /* PermissionUpdateType.AddMember */, 0 /* PermissionPolicy.Allow */);
+        }
+        else {
+            // Step 1: Rotate the invite tag to invalidate all existing invites
+            let appData = "";
+            try {
+                appData = group.appData ?? "";
+            }
+            catch {
+                // No appData yet
+            }
+            const metadata = parseAppData(appData);
+            metadata.tag = randomAlphanumeric(10);
+            await group.updateAppData(serializeAppData(metadata));
+            // Step 2: Set addMember permission to deny
+            await group.updatePermission(0 /* PermissionUpdateType.AddMember */, 1 /* PermissionPolicy.Deny */);
+        }
+        const action = flags.unlock ? "unlocked" : "locked";
+        this.output({
+            success: true,
+            conversationId: args.id,
+            action,
+            message: flags.unlock
+                ? "Conversation unlocked. Generate new invites to allow members."
+                : "Conversation locked. Invite tag rotated and all existing invites invalidated.",
+        });
+    }
+}

package/dist/commands/conversation/members.d.ts

@@ -0,0 +1,22 @@
+import { ConvosBaseCommand } from "../../baseCommand.js";
+export default class ConversationMembers extends ConvosBaseCommand {
+    static description: string;
+    static examples: {
+        command: string;
+        description: string;
+    }[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        "log-level": import("@oclif/core/interfaces").OptionFlag<"off" | "error" | "warn" | "info" | "debug" | "trace" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "structured-logging": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "app-version": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "env-file": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        env: import("@oclif/core/interfaces").OptionFlag<"local" | "dev" | "production" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "gateway-host": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/conversation/members.js

@@ -0,0 +1,39 @@
+import { Args } from "@oclif/core";
+import { ConvosBaseCommand } from "../../baseCommand.js";
+import { createClientForIdentity } from "../../utils/client.js";
+import { createIdentityStore } from "../../utils/identities.js";
+export default class ConversationMembers extends ConvosBaseCommand {
+    static description = `List members of a conversation.
+
+Shows all members with their inbox IDs, identifiers, and permission levels.`;
+    static examples = [
+        {
+            command: "<%= config.bin %> <%= command.id %> <conversation-id>",
+            description: "List members",
+        },
+    ];
+    static args = {
+        id: Args.string({ description: "The conversation ID", required: true }),
+    };
+    static flags = { ...ConvosBaseCommand.baseFlags };
+    async run() {
+        const { args } = await this.parse(ConversationMembers);
+        const config = this.getConvosConfig();
+        const store = createIdentityStore();
+        const identity = store.getByConversationId(args.id);
+        if (!identity) {
+            this.error(`No identity found for conversation: ${args.id}`);
+        }
+        const client = await createClientForIdentity(identity, config);
+        const conversation = await client.conversations.getConversationById(args.id);
+        if (!conversation) {
+            this.error(`Conversation not found: ${args.id}`);
+        }
+        const members = await conversation.members();
+        this.output(members.map((m) => ({
+            inboxId: m.inboxId,
+            accountIdentifiers: m.accountIdentifiers,
+            permissionLevel: m.permissionLevel,
+        })));
+    }
+}

package/dist/commands/conversation/messages.d.ts

@@ -0,0 +1,31 @@
+import { ConvosBaseCommand } from "../../baseCommand.js";
+export default class ConversationMessages extends ConvosBaseCommand {
+    static description: string;
+    static examples: {
+        command: string;
+        description: string;
+    }[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        sync: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        direction: import("@oclif/core/interfaces").OptionFlag<"ascending" | "descending", import("@oclif/core/interfaces").CustomOptions>;
+        "sent-before": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "sent-after": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "delivery-status": import("@oclif/core/interfaces").OptionFlag<"unpublished" | "published" | "failed" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        kind: import("@oclif/core/interfaces").OptionFlag<"application" | "membership-change" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "content-type": import("@oclif/core/interfaces").OptionFlag<("text" | "markdown" | "reaction" | "reply" | "attachment" | "remote-attachment" | "actions" | "custom" | "group-membership-change" | "group-updated" | "intent" | "leave-request" | "multi-remote-attachment" | "read-receipt" | "transaction-reference" | "wallet-send-calls")[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "exclude-content-type": import("@oclif/core/interfaces").OptionFlag<("text" | "markdown" | "reaction" | "reply" | "attachment" | "remote-attachment" | "actions" | "custom" | "group-membership-change" | "group-updated" | "intent" | "leave-request" | "multi-remote-attachment" | "read-receipt" | "transaction-reference" | "wallet-send-calls")[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "log-level": import("@oclif/core/interfaces").OptionFlag<"off" | "error" | "warn" | "info" | "debug" | "trace" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "structured-logging": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "app-version": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "env-file": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        env: import("@oclif/core/interfaces").OptionFlag<"local" | "dev" | "production" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "gateway-host": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/conversation/messages.js

@@ -0,0 +1,141 @@
+import { Args, Flags } from "@oclif/core";
+import { ConvosBaseCommand } from "../../baseCommand.js";
+import { createClientForIdentity } from "../../utils/client.js";
+import { createIdentityStore } from "../../utils/identities.js";
+import { buildProfileMap, normalizeMessageContent, requireGroup, } from "../../utils/xmtp.js";
+const contentTypeOptions = [
+    "actions", "attachment", "custom", "group-membership-change",
+    "group-updated", "intent", "leave-request", "markdown",
+    "multi-remote-attachment", "reaction", "read-receipt",
+    "remote-attachment", "reply", "text", "transaction-reference",
+    "wallet-send-calls",
+];
+const contentTypeMap = {
+    actions: 0 /* ContentType.Actions */, attachment: 1 /* ContentType.Attachment */,
+    custom: 2 /* ContentType.Custom */,
+    "group-membership-change": 3 /* ContentType.GroupMembershipChange */,
+    "group-updated": 4 /* ContentType.GroupUpdated */, intent: 5 /* ContentType.Intent */,
+    "leave-request": 6 /* ContentType.LeaveRequest */, markdown: 7 /* ContentType.Markdown */,
+    "multi-remote-attachment": 8 /* ContentType.MultiRemoteAttachment */,
+    reaction: 9 /* ContentType.Reaction */, "read-receipt": 10 /* ContentType.ReadReceipt */,
+    "remote-attachment": 11 /* ContentType.RemoteAttachment */, reply: 12 /* ContentType.Reply */,
+    text: 13 /* ContentType.Text */,
+    "transaction-reference": 14 /* ContentType.TransactionReference */,
+    "wallet-send-calls": 15 /* ContentType.WalletSendCalls */,
+};
+export default class ConversationMessages extends ConvosBaseCommand {
+    static description = `List messages in a conversation.
+
+Retrieves messages using the per-conversation identity.
+Supports filtering, pagination, and sorting.`;
+    static examples = [
+        {
+            command: "<%= config.bin %> <%= command.id %> <conversation-id>",
+            description: "List messages",
+        },
+        {
+            command: "<%= config.bin %> <%= command.id %> <conversation-id> --sync --limit 10",
+            description: "Sync and show last 10 messages",
+        },
+    ];
+    static args = {
+        id: Args.string({ description: "The conversation ID", required: true }),
+    };
+    static flags = {
+        ...ConvosBaseCommand.baseFlags,
+        sync: Flags.boolean({
+            description: "Sync from network before listing",
+            default: false,
+        }),
+        limit: Flags.integer({
+            description: "Maximum number of messages",
+            helpValue: "<number>",
+        }),
+        direction: Flags.option({
+            options: ["ascending", "descending"],
+            description: "Sort direction",
+            default: "descending",
+        })(),
+        "sent-before": Flags.string({
+            description: "Only messages sent before this timestamp (nanoseconds)",
+            helpValue: "<ns>",
+        }),
+        "sent-after": Flags.string({
+            description: "Only messages sent after this timestamp (nanoseconds)",
+            helpValue: "<ns>",
+        }),
+        "delivery-status": Flags.option({
+            options: ["unpublished", "published", "failed"],
+            description: "Filter by delivery status",
+        })(),
+        kind: Flags.option({
+            options: ["application", "membership-change"],
+            description: "Filter by message kind",
+        })(),
+        "content-type": Flags.option({
+            options: contentTypeOptions,
+            description: "Filter by content type (repeatable)",
+            multiple: true,
+        })(),
+        "exclude-content-type": Flags.option({
+            options: contentTypeOptions,
+            description: "Exclude content type (repeatable)",
+            multiple: true,
+        })(),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ConversationMessages);
+        const config = this.getConvosConfig();
+        const store = createIdentityStore();
+        const identity = store.getByConversationId(args.id);
+        if (!identity) {
+            this.error(`No identity found for conversation: ${args.id}`);
+        }
+        const client = await createClientForIdentity(identity, config);
+        const conversation = await client.conversations.getConversationById(args.id);
+        if (!conversation) {
+            this.error(`Conversation not found: ${args.id}`);
+        }
+        if (flags.sync)
+            await conversation.sync();
+        const options = {};
+        if (flags.limit !== undefined)
+            options.limit = flags.limit;
+        options.direction = flags.direction === "ascending"
+            ? 0 /* SortDirection.Ascending */ : 1 /* SortDirection.Descending */;
+        options.sentBeforeNs = this.parseBigInt(flags["sent-before"], "sent-before");
+        options.sentAfterNs = this.parseBigInt(flags["sent-after"], "sent-after");
+        if (flags["delivery-status"]) {
+            const map = {
+                unpublished: 0 /* DeliveryStatus.Unpublished */,
+                published: 1 /* DeliveryStatus.Published */,
+                failed: 2 /* DeliveryStatus.Failed */,
+            };
+            options.deliveryStatus = map[flags["delivery-status"]];
+        }
+        if (flags.kind) {
+            const map = {
+                application: 0 /* GroupMessageKind.Application */,
+                "membership-change": 1 /* GroupMessageKind.MembershipChange */,
+            };
+            options.kind = map[flags.kind];
+        }
+        if (flags["content-type"]?.length) {
+            options.contentTypes = flags["content-type"].map((ct) => contentTypeMap[ct]);
+        }
+        if (flags["exclude-content-type"]?.length) {
+            options.excludeContentTypes = flags["exclude-content-type"].map((ct) => contentTypeMap[ct]);
+        }
+        const group = requireGroup(conversation);
+        const profiles = buildProfileMap(group.appData ?? "");
+        const messages = await conversation.messages(options);
+        this.output(messages.map((m) => ({
+            id: m.id,
+            senderInboxId: m.senderInboxId,
+            contentType: m.contentType,
+            content: normalizeMessageContent(m, profiles),
+            sentAt: m.sentAt.toISOString(),
+            deliveryStatus: m.deliveryStatus,
+        })));
+    }
+}

package/dist/commands/conversation/permissions.d.ts

@@ -0,0 +1,18 @@
+import { ConvosBaseCommand } from "../../baseCommand.js";
+export default class ConversationPermissions extends ConvosBaseCommand {
+    static description: string;
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        "log-level": import("@oclif/core/interfaces").OptionFlag<"off" | "error" | "warn" | "info" | "debug" | "trace" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "structured-logging": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "app-version": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "env-file": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        env: import("@oclif/core/interfaces").OptionFlag<"local" | "dev" | "production" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "gateway-host": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/conversation/permissions.js

@@ -0,0 +1,33 @@
+import { Args } from "@oclif/core";
+import { requireGroup } from "../../utils/xmtp.js";
+import { ConvosBaseCommand } from "../../baseCommand.js";
+import { createClientForIdentity } from "../../utils/client.js";
+import { createIdentityStore } from "../../utils/identities.js";
+export default class ConversationPermissions extends ConvosBaseCommand {
+    static description = `View permissions for a conversation.`;
+    static args = {
+        id: Args.string({ description: "The conversation ID", required: true }),
+    };
+    static flags = { ...ConvosBaseCommand.baseFlags };
+    async run() {
+        const { args } = await this.parse(ConversationPermissions);
+        const config = this.getConvosConfig();
+        const store = createIdentityStore();
+        const identity = store.getByConversationId(args.id);
+        if (!identity)
+            this.error(`No identity found for conversation: ${args.id}`);
+        const client = await createClientForIdentity(identity, config);
+        const conversation = await client.conversations.getConversationById(args.id);
+        if (!conversation)
+            this.error(`Conversation not found: ${args.id}`);
+        const group = requireGroup(conversation);
+        const permissions = group.permissions();
+        this.output({
+            conversationId: args.id,
+            policyType: permissions.policyType,
+            policySet: permissions.policySet,
+            admins: group.listAdmins(),
+            superAdmins: group.listSuperAdmins(),
+        });
+    }
+}

package/dist/commands/conversation/profiles.d.ts

@@ -0,0 +1,22 @@
+import { ConvosBaseCommand } from "../../baseCommand.js";
+export default class Profiles extends ConvosBaseCommand {
+    static description: string;
+    static examples: {
+        command: string;
+        description: string;
+    }[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        "log-level": import("@oclif/core/interfaces").OptionFlag<"off" | "error" | "warn" | "info" | "debug" | "trace" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "structured-logging": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "app-version": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "env-file": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        env: import("@oclif/core/interfaces").OptionFlag<"local" | "dev" | "production" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "gateway-host": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/conversation/profiles.js

@@ -0,0 +1,80 @@
+import { Args } from "@oclif/core";
+import { requireGroup } from "../../utils/xmtp.js";
+import { ConvosBaseCommand } from "../../baseCommand.js";
+import { createClientForIdentity } from "../../utils/client.js";
+import { createIdentityStore } from "../../utils/identities.js";
+import { parseAppData } from "../../utils/metadata.js";
+export default class Profiles extends ConvosBaseCommand {
+    static description = `List member profiles in a conversation.
+
+Shows display names and avatar URLs for all members who have set
+a profile in this conversation. Profiles are stored in the group's
+metadata and are visible to all members (ADR 005).
+
+Members without a profile appear as anonymous with just their inbox ID.`;
+    static examples = [
+        {
+            command: "<%= config.bin %> <%= command.id %> <conversation-id>",
+            description: "List all member profiles",
+        },
+        {
+            command: "<%= config.bin %> <%= command.id %> <conversation-id> --json",
+            description: "List profiles as JSON",
+        },
+    ];
+    static args = {
+        id: Args.string({
+            description: "The conversation ID",
+            required: true,
+        }),
+    };
+    static flags = {
+        ...ConvosBaseCommand.baseFlags,
+    };
+    async run() {
+        const { args } = await this.parse(Profiles);
+        const config = this.getConvosConfig();
+        const store = createIdentityStore();
+        const identity = store.getByConversationId(args.id);
+        if (!identity) {
+            this.error(`No identity found for conversation ${args.id}`);
+        }
+        const client = await createClientForIdentity(identity, config);
+        await client.conversations.sync();
+        const conversation = await client.conversations.getConversationById(args.id);
+        if (!conversation) {
+            this.error(`Conversation ${args.id} not found`);
+        }
+        const group = requireGroup(conversation);
+        // Parse metadata
+        let appData = "";
+        try {
+            appData = group.appData ?? "";
+        }
+        catch {
+            // No appData yet
+        }
+        const metadata = parseAppData(appData);
+        // Get all members for completeness
+        const members = await group.members();
+        const memberInboxIds = members.map((m) => m.inboxId);
+        // Build profile list — include all members, mark which have profiles
+        const profileList = memberInboxIds.map((inboxId) => {
+            const profile = metadata.profiles.find((p) => p.inboxId.toLowerCase() === inboxId.toLowerCase());
+            const isMe = inboxId === client.inboxId;
+            return {
+                inboxId,
+                name: profile?.name ?? null,
+                image: profile?.image ?? null,
+                hasProfile: !!profile,
+                isMe,
+            };
+        });
+        this.output({
+            conversationId: args.id,
+            memberCount: memberInboxIds.length,
+            profileCount: metadata.profiles.length,
+            profiles: profileList,
+        });
+    }
+}