@sendbird/cli 0.0.0-stage → 0.3.0-alpha.1

package/dist/human-output.js

@@ -0,0 +1,1351 @@
+import { humanValueSemantics } from "./value-semantics.js";
+import { proOutput } from "./human-pro.js";
+import { redact, secretValues } from "./core.js";
+import { clean, paragraph, clip, commandLine, countLabel, fieldLabel, localTime, primary, record, row, table, titleCase, valueText, view, width, } from "./human-format.js";
+import { listOutput } from "./human-list.js";
+/** Shared wizard summary: all prompt details stay on stderr, including in JSON mode. */
+export function setupContextSummary(selection, options = {}) {
+    const ctx = view({
+        ...options,
+        color: false,
+        width: options.width ?? process.stderr.columns ?? process.stdout.columns,
+    });
+    return [
+        "Review setup defaults",
+        row("Profile", selection.profile, ctx),
+        row("Environment", selection.environment, ctx),
+        row("Organization UID", selection.org_id, ctx),
+        row("App ID", selection.app_id, ctx),
+        row("App region", selection.app_region ?? "Not reported", ctx),
+        row("Default region", selection.region ?? "Not selected", ctx),
+        ...paragraph("Saving makes this profile active. Explicit flags and environment variables still take precedence. Sign-in and resources created above are kept even if you skip saving; reauthentication may reset the old account context.", ctx),
+    ].join("\n");
+}
+function detailRows(command, result, target, ctx) {
+    const details = [];
+    const notes = [];
+    let heading = titleCase(entity(command));
+    const add = (label, value) => {
+        if (value !== undefined && value !== null && value !== "")
+            details.push([label, value]);
+    };
+    switch (command) {
+        case "calls settings push get":
+            heading = "Calls Push availability";
+            add("App", result.app_id ?? target.app_id);
+            add("Calls enabled", result.is_calls_enabled ?? "Unknown");
+            add("Region", result.region);
+            add("Flag source", result.calls_flag_source);
+            add("Calls API", "Verify regional access with calls settings general get");
+            add("Shared Push enabled", result.push_enabled ?? "Unknown");
+            add("Policy", "The shared switch is read-only here");
+            break;
+        case "calls settings general get":
+            heading = "Calls General settings";
+            for (const [key, label] of Object.entries({
+                relay_method: "Relay",
+                direct_call_cloud_recording_enabled: "Direct recording",
+                group_call_cloud_recording_enabled: "Group recording",
+                direct_call_recording_video: "Recording video",
+                direct_call_recording_display_timestamp: "Timestamp overlay",
+                direct_call_recording_timestamp_timezone: "Timezone",
+            }))
+                add(label, key === "direct_call_recording_timestamp_timezone" &&
+                    record(result.general)?.[key] === ""
+                    ? "Default"
+                    : key === "relay_method" && record(result.general)?.[key] === "turn"
+                        ? "Server relay only (turn)"
+                        : key === "relay_method" &&
+                            record(result.general)?.[key] === "stun&turn"
+                            ? "P2P first, relay fallback (stun&turn)"
+                            : record(result.general)?.[key]);
+            break;
+        case "calls settings webhook get":
+        case "calls settings chat-integration get": {
+            const key = command.includes("webhook") ? "webhook" : "chat_integration";
+            const settings = record(result[key]) ?? {};
+            heading =
+                key === "webhook" ? "Calls Webhook settings" : "Calls Chat integration";
+            add("Enabled", settings.enabled);
+            add("URL", settings.url);
+            add("Enabled events", Array.isArray(settings.enabled_events)
+                ? settings.enabled_events.join(", ") || "None"
+                : undefined);
+            add("Available events", Array.isArray(settings.all_webhook_categories ??
+                settings.all_chat_integration_categories)
+                ? (settings.all_webhook_categories ??
+                    settings.all_chat_integration_categories)
+                : undefined);
+            break;
+        }
+        case "profile":
+            heading = `Profile ${valueText(result.current)}`;
+            add("Environment", result.environment);
+            add("Active", result.active);
+            if (result.current !== result.active)
+                add("Selection", result.source);
+            add("Organization UID", result.org_id);
+            add("App", result.app_id);
+            add("Region", result.region);
+            break;
+        case "project status": {
+            const project = record(result.project);
+            heading = project
+                ? "Sendbird project linked"
+                : "No Sendbird project link";
+            add("File", result.path);
+            if (project) {
+                add("App ID", project.app_id);
+                add("Organization UID", project.org_id);
+                add("Region", project.region);
+                add("Profile", project.profile);
+            }
+            if (Array.isArray(result.next) && result.next.length)
+                add("Next", result.next[0]);
+            break;
+        }
+        case "auth status": {
+            const user = record(result.user);
+            const role = record(result.role);
+            heading = `Signed in${user?.email ? ` as ${clean(user.email)}` : ""}`;
+            add("Profile", result.profile);
+            add("Environment", result.environment);
+            add("Role", role?.name);
+            const permissions = role?.permissions;
+            if (Array.isArray(permissions) &&
+                permissions.every((p) => typeof p === "string")) {
+                const unique = [...new Set(permissions)];
+                add("Permissions", unique.length ? `${unique.length} returned` : "None returned");
+                for (const permission of unique.slice(0, 12))
+                    notes.push(...paragraph(`- ${permission}`, ctx));
+                if (unique.length > 12)
+                    notes.push(...paragraph(`${unique.length - 12} more permissions; use auth status --json for the complete list.`, ctx));
+            }
+            else
+                add("Permissions", "Not reported");
+            notes.push(...paragraph("Role permissions reported by the server; command access also depends on the target and API policy.", ctx));
+            add("Organizations", Array.isArray(result.organizations)
+                ? result.organizations.length
+                : record(result.organization)
+                    ? 1
+                    : undefined);
+            if (Array.isArray(result.organizations) &&
+                result.organizations.length === 1)
+                add("Organization", record(result.organizations[0])?.name);
+            else if (record(result.organization))
+                add("Organization", record(result.organization)?.name);
+            break;
+        }
+        case "doctor":
+            if (Array.isArray(result.checks))
+                return diagnosticLines(result, ctx);
+            heading = "Dashboard access verified";
+            add("Profile", result.profile);
+            add("Organization UID", result.org_id ?? "Not selected");
+            add("App", result.app_id ?? "Not selected");
+            add("Role", record(result.role)?.name);
+            if (Array.isArray(result.next) && result.next.length)
+                add("Next", result.next[0]);
+            break;
+        case "app auth-policy get":
+            heading = "Chat access-token policy";
+            add("Token policy", result.guest_user_policy);
+            break;
+        case "app get": {
+            heading = `Application ${valueText(result.app_name ?? result.app_id)}`;
+            add("App ID", result.app_id ?? target.app_id);
+            add("Region", result.region);
+            add("Plan", result.plan);
+            add("Token policy", result.guest_user_policy);
+            add("SDK family", result.is_delight_region === true ? "Delight" : "Standard");
+            const features = record(result.current_premium_features);
+            for (const [label, key] of [
+                ["Supergroup", "super_group_channel"],
+                ["Reactions", "reactions"],
+                ["Poll", "poll"],
+            ]) {
+                const reported = features?.[key];
+                add(label, reported === true
+                    ? "Reported enabled"
+                    : reported === false
+                        ? "Reported disabled"
+                        : "Not reported");
+            }
+            notes.push(...paragraph("Feature source: current_premium_features (plan snapshot). Runtime access has not been tested; these values do not prove support or denial. Use doctor for separate plan, activation and access checks.", ctx));
+            break;
+        }
+        case "chat user get":
+            heading = `User ${valueText(result.nickname ?? result.user_id)}`;
+            add("User ID", result.user_id ?? target.user_id);
+            add("Active", result.is_active);
+            add("Online", result.is_online);
+            add("Metadata keys", record(result.metadata)
+                ? Object.keys(record(result.metadata)).length
+                : undefined);
+            add("Created", typeof result.created_at === "number"
+                ? localTime(result.created_at)
+                : undefined);
+            break;
+        case "chat channel get":
+            heading = `${titleCase(valueText(target.channel_type || (result.is_super ? "supergroup" : "group")))} channel ${valueText(result.name || result.channel_url)}`;
+            add("Channel URL", result.channel_url ?? target.channel_url);
+            add("Members", result.member_count);
+            add("Public", result.is_public);
+            add("Frozen", result.freeze);
+            add("Created", typeof result.created_at === "number"
+                ? localTime(result.created_at)
+                : undefined);
+            break;
+        case "chat sdk status":
+            heading = `Connected as ${valueText(record(result.user)?.user_id ?? target.actor_user_id)}`;
+            add("App", result.app_id ?? target.app_id);
+            break;
+        case "chat sdk message translate": {
+            heading = `Translated message ${valueText(result.message_id ?? target.message_id)}`;
+            add("Channel", result.channel_url ?? target.channel_url);
+            add("Original", result.message);
+            for (const [language, text] of Object.entries(record(result.translations) ?? {}))
+                add(clean(language), text);
+            break;
+        }
+        case "chat message get":
+            heading = `Message ${valueText(result.message_id ?? target.message_id)}`;
+            add("Sender", record(result.sender)?.user_id);
+            add("Channel", result.channel_url ?? target.channel_url);
+            add("Message", result.message);
+            add("Mention type", result.mention_type);
+            if (Array.isArray(result.mentioned_user_ids))
+                add("Mentioned users", result.mentioned_user_ids.join(", ") || "None");
+            add("File requires SDK auth", result.requires_auth);
+            add("Created", typeof result.created_at === "number"
+                ? localTime(result.created_at)
+                : undefined);
+            break;
+        default: {
+            const ignored = new Set([
+                "attrs",
+                "plans",
+                "access_token",
+                "api_token",
+                "session_tokens",
+                "profile_url",
+                "current_premium_features",
+                "current_core_features",
+                "created_by",
+            ]);
+            if (command === "org get") {
+                add("Organization UID", result.uid);
+                ignored.add("uid");
+            }
+            for (const [key, value] of Object.entries(result)) {
+                if (ignored.has(key))
+                    continue;
+                if (["string", "number", "boolean"].includes(typeof value))
+                    add(fieldLabel(key), value);
+                if (details.length >= 8)
+                    break;
+            }
+            if (!details.length && result !== null)
+                add("Result", Object.keys(result).length
+                    ? `${Object.keys(result).length} fields; use --json for details`
+                    : "No data returned");
+        }
+    }
+    return [
+        ctx.color.bold(clip(heading, ctx.width - 2)),
+        ...details.map(([label, value]) => row(label, value, ctx)),
+        ...notes,
+    ];
+}
+const verbs = {
+    init: "Linked",
+    create: "Created",
+    delete: "Deleted",
+    revoke: "Revoked",
+    issue: "Issued",
+    send: "Sent",
+    file: "Sent",
+    reply: "Sent",
+    invite: "Invited",
+    update: "Updated",
+    set: "Updated",
+    rename: "Renamed",
+    use: "Selected",
+    clear: "Cleared",
+    activate: "Activated",
+    deactivate: "Deactivated",
+    submit: "Submitted",
+    accept: "Accepted",
+    decline: "Declined",
+    join: "Joined",
+    leave: "Left",
+    login: "Signed in",
+    logout: "Signed out",
+    signup: "Signed up",
+    "verify-email": "Verified email",
+    "resend-verification": "Sent verification email",
+    "send-now": "Sent",
+    cancel: "Canceled",
+    pin: "Pinned",
+    unpin: "Unpinned",
+    freeze: "Froze",
+    unfreeze: "Unfroze",
+    mute: "Muted",
+    unmute: "Unmuted",
+    ban: "Banned",
+    unban: "Unbanned",
+    read: "Marked read",
+};
+export function entity(command) {
+    if (command.startsWith("calls settings "))
+        return `Calls ${command.split(" ")[2]} settings`;
+    if (command.startsWith("calls push "))
+        return "Calls push credentials";
+    if (command.startsWith("project "))
+        return "project";
+    if (command.startsWith("chat sdk message scheduled "))
+        return "scheduled message";
+    if (command.startsWith("chat sdk message "))
+        return "message";
+    if (command.startsWith("chat sdk user push "))
+        return "push notifications";
+    if (command.startsWith("chat sdk user invitation "))
+        return "invitation preference";
+    if (command.startsWith("chat sdk channel count-preference "))
+        return "unread count preference";
+    if (command.startsWith("chat sdk channel snooze "))
+        return "snooze";
+    if (command.startsWith("chat sdk channel "))
+        return "channel";
+    if (command.startsWith("chat message "))
+        return "message";
+    if (command.startsWith("chat channel metadata "))
+        return "channel metadata";
+    if (command.startsWith("chat channel members "))
+        return "members";
+    if (command.startsWith("chat channel "))
+        return "channel";
+    if (command.startsWith("chat user token "))
+        return "user access token";
+    if (command.startsWith("chat user metadata "))
+        return "user metadata";
+    if (command.startsWith("chat user "))
+        return "user";
+    if (command.startsWith("app feature "))
+        return "application feature";
+    if (command.startsWith("app auth-policy "))
+        return "authentication policy";
+    if (command.startsWith("app "))
+        return "application";
+    if (command.startsWith("org region "))
+        return "region";
+    if (command.startsWith("org "))
+        return "organization";
+    if (command.startsWith("profile "))
+        return "profile";
+    if (command.startsWith("support ticket "))
+        return "support ticket";
+    return command.split(" ").slice(0, -1).join(" ") || "request";
+}
+function receipt(value, ctx) {
+    const command = value.command.replace(/^sendbird /, "");
+    const result = record(value.result) ?? {};
+    const target = value.target;
+    const action = command.slice(command.lastIndexOf(" ") + 1);
+    const verb = verbs[action] ?? "Completed";
+    const kind = entity(command);
+    const identity = command.startsWith("chat message ")
+        ? (result.message_id ?? target.message_id)
+        : command.startsWith("chat channel ")
+            ? (result.channel_url ?? target.channel_url)
+            : command.startsWith("chat user ")
+                ? (result.user_id ?? target.user_id)
+                : command === "app create"
+                    ? (record(result.application)?.app_id ?? target.app_id)
+                    : command === "org create"
+                        ? ((Array.isArray(result.organizations)
+                            ? record(result.organizations[0])?.uid
+                            : undefined) ?? target.org_id)
+                        : command === "app use"
+                            ? (result.app_id ?? target.app_id)
+                            : command === "org use"
+                                ? (result.org_id ?? target.org_id)
+                                : command === "org region use"
+                                    ? result.region
+                                    : command.startsWith("profile ")
+                                        ? (result.name ?? result.active ?? result.deleted)
+                                        : undefined;
+    let headline = `${verb} ${kind}${identity ? ` ${clean(identity)}` : ""}`;
+    if (command === "chat channel create" && target.channel_type)
+        headline = `Created ${titleCase(clean(target.channel_type))} channel ${valueText(identity)}`;
+    if (command === "org clear")
+        headline = "Cleared organization, app and region";
+    if (command === "app clear")
+        headline = "Cleared application selection";
+    if (command === "auth login" && record(result.user)?.email)
+        headline = `Signed in as ${clean(record(result.user)?.email)}`;
+    if (command === "auth logout")
+        headline = "Signed out";
+    if (command === "auth signup")
+        headline = "Signed in after signup";
+    if (command === "auth verify-email")
+        headline = "Verified email";
+    if (command === "auth resend-verification")
+        headline = "Sent verification email";
+    if (command === "setup")
+        headline =
+            result.defaults_saved === false
+                ? "Chat setup checked"
+                : "Chat setup complete";
+    if (command === "project init")
+        headline = "Linked Sendbird project";
+    if (command === "chat channel members invite")
+        headline = `Invited members to ${valueText(target.channel_url)}`;
+    if (command === "calls activate")
+        headline = "Calls activation accepted";
+    const lines = [
+        `${ctx.color.green("✓")} ${ctx.color.bold(clip(headline, ctx.width - 2))}`,
+    ];
+    const trial = record(result.calls_trial);
+    if (trial) {
+        lines.push(row("Free trial", titleCase(clean(trial.status)), ctx));
+        lines.push(...paragraph(trial.note, ctx));
+        if (trial.code)
+            lines.push(row("Trial code", trial.code, ctx));
+        const next = Array.isArray(trial.next) ? record(trial.next[0]) : undefined;
+        lines.push(row("Next", Array.isArray(next?.argv)
+            ? commandLine(next.argv)
+            : "sendbird calls credits list", ctx, 300));
+    }
+    if (command.startsWith("chat message ") && typeof result.message === "string")
+        lines.push(row("Message", result.message, ctx));
+    if (command.startsWith("chat message ")) {
+        if (result.mention_type)
+            lines.push(row("Mention", result.mention_type, ctx));
+        if (Array.isArray(result.mentioned_user_ids))
+            lines.push(row("Mentioned users", result.mentioned_user_ids.join(", ") || "None", ctx));
+        if (Array.isArray(result.meta_arrays))
+            lines.push(row("Meta-array keys", result.meta_arrays
+                .map((v) => record(v)?.key)
+                .filter(Boolean)
+                .join(", ") || "None", ctx));
+    }
+    if (command === "app auth-policy set")
+        lines.push(row("Token policy", result.guest_user_policy, ctx));
+    if (command === "app create" && record(result.application)?.app_name)
+        lines.push(row("Name", record(result.application)?.app_name, ctx));
+    if (command === "org create" && Array.isArray(result.organizations))
+        lines.push(row("Organization", primary(result.organizations[0]) || target.org_id, ctx));
+    if (target.channel_url && !command.startsWith("chat channel "))
+        lines.push(row("Channel", target.channel_url, ctx));
+    if (target.app_id &&
+        !["app create", "app use", "project init"].includes(command))
+        lines.push(row("App", target.app_id, ctx));
+    if (command.startsWith("calls ")) {
+        if (command === "calls activate") {
+            const readback = record(result.readback);
+            lines.push(row("Activation", readback.status === "matches"
+                ? "Enabled (read back)"
+                : readback.status === "mismatch"
+                    ? "Not confirmed; inspect app state"
+                    : "Readback unavailable; registration accepted", ctx));
+            lines.push(row("Next", "sendbird calls settings push get", ctx));
+            if (!trial)
+                lines.push(row("Credits", "No trial credits claimed or credits purchased", ctx), row("Next", "sendbird calls credits list", ctx));
+            return lines;
+        }
+        if (result.configuration_id)
+            lines.push(row("Configuration", result.configuration_id, ctx));
+        const readback = record(result.readback);
+        if (readback) {
+            lines.push(row("Readback", readback.status === "read_completed"
+                ? "Settings read again"
+                : "Unavailable; write was accepted", ctx));
+            const settings = record(readback.settings);
+            if (settings && command.startsWith("calls settings "))
+                lines.push(...detailRows(command.replace(/ set$/, " get"), settings, target, ctx));
+            lines.push(row("Next", Array.isArray(readback.next) &&
+                record(readback.next[0]) &&
+                Array.isArray(record(readback.next[0]).argv)
+                ? commandLine(record(readback.next[0]).argv)
+                : command.startsWith("calls push ")
+                    ? `sendbird calls push list --push-type ${valueText(result.push_type ?? "TYPE")}`
+                    : `sendbird ${command.replace(/ set$/, " get")}`, ctx));
+        }
+    }
+    if (command === "setup") {
+        if (target.org_id)
+            lines.push(row("Organization UID", target.org_id, ctx));
+        if (result.profile)
+            lines.push(row("Profile", result.profile, ctx));
+        if (result.environment)
+            lines.push(row("Environment", result.environment, ctx));
+        if ("region" in result)
+            lines.push(row("Default region", result.region ?? "Not selected", ctx));
+        if ("defaults_saved" in result)
+            lines.push(row("Defaults", result.defaults_saved
+                ? "Saved; profile is active"
+                : "Not saved; use the explicit next command", ctx));
+        lines.push(row("Next", Array.isArray(result.next_argv)
+            ? commandLine(result.next_argv.map(String))
+            : "sendbird doctor", ctx), row("Agent skills", "sendbird skills status", ctx));
+    }
+    if (command === "project init") {
+        lines.push(row("File", result.path, ctx));
+        lines.push(row("App ID", record(result.project)?.app_id, ctx));
+    }
+    if (command === "auth logout" && result.remote_revocation === "unknown")
+        lines.push(`  ${ctx.color.yellow("!")} Remote token revocation is uncertain.`);
+    if (Array.isArray(result.next) && result.next.length)
+        lines.push(row("Next", result.next[0], ctx));
+    return lines;
+}
+function preview(value, ctx) {
+    const command = value.command.replace(/^sendbird /, "");
+    const result = record(value.result) ?? {};
+    const request = record(result.request);
+    const target = value.target;
+    const action = command.slice(command.lastIndexOf(" ") + 1);
+    const imperative = {
+        create: "Create",
+        delete: "Delete",
+        set: "Update",
+        update: "Update",
+        send: "Send",
+        invite: "Invite",
+        revoke: "Revoke",
+        issue: "Issue",
+        "claim-trial": "Request free trial for",
+        list: "List",
+        search: "Search",
+        get: "Get",
+        join: "Join",
+        leave: "Leave",
+    };
+    const kind = command === "chat channel create" && target.channel_type
+        ? `${titleCase(clean(target.channel_type))} channel`
+        : entity(command);
+    const lines = [
+        ctx.color.bold(`Preview · ${imperative[action] ?? titleCase(action)} ${kind}`),
+    ];
+    if (command.startsWith("calls credits "))
+        lines.push(row("Organization", target.org_id, ctx));
+    if (target.app_id)
+        lines.push(row("App", target.app_id, ctx));
+    if (target.channel_url)
+        lines.push(row("Channel", target.channel_url, ctx));
+    if (target.user_id)
+        lines.push(row("User", target.user_id, ctx));
+    if (request?.method && request.path)
+        lines.push(row("Request", `${request.method} ${request.path}`, ctx, 200));
+    if (result.mode === "dashboard_handoff") {
+        lines.push(row("Requested", result.requested_plan, ctx));
+        lines.push(`  ${ctx.color.dim("Offline billing preview; no quote, eligibility check or subscription change.")}`);
+    }
+    if (record(result.calls_trial))
+        lines.push(row("Free trial", "After activation: check eligibility, then request trial; no calls made in this preview", ctx));
+    if (result.sdk)
+        lines.push(row("SDK", result.sdk, ctx, 200));
+    for (const [scope, fields] of [
+        ["body", request?.body ?? result.body],
+        ["query", request?.query],
+        ["params", result.params],
+    ]) {
+        const source = record(fields);
+        if (!source)
+            continue;
+        for (const [key, item] of Object.entries(source).slice(0, 7))
+            lines.push(row(fieldLabel(key), Array.isArray(item) ? item.join(", ") : item, ctx));
+        if (Object.keys(source).length > 7)
+            lines.push(`  ${ctx.color.dim(`More ${scope} fields: --json`)}`);
+    }
+    if ((command === "app feature set" ||
+        command === "calls credits claim-trial") &&
+        result.note)
+        lines.push(...paragraph(result.note, ctx));
+    lines.push(`  ${ctx.color.dim("No request sent. Access and remote state were not checked.")}`);
+    return lines;
+}
+function profileList(result, ctx) {
+    const profiles = record(result.profiles) ?? {};
+    const entries = Object.entries(profiles).map(([name, value]) => ({
+        name,
+        ...record(value),
+    }));
+    const lines = [
+        ctx.color.bold(countLabel(entries.length, "profile")),
+        row("Active", result.active, ctx),
+    ];
+    lines.push(...table(entries, [
+        { label: "Profile", value: (r) => r.name, max: 30 },
+        { label: "Environment", value: (r) => r.env, max: 18 },
+        {
+            label: "Organization",
+            value: (r) => (r.orgId ? "Selected" : "—"),
+            max: 18,
+        },
+        { label: "App", value: (r) => (r.appId ? "Selected" : "—"), max: 13 },
+    ], ctx));
+    return lines;
+}
+function billingUsageRead(command, result, target, ctx) {
+    const targetRows = [
+        ...(target.org_id ? [row("Organization UID", target.org_id, ctx)] : []),
+        ...(target.app_id ? [row("App", target.app_id, ctx)] : []),
+    ];
+    if ([
+        "billing plan check",
+        "billing plan change",
+        "billing plan verify",
+    ].includes(command)) {
+        const handoff = record(result.handoff);
+        const organization = record(result.organization);
+        const current = record(result.current_subscription);
+        const future = record(result.future_subscription);
+        const reviewReasons = {
+            sales_contract: "Current plan uses a sales contract",
+            aws_marketplace: "Billing is managed through AWS Marketplace",
+            sales_plan: "Requested plan requires Sales",
+            shopify_billing: "Billing is managed through Shopify",
+            legacy_organization: "Legacy organization needs Dashboard review",
+            managed_payment: "Payment is managed by your account team",
+            scheduled_subscription: "A subscription change is already scheduled",
+            cancellation_scheduled: "Cancellation is already scheduled",
+            already_current: "Requested plan is already current",
+            dashboard_selection_required: "Select this plan in Dashboard",
+            payment_method_required: "Register a payment method in Dashboard",
+            organization_inactive: "Organization is inactive",
+            subscription_type_requires_review: "Current contract type needs review",
+        };
+        const observed = {
+            current: "Current subscription",
+            scheduled: "Scheduled subscription",
+            not_reflected: "No matching subscription yet",
+        };
+        return [
+            ctx.color.bold(command === "billing plan verify"
+                ? "Chat plan status checked"
+                : "Chat plan change requires Dashboard confirmation"),
+            ...targetRows,
+            ...(organization ? [row("Name", organization.name, ctx)] : []),
+            row("Requested", result.requested_plan, ctx),
+            row("Current", current?.subscription_name ?? "None", ctx),
+            row("Scheduled", future?.subscription_name ?? "None", ctx),
+            ...(result.change_state
+                ? [
+                    row("Observed state", observed[String(result.change_state)] ?? result.change_state, ctx),
+                ]
+                : []),
+            ...(result.selection_state
+                ? [
+                    row("Selection", result.selection_state === "catalog_candidate"
+                        ? "Catalog candidate; confirm in Dashboard"
+                        : "Dashboard review required", ctx),
+                ]
+                : []),
+            ...(Array.isArray(result.reasons)
+                ? result.reasons.map((reason) => row("Review required", reviewReasons[String(reason)] ?? reason, ctx))
+                : []),
+            ...(typeof result.card_present === "boolean"
+                ? [row("Card registered", result.card_present, ctx)]
+                : []),
+            ...(handoff
+                ? [
+                    row("Dashboard", handoff.url, ctx),
+                    row("Action", handoff.instruction ??
+                        "Review the organization, price and effective date in Dashboard", ctx),
+                ]
+                : []),
+            `  ${ctx.color.dim("No subscription change was submitted by this command.")}`,
+            row("Next", result.next, ctx),
+        ];
+    }
+    if (command === "billing plan current") {
+        const current = record(result.current_subscription);
+        const future = record(result.future_subscription);
+        return [
+            ctx.color.bold("Chat subscription"),
+            ...targetRows,
+            row("Current", current?.display_name ?? current?.subscription_name ?? "None", ctx),
+            ...(current
+                ? [
+                    row("Plan key", current.subscription_name, ctx),
+                    row("Type", current.subscription_type, ctx),
+                    row("Auto-renewal", current.auto_renewal, ctx),
+                    row("Next billing", current.next_billing_date ?? "Not provided", ctx),
+                ]
+                : []),
+            row("Scheduled", future?.display_name ?? future?.subscription_name ?? "None", ctx),
+            ...(future
+                ? [
+                    row("Effective", future.apply_date ?? future.start_date ?? "Not provided", ctx),
+                ]
+                : []),
+        ];
+    }
+    if (command === "billing plan list") {
+        const plans = Object.entries(result).map(([key, value]) => {
+            const entry = record(value);
+            const plan = record(entry?.plan);
+            return {
+                key,
+                cycle: entry?.billing_cycle_months,
+                mau: record(plan?.mau)?.purchased_units,
+            };
+        });
+        return [
+            ctx.color.bold(plans.length
+                ? countLabel(plans.length, "catalog plan")
+                : "No catalog plans returned."),
+            ...targetRows,
+            ...table(plans.slice(0, 12), [
+                { label: "Plan key", value: (r) => r.key, max: 38 },
+                { label: "Cycle (months)", value: (r) => r.cycle, max: 18 },
+                { label: "MAU", value: (r) => r.mau, max: 15 },
+            ], ctx),
+            ...(plans.length > 12
+                ? [row("More", "Use --json for the full catalog", ctx)]
+                : []),
+            `  ${ctx.color.dim("Catalog entries are not eligibility decisions or price quotes.")}`,
+        ];
+    }
+    if (command === "usage chat org") {
+        const data = Array.isArray(result.data)
+            ? result.data.map(record).filter((r) => r !== undefined)
+            : [];
+        return [
+            ctx.color.bold(data.length
+                ? countLabel(data.length, "Chat usage month")
+                : "No Chat usage found for these months."),
+            ...targetRows,
+            ...table(data.slice(0, 12), [
+                { label: "Month", value: (r) => r.record_month, max: 12 },
+                { label: "MAU", value: (r) => r.mau, max: 15 },
+                { label: "Peak conn", value: (r) => r.pc, max: 15 },
+                {
+                    label: "Avg storage (bytes)",
+                    value: (r) => r.avg_file_storage,
+                    max: 24,
+                },
+            ], ctx),
+            ...(data.length > 12
+                ? [row("More", "Use --json for every month and feature", ctx)]
+                : []),
+        ];
+    }
+    if (command === "usage chat app") {
+        const data = record(result.data) ?? {};
+        const metrics = [
+            "mau",
+            "pc",
+            "upload_traffic",
+            "avg_file_storage",
+            "file_storage",
+        ]
+            .map((key) => ({ key, value: record(data[key]) }))
+            .filter((entry) => entry.value !== undefined);
+        return [
+            ctx.color.bold("Application Chat usage"),
+            ...targetRows,
+            row("Updated", data.updated_dt ?? "Not provided", ctx),
+            ...table(metrics, [
+                { label: "Feature", value: (r) => r.key, max: 24 },
+                { label: "App", value: (r) => record(r.value)?.usage, max: 16 },
+                {
+                    label: "Other apps",
+                    value: (r) => record(r.value)?.others_usage,
+                    max: 18,
+                },
+                { label: "Quota", value: (r) => record(r.value)?.quota, max: 16 },
+            ], ctx),
+            `  ${ctx.color.dim("Units vary by feature; use --json for source values and all fields.")}`,
+        ];
+    }
+    if (command === "usage calls org") {
+        if (Array.isArray(result.data)) {
+            const apps = result.data;
+            return [
+                ctx.color.bold(apps.length
+                    ? `${countLabel(apps.length, "application")} with voice/video usage`
+                    : "No voice/video usage found."),
+                ...targetRows,
+                ...apps
+                    .slice(0, 12)
+                    .flatMap((app) => [
+                    row("Application", app.app_name, ctx),
+                    row("App ID", app.app_id, ctx),
+                    row("Seconds", app.usage, ctx),
+                    row("Credits", app.used_credit, ctx),
+                    row("Calls enabled", app.call_enabled, ctx),
+                ]),
+                ...(apps.length > 12
+                    ? [row("More", "Use --json for every application", ctx)]
+                    : []),
+                `  ${ctx.color.dim("The source can include Live usage; this is not a Chat subscription charge.")}`,
+            ];
+        }
+        const data = record(result.data) ?? {};
+        const types = Object.entries(data).map(([key, value]) => ({
+            key,
+            value: record(value),
+        }));
+        return [
+            ctx.color.bold(types.length
+                ? countLabel(types.length, "voice/video usage type")
+                : "No voice/video usage found."),
+            ...targetRows,
+            ...table(types.slice(0, 12), [
+                { label: "Type", value: (r) => r.key, max: 40 },
+                { label: "Seconds", value: (r) => record(r.value)?.usage, max: 18 },
+                {
+                    label: "Credits",
+                    value: (r) => record(r.value)?.used_credit,
+                    max: 18,
+                },
+            ], ctx),
+            ...(types.length > 12
+                ? [row("More", "Use --json for every type", ctx)]
+                : []),
+            `  ${ctx.color.dim("The source can include Live usage; this is not a Chat subscription charge.")}`,
+        ];
+    }
+    if (command === "usage calls app") {
+        const data = record(result.data) ?? {};
+        return [
+            ctx.color.bold("Application voice/video usage"),
+            ...targetRows,
+            row("Seconds", data.usage, ctx),
+            row("Credits used", data.used_credit, ctx),
+            row("Org credits", data.org_credit, ctx),
+            row("Org remaining", data.org_remaining_credit, ctx),
+            `  ${ctx.color.dim("Source totals may include Live. Use --json for all fields.")}`,
+        ];
+    }
+    if (command === "usage calls trend") {
+        const data = record(result.data) ?? {};
+        const calls = Array.isArray(data.calls)
+            ? data.calls.map(record).filter((r) => r !== undefined)
+            : [];
+        return [
+            ctx.color.bold(calls.length
+                ? countLabel(calls.length, "Calls usage period")
+                : "No Calls usage found for this period."),
+            ...targetRows,
+            ...table(calls.slice(0, 12), [
+                { label: "Period", value: (r) => r.record_date, max: 18 },
+                { label: "Seconds", value: (r) => r.usage, max: 18 },
+                { label: "Credits", value: (r) => r.used_credit, max: 18 },
+            ], ctx),
+            ...(calls.length > 12
+                ? [row("More", "Use --json for every period", ctx)]
+                : []),
+            `  ${ctx.color.dim("Calls only here; --json retains total and Live series.")}`,
+        ];
+    }
+    if (command === "usage calls app-trend") {
+        const periods = Array.isArray(result.data)
+            ? result.data.map(record).filter((item) => item !== undefined)
+            : [];
+        return [
+            ctx.color.bold(periods.length
+                ? countLabel(periods.length, "voice/video usage period")
+                : "No voice/video usage found for this app and period."),
+            ...targetRows,
+            ...table(periods.slice(0, 12), [
+                { label: "Period", value: (r) => r.record_date, max: 18 },
+                { label: "Updated", value: (r) => r.updated_dt, max: 27 },
+                {
+                    label: "Usage types",
+                    value: (r) => Object.values(r).filter((item) => record(item)?.usage !== undefined).length,
+                    max: 15,
+                },
+            ], ctx),
+            `  ${ctx.color.dim("Use --json for seconds and credits by type, including any Live usage.")}`,
+        ];
+    }
+}
+export function humanOperation(value, options = {}) {
+    const ctx = view(options);
+    const secrets = secretValues(value.result);
+    const safeValue = {
+        ...value,
+        target: redact(value.target, secrets),
+        result: redact(value.result, secrets),
+    };
+    const command = safeValue.command.replace(/^sendbird /, "");
+    if (safeValue.status !== "preview")
+        safeValue.result = humanValueSemantics(command, safeValue.result);
+    const result = record(safeValue.result) ?? {};
+    if (command.startsWith("skills ")) {
+        const lines = [];
+        if (command === "skills show") {
+            lines.push(ctx.color.bold("Sendbird CLI Skill"), row("Path", result.path, ctx), "", clean(result.content));
+            if (Array.isArray(result.references))
+                for (const path of result.references)
+                    lines.push(row("Path", path, ctx));
+        }
+        else if (Array.isArray(result.installations)) {
+            lines.push(ctx.color.bold("Sendbird CLI Skill registrations"), row("CLI version", result.bundled_version, ctx));
+            for (const item of result.installations) {
+                const r = record(item) ?? {};
+                lines.push("", ctx.color.bold(`${clean(r.agent)} · ${clean(r.scope)}`), row("State", clean(r.state).replaceAll("_", " "), ctx), row("Version", r.version ?? "—", ctx), row("Path", r.path ?? "Unavailable", ctx));
+                const transaction = record(r.transaction);
+                if (transaction?.lock_present)
+                    lines.push(...paragraph("A registration lock exists; work may be active or interrupted. Inspect before manual recovery.", ctx));
+                if (Array.isArray(transaction?.backup_paths))
+                    for (const path of transaction.backup_paths)
+                        lines.push(row("Path", path, ctx));
+            }
+        }
+        else {
+            const state = clean(result.state).replaceAll("_", " ");
+            lines.push(ctx.color.bold(safeValue.status === "preview"
+                ? `Preview CLI Skill registration · ${state}`
+                : ({
+                    installed: "Registered Sendbird CLI Skill",
+                    updated: "Updated Sendbird CLI Skill",
+                    current: "CLI Skill already current",
+                    removed: "Removed CLI Skill registration",
+                    absent: "No CLI Skill registered at this location",
+                }[String(result.state)] ?? `CLI Skill · ${state}`)), row("Agent", result.agent, ctx), row("Scope", result.scope, ctx), row("Path", result.path, ctx), row("Version", result.version, ctx), row("Host loading", "Not verified", ctx));
+        }
+        lines.push(...paragraph(result.note, ctx), ...paragraph(result.next, ctx));
+        return lines.join("\n");
+    }
+    if (safeValue.status === "preview")
+        return preview(safeValue, ctx).join("\n");
+    if (command.startsWith("calls credits ")) {
+        const lines = [
+            ctx.color.bold(command.endsWith("list")
+                ? "Calls voucher history"
+                : "Free Calls trial request accepted"),
+            row("Organization", result.org_id, ctx),
+        ];
+        const entries = (Array.isArray(result.vouchers) ? result.vouchers : [result.voucher])
+            .map(record)
+            .filter((entry) => Boolean(entry));
+        if (!entries.length)
+            lines.push(result.total === 0
+                ? "  No voucher history returned."
+                : "  Voucher details not returned.");
+        for (const entry of entries) {
+            const voucher = entry;
+            lines.push(row("Voucher", voucher.voucher_id, ctx), row("Status", voucher.status, ctx), row("Credits", voucher.credit, ctx), row("Carried credits", voucher.transferred_credit, ctx), row("Used credits", voucher.used_credit, ctx), row("Balance", voucher.remaining_credit, ctx), row("Started", voucher.started_at ? localTime(voucher.started_at) : "Not started", ctx), row("Expires", voucher.expires_at ? localTime(voucher.expires_at) : "Not provided", ctx));
+        }
+        const readback = record(result.readback);
+        if (readback)
+            lines.push(row("Readback", readback.status, ctx), ...paragraph(readback.note, ctx));
+        else
+            lines.push(...paragraph(result.note, ctx));
+        if (typeof result.next_offset === "number")
+            lines.push(row("Next offset", result.next_offset, ctx));
+        lines.push(...paragraph("Check status and expiry. A balance alone does not prove active credit or call availability.", ctx));
+        if (command.endsWith("claim-trial")) {
+            const next = Array.isArray(readback?.next)
+                ? readback.next
+                    .map(record)
+                    .find((step) => Array.isArray(step?.argv) &&
+                    step.argv.length > 0 &&
+                    step.argv.every((arg) => typeof arg === "string"))
+                : undefined;
+            lines.push(row("Next", next
+                ? commandLine(next.argv)
+                : "sendbird calls credits list", ctx));
+        }
+        return lines.join("\n");
+    }
+    if (command.startsWith("app feature ")) {
+        const lines = [
+            ctx.color.bold(command.endsWith("list")
+                ? "Application feature settings"
+                : "Feature change accepted"),
+            row("App", safeValue.target.app_id, ctx),
+        ];
+        if (command.endsWith("list")) {
+            lines.push(...table(result.features ?? [], [
+                { label: "Feature", value: (r) => r.feature, min: 30, max: 34 },
+                {
+                    label: "Enabled",
+                    value: (r) => r.enabled === null ? "Unknown" : r.enabled ? "Yes" : "No",
+                    min: 10,
+                    max: 12,
+                },
+            ], ctx));
+        }
+        else {
+            lines.push(row("Feature", result.feature, ctx), row("Requested", result.requested_enabled === true ? "Enabled" : "Disabled", ctx));
+            const readback = record(result.readback);
+            lines.push(row("Readback", readback?.status === "matches"
+                ? "Requested settings observed"
+                : readback?.status === "mismatch"
+                    ? "Different settings observed; inspect before another change"
+                    : "Unavailable; write was accepted", ctx));
+            if (result.feature === "advanced_profanity_filter" &&
+                result.requested_enabled === true)
+                lines.push(...paragraph("The basic profanity filter was also requested off, matching Dashboard behavior.", ctx));
+            const next = Array.isArray(readback?.next)
+                ? record(readback.next[0])
+                : undefined;
+            if (Array.isArray(next?.argv))
+                lines.push(...paragraph("Verify: " + commandLine(next.argv), ctx));
+        }
+        lines.push(...paragraph(result.note, ctx));
+        return lines.join("\n");
+    }
+    const pro = proOutput(command, result, safeValue.target, safeValue.status === "accepted", ctx);
+    if (pro)
+        return pro.join("\n");
+    if (safeValue.status === "accepted" ||
+        (safeValue.status === "succeeded" &&
+            (command === "setup" ||
+                /\b(create|use|clear|delete|init|login|logout|signup|verify-email|resend-verification)$/.test(command))))
+        return receipt(safeValue, ctx).join("\n");
+    if (command === "profile list")
+        return profileList(result, ctx).join("\n");
+    const billingUsage = billingUsageRead(command, result, safeValue.target, ctx);
+    if (billingUsage)
+        return billingUsage.join("\n");
+    const listed = listOutput(command, result, safeValue.target, ctx);
+    if (listed)
+        return listed.join("\n");
+    if (command === "chat channel watch" || safeValue.status === "completed") {
+        const lines = [`${ctx.color.green("✓")} ${ctx.color.bold("Stream ended")}`];
+        if (safeValue.target.channel_url)
+            lines.push(row("Channel", safeValue.target.channel_url, ctx));
+        if (result.reason)
+            lines.push(row("Reason", result.reason, ctx));
+        if (typeof result.events === "number")
+            lines.push(row("Events", result.events, ctx));
+        return lines.join("\n");
+    }
+    return detailRows(command, result, safeValue.target, ctx).join("\n");
+}
+export function humanEvent(command, value, options = {}) {
+    const ctx = view(options);
+    const event = record(value) ?? {};
+    const channel = record(event.channel);
+    const data = record(event.data);
+    const name = clean(event.event || "event").replaceAll("_", " ");
+    const context = [
+        event.channel_url ?? channel?.channel_url,
+        data?.message_id ? `message ${data.message_id}` : undefined,
+    ]
+        .filter(Boolean)
+        .map(clean);
+    return `${ctx.color.dim("•")} ${ctx.color.bold(name)}${context.length ? ` · ${context.join(" · ")}` : ""}`;
+}
+function discovery(value, ctx) {
+    if (value.__human_view === "example") {
+        const shell = clean(value.shell);
+        return [
+            ctx.color.bold(`Example · ${clean(value.command)}`),
+            `  ${shell}`,
+            `  ${ctx.color.dim("Replace placeholder IDs. --example --json returns the structured input.")}`,
+        ];
+    }
+    if (value.__human_view === "schema") {
+        const schema = JSON.stringify(value.schema, null, 2);
+        return [
+            ctx.color.bold(`Response schema · ${clean(value.command)}`),
+            ...schema.split("\n").map((line) => `  ${line}`),
+        ];
+    }
+    if (typeof value.entrypoint === "string" && Array.isArray(value.discovery)) {
+        const steps = value.discovery
+            .map(record)
+            .filter((item) => item !== undefined);
+        return [
+            ctx.color.bold("Sendbird Chat CLI"),
+            "  Manage Chat resources and verify user messaging.",
+            row("Get started", "sendbird setup", ctx),
+            row("Agent skills", "sendbird skills status", ctx),
+            row("Staging app hosts", "sendbird --profile staging --app-id APP_ID app sdk-config --raw", ctx),
+            ...steps
+                .slice(0, 3)
+                .map((item) => row(clean(item.purpose).split(" ").slice(0, 2).join(" "), commandLine(item.argv), ctx, 140)),
+            `  ${ctx.color.dim("For agents: sendbird --json agent")}`,
+        ];
+    }
+    if (typeof value.command === "string" && Array.isArray(value.flags)) {
+        const lines = [ctx.color.bold(clean(value.command))];
+        if (value.description)
+            lines.push(`  ${clean(value.description)}`);
+        if (value.authentication)
+            lines.push(row("Authentication", value.authentication, ctx));
+        if (Array.isArray(value.required) && value.required.length)
+            lines.push(row("Required", value.required.join(", "), ctx));
+        const example = record(value.example);
+        const meanings = record(value.value_semantics);
+        if (Array.isArray(meanings?.fields))
+            lines.push(row("Value meanings", `${meanings.fields.length} fields; use --json describe`, ctx));
+        if (typeof example?.shell === "string") {
+            lines.push(`  ${ctx.color.dim("Example")}`);
+            lines.push(`    ${clean(example.shell)}`);
+        }
+        if (Array.isArray(value.constraints) && value.constraints.length)
+            lines.push(`  ${ctx.color.dim("Notes")}  ${clip(value.constraints[0], ctx.width - 11)}`);
+        lines.push(`  ${ctx.color.dim("Use --json describe for schemas and every flag.")}`);
+        return lines;
+    }
+    if (Array.isArray(value.commands)) {
+        const rows = value.commands
+            .map(record)
+            .filter((item) => item !== undefined);
+        const total = typeof value.total === "number" ? value.total : rows.length;
+        const shown = rows.slice(0, 10);
+        return [
+            ctx.color.bold(countLabel(total, "command")),
+            ...(total > rows.length
+                ? [row("Showing", `${Math.min(rows.length, 10)} of ${total}`, ctx)]
+                : []),
+            ...(ctx.width < 80
+                ? shown.flatMap((item) => [
+                    `  ${ctx.color.bold(clean(item.command))}`,
+                    `    ${ctx.color.dim(clip(item.description, ctx.width - 6))}`,
+                ])
+                : table(shown, [
+                    { label: "Command", value: (r) => r.command, max: 55, min: 52 },
+                    {
+                        label: "Description",
+                        value: (r) => r.description,
+                        max: 55,
+                        min: 20,
+                    },
+                ], ctx)),
+            `  ${ctx.color.dim("Search: sendbird commands --compact --search task words")}`,
+        ];
+    }
+    if (Array.isArray(value.workflows)) {
+        const rows = value.workflows
+            .map(record)
+            .filter((item) => item !== undefined);
+        return [
+            ctx.color.bold(countLabel(rows.length, "workflow")),
+            ...table(rows, [
+                { label: "ID", value: (r) => r.id, max: 30 },
+                { label: "Purpose", value: (r) => r.title, max: 55 },
+            ], ctx),
+            `  ${ctx.color.dim("Inspect: sendbird workflows WORKFLOW_ID")}`,
+        ];
+    }
+    if (Array.isArray(value.steps) && typeof value.id === "string") {
+        const steps = value.steps
+            .map(record)
+            .filter((item) => item !== undefined);
+        const lines = [ctx.color.bold(clean(value.title ?? value.id))];
+        if (value.description)
+            lines.push(`  ${clean(value.description)}`);
+        lines.push(`  ${ctx.color.dim("Plan only; no requests sent.")}`);
+        for (const [index, step] of steps.entries()) {
+            lines.push(`  ${index + 1}. ${ctx.color.bold(clean(step.id))}`);
+            if (Array.isArray(step.argv))
+                lines.push(`     ${commandLine(step.argv)}`);
+        }
+        return lines;
+    }
+    if (Array.isArray(value.results) && typeof value.query === "string") {
+        const rows = value.results
+            .map(record)
+            .filter((item) => item !== undefined);
+        const total = typeof value.total === "number" ? value.total : rows.length;
+        const lines = [
+            ctx.color.bold(rows.length
+                ? `${total} documentation results for “${clean(value.query)}”`
+                : `No documentation results for “${clean(value.query)}”.`),
+        ];
+        if (rows.length) {
+            if (ctx.width < 90 || rows.some((item) => width(clean(item.id)) > 50))
+                lines.push(...rows.flatMap((item) => [
+                    `  ${ctx.color.bold(clean(item.title))}`,
+                    `    ${ctx.color.dim("ID")} ${clean(item.id)}`,
+                ]));
+            else
+                lines.push(...table(rows, [
+                    { label: "Title", value: (r) => r.title, max: 36 },
+                    { label: "Section ID", value: (r) => r.id, max: 50 },
+                ], ctx));
+        }
+        if (typeof value.next_offset === "number")
+            lines.push(row("More", `--offset ${value.next_offset}`, ctx));
+        return lines;
+    }
+}
+/** Bounded, semantic terminal rendering. Machine JSON never calls this module. */
+export function humanValue(value, options = {}) {
+    if (typeof value === "string")
+        return value;
+    if (value === null || value === undefined)
+        return "No data returned.";
+    const ctx = view(options);
+    if (Array.isArray(value)) {
+        const rows = value.map(record).filter((item) => item !== undefined);
+        return rows.length
+            ? table(rows.slice(0, 10), Object.keys(rows[0])
+                .slice(0, 3)
+                .map((key) => ({
+                label: titleCase(key.replaceAll("_", " ")),
+                value: (r) => r[key],
+            })), ctx).join("\n")
+            : "No items found.";
+    }
+    const data = record(redact(value, secretValues(value)));
+    if (!data)
+        return clean(value);
+    if (data.ok === true &&
+        typeof data.command === "string" &&
+        typeof data.status === "string" &&
+        "result" in data)
+        return humanOperation(data, options);
+    if (data.ok === true &&
+        data.type === "event" &&
+        typeof data.command === "string")
+        return humanEvent(data.command.replace(/^sendbird /, ""), data.event, options);
+    const specialized = discovery(data, ctx);
+    if (specialized)
+        return specialized.join("\n");
+    const lines = [ctx.color.bold("Result")];
+    for (const [key, item] of Object.entries(data).slice(0, 10)) {
+        if (Array.isArray(item))
+            lines.push(row(titleCase(key), countLabel(item.length, key.endsWith("s") ? key.slice(0, -1) : "item"), ctx));
+        else if (record(item))
+            lines.push(row(titleCase(key), `${Object.keys(record(item)).length} fields`, ctx));
+        else
+            lines.push(row(titleCase(key), item, ctx));
+    }
+    return lines.join("\n");
+}
+export function humanFailure(value, options = {}) {
+    const ctx = view(options, true);
+    value = record(redact(value, secretValues(value))) ?? {};
+    const message = clean(value.message) || "Command failed";
+    // Reasons and safe next actions must remain readable on narrow terminals.
+    const lines = paragraph(message, ctx).map((line, index) => index === 0 ? `${ctx.color.red("✗")} ${ctx.color.bold(line.trim())}` : line);
+    if (typeof value.command === "string")
+        lines.push(row("Command", value.command, ctx));
+    if (typeof value.code === "string")
+        lines.push(row("Code", value.code, ctx));
+    const details = record(value.details);
+    if (typeof details?.status === "number")
+        lines.push(row("HTTP", details.status, ctx));
+    if (Array.isArray(value.details))
+        for (const issue of value.details.slice(0, 3)) {
+            const detail = record(issue);
+            if (!detail)
+                continue;
+            const path = Array.isArray(detail.path) ? detail.path.join(".") : "Input";
+            lines.push(row(clean(path || "Input"), detail.message, ctx));
+        }
+    if (value.outcome_unknown === true)
+        lines.push(`  ${ctx.color.yellow("!")} Outcome uncertain. Read the resource before retrying.`);
+    const recovery = record(value.recovery);
+    const recoveryTarget = record(recovery?.target);
+    if (typeof value.mutation_state === "string")
+        lines.push(row("Request", {
+            not_attempted: "Change was not attempted",
+            rejected: "Server rejected the change",
+            unknown: "May have reached the server",
+            acknowledged: "Server acknowledged; final result needs verification",
+        }[value.mutation_state] ?? value.mutation_state, ctx));
+    if (recoveryTarget) {
+        if (recoveryTarget.profile)
+            lines.push(row("Profile", recoveryTarget.profile, ctx));
+        if (recoveryTarget.app_id)
+            lines.push(row("App", recoveryTarget.app_id, ctx));
+        if (recoveryTarget.actor_user_id)
+            lines.push(row("Actor", recoveryTarget.actor_user_id, ctx));
+    }
+    if (typeof recovery?.note === "string")
+        lines.push(...paragraph(recovery.note, ctx));
+    if (recovery)
+        lines.push("  A missing result is inconclusive. Do not repeat the change automatically.");
+    const next = Array.isArray(value.next)
+        ? value.next.map(record).filter((item) => item !== undefined)
+        : [];
+    const describes = (item) => Array.isArray(item.argv) && item.argv.includes("describe");
+    next.sort((a, b) => Number(describes(a)) - Number(describes(b)));
+    const commands = next
+        .slice(0, 2)
+        .map((item) => item.argv)
+        .filter((argv) => Array.isArray(argv) && argv.every((part) => typeof part === "string"));
+    if (commands.length) {
+        lines.push(`  ${ctx.color.dim(commands.length === 1 ? "Next" : "Next steps")}`);
+        for (const argv of commands)
+            lines.push(`    ${commandLine(argv)}`);
+    }
+    return lines.join("\n");
+}
+/** Keep observations and runtime conclusions separate in the terminal view. */
+function diagnosticLines(result, ctx) {
+    const lines = [
+        ctx.color.bold("Sendbird diagnostics"),
+        row("Profile", result.profile, ctx),
+        row("Environment", result.environment, ctx),
+        row("Organization UID", result.org_id ?? "Not selected", ctx),
+        row("App", result.app_id ?? "Not selected", ctx),
+        row("Role", record(result.role)?.name ?? "Unknown", ctx),
+    ];
+    const sub = record(result.subscription);
+    lines.push(row("Chat plan", sub?.display_name ?? sub?.name ?? "Unknown", ctx));
+    if (sub?.name)
+        lines.push(row("Subscription", sub.name, ctx));
+    const assessment = record(result.assessment);
+    if (assessment) {
+        lines.push(row("Command", assessment.command, ctx), row("Preflight", assessment.status === "allowed"
+            ? "Read verified"
+            : assessment.status === "denied"
+                ? "Prerequisite denied"
+                : "Needs verification", ctx));
+        if (assessment.resource_id)
+            lines.push(row("Resource", assessment.resource_id, ctx));
+    }
+    const checks = result.checks
+        .map(record)
+        .filter((r) => Boolean(r));
+    lines.push("", ...table(checks, [
+        { label: "Check", value: (r) => r.id, max: 24 },
+        { label: "Status", value: (r) => r.status, min: 10, max: 10 },
+        { label: "Reason", value: (r) => r.reason, max: 64, min: 24 },
+    ], ctx));
+    if (Array.isArray(result.features) && result.features.length) {
+        const value = (x) => x === true ? "Yes" : x === false ? "No" : "?";
+        lines.push("", ctx.color.bold("Feature evidence (runtime not tested)"), ...table(result.features.map(record).filter((r) => Boolean(r)), [
+            { label: "Feature", value: (r) => r.feature, max: 22 },
+            { label: "Plan", value: (r) => value(r.entitlement), max: 8 },
+            {
+                label: "Enabled API",
+                value: (r) => value(r.reported_enabled),
+                min: 13,
+                max: 13,
+            },
+            {
+                label: "Detail API",
+                value: (r) => value(r.detail_snapshot),
+                max: 12,
+            },
+        ], ctx), ...paragraph("Plan = entitlement. API columns = reported settings. No does not establish runtime denial; Insight/runtime may need separate verification.", ctx));
+    }
+    if (Array.isArray(result.limits) && result.limits.length) {
+        lines.push("", ctx.color.bold("Configured limits (source units)"), ...table(result.limits.map(record).filter((r) => Boolean(r)), [
+            { label: "Metric", value: (r) => r.metric, max: 28 },
+            { label: "Included", value: (r) => r.included_units ?? "?", max: 16 },
+            {
+                label: "Hard limit",
+                value: (r) => r.configured_hard_limit ?? "?",
+                max: 18,
+            },
+        ], ctx), ...paragraph("These are plan configuration values, not remaining usage, a price quote, or a guarantee of unlimited API requests.", ctx));
+    }
+    const capacity = record(result.app_capacity);
+    if (capacity)
+        lines.push(row("Apps", `${capacity.count ?? "?"} / ${capacity.maximum ?? "?"}`, ctx));
+    if (Array.isArray(result.regions) && result.regions.length)
+        lines.push("", ctx.color.bold("Organization regions"), ...table(result.regions.map(record).filter((r) => Boolean(r)), [
+            { label: "Region", value: (r) => r.id, max: 22 },
+            { label: "Family", value: (r) => r.family, max: 12 },
+            { label: "Create", value: (r) => r.available ?? "?", max: 10 },
+            { label: "Calls", value: (r) => r.calls ?? "?", max: 10 },
+        ], ctx));
+    lines.push("", ...paragraph("Read-only diagnosis: no feature activation, SDK connection or mutation probe. Use --json for full evidence and unresolved conditions.", ctx));
+    return lines;
+}
+//# sourceMappingURL=human-output.js.map