@capgo/cli 8.0.0-alpha.4 → 8.0.0

package/dist/src/api/crypto.d.ts

@@ -0,0 +1,26 @@
+import { Buffer } from 'node:buffer';
+export declare function generateSessionKey(key: string): {
+    sessionKey: Buffer;
+    ivSessionKey: string;
+};
+export declare function encryptSource(source: Buffer, sessionKey: Buffer, ivSessionKey: string): Buffer;
+export declare function decryptSource(source: Buffer, ivSessionKey: string, key: string): Buffer;
+export declare function encryptChecksum(checksum: string, key: string): string;
+export declare function encryptChecksumV3(checksum: string, key: string): string;
+export declare function decryptChecksum(checksum: string, key: string): string;
+export declare function decryptChecksumV3(checksum: string, key: string): string;
+interface RSAKeys {
+    publicKey: string;
+    privateKey: string;
+}
+export declare function createRSA(): RSAKeys;
+/**
+ * Calculate the key ID from a public key
+ * Shows the first 20 characters of base64-encoded key body for easy visual verification
+ * Note: First 12 characters (MIIBCgKCAQEA) are always the same for 2048-bit RSA PKCS#1 keys,
+ * but we show all of them so users can easily match with their key file
+ * @param publicKey - RSA public key in PEM format
+ * @returns 20-character key ID or empty string if key is invalid
+ */
+export declare function calcKeyId(publicKey: string): string;
+export {};

package/dist/src/api/update.d.ts

@@ -1,2 +1,8 @@
+export interface VersionCheckResult {
+    currentVersion: string;
+    latestVersion: string;
+    isOutdated: boolean;
+    majorVersion: string;
+}
+export declare function checkVersionStatus(): Promise<VersionCheckResult>;
 export declare function checkAlerts(): Promise<void>;
-//# sourceMappingURL=update.d.ts.map

package/dist/src/api/versions.d.ts

@@ -14,13 +14,17 @@ export declare function displayBundles(data: (Database['public']['Tables']['app_
 export declare function getActiveAppVersions(supabase: SupabaseClient<Database>, appid: string, options?: VersionOptions): Promise<{
     app_id: string;
     checksum: string | null;
+    cli_version: string | null;
     comment: string | null;
     created_at: string | null;
     deleted: boolean;
+    deleted_at: string | null;
     external_url: string | null;
     id: number;
+    key_id: string | null;
     link: string | null;
     manifest: Database["public"]["CompositeTypes"]["manifest_entry"][] | null;
+    manifest_count: number;
     min_update_version: string | null;
     name: string;
     native_packages: import("../types/supabase.types").Json[] | null;
@@ -31,17 +35,21 @@ export declare function getActiveAppVersions(supabase: SupabaseClient<Database>,
     updated_at: string | null;
     user_id: string | null;
 }[]>;
-export declare function getChannelsVersion(supabase: SupabaseClient<Database>, appid: string, options?: VersionOptions): Promise<number[]>;
+export declare function getChannelsVersion(supabase: SupabaseClient<Database>, appid: string, options?: VersionOptions): Promise<(number | null)[]>;
 export declare function getVersionData(supabase: SupabaseClient<Database>, appid: string, bundle: string, options?: VersionOptions): Promise<{
     app_id: string;
     checksum: string | null;
+    cli_version: string | null;
     comment: string | null;
     created_at: string | null;
     deleted: boolean;
+    deleted_at: string | null;
     external_url: string | null;
     id: number;
+    key_id: string | null;
     link: string | null;
     manifest: Database["public"]["CompositeTypes"]["manifest_entry"][] | null;
+    manifest_count: number;
     min_update_version: string | null;
     name: string;
     native_packages: import("../types/supabase.types").Json[] | null;
@@ -53,4 +61,3 @@ export declare function getVersionData(supabase: SupabaseClient<Database>, appid
     user_id: string | null;
 }>;
 export {};
-//# sourceMappingURL=versions.d.ts.map

package/dist/src/app/add.d.ts

@@ -1,12 +1,14 @@
-import type { Options } from '../api/app';
+import type { AppOptions } from '../schemas/app';
 import type { Organization } from '../utils';
 export declare const reverseDomainRegex: RegExp;
-export declare function addAppInternal(initialAppId: string, options: Options, organization?: Organization, silent?: boolean): Promise<{
+export type AppCreateSource = 'cli-direct' | 'onboarding' | 'mcp';
+export declare function resolveAppCreateSource(explicit?: AppCreateSource): AppCreateSource;
+export declare function addAppInternal(initialAppId: string, options: AppOptions, organization?: Organization, silent?: boolean, source?: AppCreateSource): Promise<{
     appId: any;
     organizationUid: string;
     userId: string;
     name: string;
+    iconUrl: string;
     signedURL: string;
 }>;
-export declare function addApp(appId: string, options: Options): Promise<void>;
-//# sourceMappingURL=add.d.ts.map
+export declare function addApp(appId: string, options: AppOptions): Promise<void>;

package/dist/src/app/debug.d.ts

@@ -1,8 +1,6 @@
+import type { AppDebugOptions } from '../schemas/app';
 import type { Database } from '../types/supabase.types';
-import type { OptionsBase } from '../utils';
-export interface OptionsBaseDebug extends OptionsBase {
-    device?: string;
-}
+export type { AppDebugOptions as OptionsBaseDebug } from '../schemas/app';
 export declare function markSnag(channel: string, orgId: string, apikey: string, event: string, appId?: string, icon?: string): Promise<void>;
 export declare function cancelCommand(channel: string, command: boolean | symbol, orgId: string, apikey: string): Promise<void>;
 interface Order {
@@ -28,6 +26,4 @@ interface LogData {
 }
 export declare function getStats(apikey: string, query: QueryStats, after: string | null): Promise<LogData[]>;
 export declare function waitLog(channel: string, apikey: string, appId: string, orgId: string, deviceId?: string): Promise<void>;
-export declare function debugApp(appId: string, options: OptionsBaseDebug): Promise<void>;
-export {};
-//# sourceMappingURL=debug.d.ts.map
+export declare function debugApp(appId: string, options: AppDebugOptions): Promise<void>;

package/dist/src/app/delete.d.ts

@@ -1,4 +1,3 @@
-import type { OptionsBase } from '../utils';
+import type { OptionsBase } from '../schemas/base';
 export declare function deleteAppInternal(initialAppId: string, options: OptionsBase, silent?: boolean, skipConfirmation?: boolean): Promise<boolean>;
 export declare function deleteApp(initialAppId: string, options: OptionsBase): Promise<boolean>;
-//# sourceMappingURL=delete.d.ts.map

package/dist/src/app/info.d.ts

@@ -1,6 +1,11 @@
 interface DoctorInfoOptions {
     packageJson?: string;
 }
+export declare function computeDoctorAnalyticsTags(installed: Record<string, string>, latest: Record<string, string>): {
+    is_outdated: boolean;
+    dependency_count: number;
+    outdated_count: number;
+};
 export declare function getInfoInternal(options: DoctorInfoOptions, silent?: boolean): Promise<{
     appName: string;
     appId: any;
@@ -18,4 +23,3 @@ export declare function getInfo(options: DoctorInfoOptions): Promise<{
     latestDependencies: Record<string, string>;
 }>;
 export {};
-//# sourceMappingURL=info.d.ts.map

package/dist/src/app/list.d.ts

@@ -1,34 +1,55 @@
-import type { OptionsBase } from '../utils';
+import type { OptionsBase } from '../schemas/base';
 export declare function listAppInternal(options: OptionsBase, silent?: boolean): Promise<{
+    allow_device_custom_id: boolean;
+    allow_preview: boolean;
+    android_store_url: string | null;
     app_id: string;
+    build_timeout_seconds: number;
+    build_timeout_updated_at: string;
     channel_device_count: number;
     created_at: string | null;
     default_upload_channel: string;
+    existing_app: boolean;
+    expose_metadata: boolean;
     icon_url: string;
     id: string | null;
+    ios_store_url: string | null;
     last_version: string | null;
     manifest_bundle_count: number;
     name: string | null;
+    need_onboarding: boolean;
     owner_org: string;
     retention: number;
+    stats_refresh_requested_at: string | null;
+    stats_updated_at: string | null;
     transfer_history: import("../types/supabase.types").Json[] | null;
     updated_at: string | null;
     user_id: string | null;
 }[]>;
 export declare function listApp(options: OptionsBase): Promise<{
+    allow_device_custom_id: boolean;
+    allow_preview: boolean;
+    android_store_url: string | null;
     app_id: string;
+    build_timeout_seconds: number;
+    build_timeout_updated_at: string;
     channel_device_count: number;
     created_at: string | null;
     default_upload_channel: string;
+    existing_app: boolean;
+    expose_metadata: boolean;
     icon_url: string;
     id: string | null;
+    ios_store_url: string | null;
     last_version: string | null;
     manifest_bundle_count: number;
     name: string | null;
+    need_onboarding: boolean;
     owner_org: string;
     retention: number;
+    stats_refresh_requested_at: string | null;
+    stats_updated_at: string | null;
     transfer_history: import("../types/supabase.types").Json[] | null;
     updated_at: string | null;
     user_id: string | null;
 }[]>;
-//# sourceMappingURL=list.d.ts.map

package/dist/src/app/set.d.ts

@@ -1,4 +1,3 @@
 import type { Options } from '../api/app';
 export declare function setAppInternal(appId: string, options: Options, silent?: boolean): Promise<boolean>;
 export declare function setApp(appId: string, options: Options): Promise<boolean>;
-//# sourceMappingURL=set.d.ts.map

package/dist/src/app/setting.d.ts

@@ -1,9 +1,3 @@
-import type { OptionsBase } from '../utils';
-interface Options extends OptionsBase {
-    bool?: string;
-    string?: string;
-}
-export declare function setSettingInternal(setting: string, options: Options, silent?: boolean): Promise<void>;
-export declare function setSetting(setting: string, options: Options): Promise<void>;
-export {};
-//# sourceMappingURL=setting.d.ts.map
+import type { AppSettingOptions } from '../schemas/app';
+export declare function setSettingInternal(setting: string, options: AppSettingOptions, silent?: boolean): Promise<void>;
+export declare function setSetting(setting: string, options: AppSettingOptions): Promise<void>;

package/dist/src/app/updateProbe.d.ts

@@ -0,0 +1,43 @@
+export declare const updateProbeDeviceId = "00000000-0000-0000-0000-000000000000";
+interface UpdateProbePayload {
+    app_id: string;
+    device_id: string;
+    version_name: string;
+    version_build: string;
+    is_emulator: boolean;
+    is_prod: boolean;
+    platform: 'ios' | 'android';
+    plugin_version: string;
+    defaultChannel: string;
+}
+export interface PreparedUpdateProbe {
+    endpoint: string;
+    payload: UpdateProbePayload;
+    nativeSource: string;
+    versionBuildSource: string;
+    appIdSource: string;
+}
+export type PrepareUpdateProbeResult = {
+    ok: true;
+    context: PreparedUpdateProbe;
+} | {
+    ok: false;
+    error: string;
+};
+export type UpdateProbeResult = {
+    success: true;
+    availableVersion: string;
+} | {
+    success: false;
+    reason: string;
+    backendRefusal: boolean;
+    errorCode?: string;
+    backendMessage?: string;
+    extra?: Record<string, unknown>;
+};
+export declare function prepareUpdateProbe(platform: 'ios' | 'android', capConfig: any): Promise<PrepareUpdateProbeResult>;
+export declare function singleProbeRequest(endpoint: string, payload: UpdateProbePayload): Promise<UpdateProbeResult>;
+export declare function explainCommonUpdateError(result: Extract<UpdateProbeResult, {
+    success: false;
+}>): string[];
+export {};

package/dist/src/build/credentials-command.d.ts

@@ -0,0 +1,89 @@
+interface SaveCredentialsOptions {
+    platform?: 'ios' | 'android';
+    appId?: string;
+    local?: boolean;
+    outputUpload?: boolean;
+    outputRetention?: string;
+    skipBuildNumberBump?: boolean;
+    certificate?: string;
+    iosProvisioningProfile?: string[];
+    overwriteIosProvisioningMap?: boolean;
+    p12Password?: string;
+    appleKey?: string;
+    appleKeyId?: string;
+    appleIssuerId?: string;
+    appleTeamId?: string;
+    iosDistribution?: 'app_store' | 'ad_hoc';
+    keystore?: string;
+    keystoreAlias?: string;
+    keystoreKeyPassword?: string;
+    keystoreStorePassword?: string;
+    playConfig?: string;
+    androidFlavor?: string;
+    inAppUpdatePriority?: number | string;
+}
+/**
+ * Provisioning map entry: stores the base64-encoded profile and its extracted name
+ */
+interface ProvisioningMapEntry {
+    profile: string;
+    name: string;
+}
+/**
+ * Build a provisioning map from --ios-provisioning-profile entries.
+ *
+ * Each entry is either:
+ *   - "bundleId=path" (explicit bundle ID assignment)
+ *   - "path" (auto-infer bundle ID by matching mobileprovision against pbxproj targets)
+ */
+export declare function buildProvisioningMap(entries: string[], projectDir?: string): Record<string, ProvisioningMapEntry>;
+/**
+ * Save build credentials locally
+ *
+ * SECURITY NOTE:
+ * - Credentials are saved to ~/.capgo-credentials/credentials.json on YOUR local machine only
+ * - When you run a build, credentials are sent to Capgo's build servers
+ * - Credentials are NEVER stored permanently on Capgo servers
+ * - They are automatically deleted after build completion
+ */
+export declare function saveCredentialsCommand(options: SaveCredentialsOptions): Promise<void>;
+/**
+ * List saved credentials (masked for security)
+ */
+export declare function listCredentialsCommand(options?: {
+    appId?: string;
+    local?: boolean;
+}): Promise<void>;
+/**
+ * Clear saved credentials
+ */
+export declare function clearCredentialsCommand(options: {
+    appId?: string;
+    platform?: 'ios' | 'android';
+    local?: boolean;
+}): Promise<void>;
+/**
+ * Update existing credentials (partial update, no full validation)
+ * Use this to update specific credentials without providing all of them again
+ */
+export declare function updateCredentialsCommand(options: SaveCredentialsOptions): Promise<void>;
+/**
+ * Build a migration map from a single legacy base64 provisioning profile.
+ *
+ * Takes the legacy BUILD_PROVISION_PROFILE_BASE64 value and a bundle ID,
+ * extracts the profile name, and returns a JSON-serialized provisioning map.
+ */
+export declare function buildMigrationMap(profileBase64: string, bundleId: string): string;
+/**
+ * Migrate legacy provisioning profile credentials to the new map format.
+ *
+ * Reads saved credentials, finds the legacy BUILD_PROVISION_PROFILE_BASE64,
+ * discovers the main bundle ID from the local pbxproj, synthesizes the map,
+ * saves it, and removes old keys.
+ */
+export declare function migrateCredentialsCommand(options: {
+    appId?: string;
+    platform?: string;
+    local?: boolean;
+}): Promise<void>;
+export {};

package/dist/src/build/credentials-manage.d.ts

@@ -0,0 +1,7 @@
+interface ManageCredentialsOptions {
+    appId?: string;
+    platform?: 'ios' | 'android';
+    local?: boolean;
+}
+export declare function manageCredentialsCommand(options?: ManageCredentialsOptions): Promise<void>;
+export {};

package/dist/src/build/credentials.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Build Credentials Management
+ *
+ * This module provides utilities for managing build credentials locally on your machine.
+ *
+ * IMPORTANT SECURITY NOTICE:
+ * - Credentials are stored LOCALLY in ~/.capgo-credentials/credentials.json on YOUR machine only
+ * - When you request a build, credentials are sent to Capgo's build servers
+ * - Credentials are NEVER stored permanently on Capgo servers
+ * - Credentials are used only during the build process and are automatically deleted
+ *   from Capgo servers after the build completes (maximum 24 hours)
+ * - Builds are sent DIRECTLY to app stores (Apple App Store / Google Play Store)
+ * - Build outputs may optionally be uploaded for time-limited download links
+ *
+ * Security best practices:
+ * - Ensure ~/.capgo-credentials/ directory has restricted file permissions
+ * - Never commit credentials.json to version control
+ * - Use separate credentials for CI/CD vs local development
+ * - Rotate credentials regularly
+ */
+import type { CredentialFile, SavedCredentials } from '../schemas/build';
+import type { BuildCredentials } from './request';
+export declare const MIN_OUTPUT_RETENTION_SECONDS: number;
+export declare const MAX_OUTPUT_RETENTION_SECONDS: number;
+export type { AllCredentials, CredentialFile, SavedCredentials } from '../schemas/build';
+export declare function parseOutputRetentionSeconds(raw: string): number;
+export declare function parseOptionalBoolean(value: boolean | string | undefined): boolean;
+export declare function parseInAppUpdatePriority(value: number | string): number;
+/**
+ * Load saved credentials for a specific app
+ * Checks local file first, then global file
+ */
+export declare function loadSavedCredentials(appId?: string, local?: boolean): Promise<SavedCredentials | null>;
+/**
+ * Load credentials from environment variables
+ * Only returns credentials that are actually set in env
+ */
+export declare function loadCredentialsFromEnv(): Partial<BuildCredentials>;
+/**
+ * Merge credentials from all three sources with proper precedence:
+ * 1. CLI arguments (highest priority)
+ * 2. Environment variables (middle priority)
+ * 3. Saved credentials file (lowest priority)
+ */
+export declare function mergeCredentials(appId: string, platform: 'ios' | 'android', cliArgs?: Partial<BuildCredentials>): Promise<BuildCredentials | undefined>;
+/**
+ * Convert file paths to base64 credentials
+ */
+export declare function convertFilesToCredentials(platform: 'ios' | 'android', files: CredentialFile, passwords?: Partial<BuildCredentials>): Promise<BuildCredentials>;
+/**
+ * Update saved credentials for a specific app and platform
+ */
+export declare function updateSavedCredentials(appId: string, platform: 'ios' | 'android', credentials: Partial<BuildCredentials>, local?: boolean): Promise<void>;
+/**
+ * Remove specific credential keys for an app/platform.
+ * Used during migration to clean up legacy keys.
+ */
+export declare function removeSavedCredentialKeys(appId: string, platform: 'ios' | 'android', keys: string[], local?: boolean): Promise<void>;
+/**
+ * Clear saved credentials for a specific app and/or platform
+ */
+export declare function clearSavedCredentials(appId?: string, platform?: 'ios' | 'android', local?: boolean): Promise<void>;
+/**
+ * Get saved credentials for a specific app and platform
+ */
+export declare function getSavedCredentials(appId: string, platform: 'ios' | 'android', local?: boolean): Promise<Partial<BuildCredentials> | null>;
+/**
+ * List all apps that have saved credentials
+ */
+export declare function listAllApps(local?: boolean): Promise<string[]>;
+/**
+ * Get the local credentials file path (for display purposes)
+ */
+export declare function getLocalCredentialsPath(): string;
+/**
+ * Get the global credentials file path (for display purposes)
+ */
+export declare function getGlobalCredentialsPath(): string;

package/dist/src/build/env-render.d.ts

@@ -0,0 +1,8 @@
+import type { BuildCredentials } from '../schemas/build';
+export declare function renderEnvFile(args: {
+    appId: string;
+    local: boolean;
+    platform: 'ios' | 'android';
+    creds: Partial<BuildCredentials>;
+}): string;
+export declare function escapeDotenvValue(value: string): string;

package/dist/src/build/last-output-command.d.ts

@@ -0,0 +1,6 @@
+export interface LastOutputOptions {
+    path: string;
+    field?: string;
+    qr?: boolean;
+}
+export declare function lastOutputCommand(options: LastOutputOptions): Promise<void>;

package/dist/src/build/mobileprovision-parser.d.ts

@@ -0,0 +1,35 @@
+export interface MobileprovisionInfo {
+    name: string;
+    uuid: string;
+    applicationIdentifier: string;
+    bundleId: string;
+}
+/**
+ * Detail returned by {@link parseMobileprovisionDetailed} — extends
+ * {@link MobileprovisionInfo} with team/expiry/profile-type metadata and the
+ * SHA1 of each developer certificate embedded in the profile.
+ *
+ * The SHA1 list enables matching a profile against a Keychain identity
+ * returned by `security find-identity` (which reports identities by the same
+ * SHA1 hash).
+ */
+export interface MobileprovisionDetail extends MobileprovisionInfo {
+    /** Apple Team ID (10-char alphanumeric) — empty string if not present */
+    teamId: string;
+    /** ISO timestamp string from the profile's ExpirationDate, or empty string */
+    expirationDate: string;
+    /** High-level profile type derived from the profile's flags */
+    profileType: 'app_store' | 'ad_hoc' | 'development' | 'enterprise' | 'unknown';
+    /** SHA1 (40-char lowercase hex) of each DeveloperCertificate embedded in the profile */
+    certificateSha1s: string[];
+}
+export declare function parseMobileprovision(filePath: string): MobileprovisionInfo;
+export declare function parseMobileprovisionFromBase64(base64Content: string): MobileprovisionInfo;
+/**
+ * Parse a mobileprovision file and return enriched metadata including:
+ *   - team ID
+ *   - expiration date
+ *   - profile type (app_store / ad_hoc / development / enterprise)
+ *   - SHA1 of each embedded developer certificate (used for cert↔profile matching)
+ */
+export declare function parseMobileprovisionDetailed(filePath: string): MobileprovisionDetail;

package/dist/src/build/needed.d.ts

@@ -0,0 +1,28 @@
+import type { BuildNeededOptions } from '../schemas/build';
+import type { Compatibility } from '../schemas/common';
+type VersionChangeType = 'major' | 'minor' | 'patch' | 'prerelease' | 'changed' | 'same' | 'new' | 'removed';
+interface PublicChannelRow {
+    name: string | null;
+}
+export interface BuildNeededResult {
+    required: boolean;
+    resolvedAppId: string;
+    channel: string;
+    finalCompatibility: Compatibility[];
+}
+export declare const BUILD_NEEDED_ERROR_EXIT_CODE = 2;
+interface FormatOptions {
+    color?: boolean;
+}
+export declare function getConfiguredDefaultChannel(config: unknown): string | undefined;
+export declare function selectDefaultChannelName(rows: PublicChannelRow[]): string;
+export declare function getVersionChangeType(entry: Compatibility): VersionChangeType;
+export declare function getNativeDiffLabel(entry: Compatibility): string;
+export declare function isBuildNeeded(finalCompatibility: Compatibility[]): boolean;
+export declare function getBuildNeededExitCode(required: boolean): number;
+export declare function formatShortBuildNeeded(required: boolean): string;
+export declare function formatBuildNeededTable(finalCompatibility: Compatibility[], options?: FormatOptions): string;
+export declare function formatVerboseBuildNeeded(result: BuildNeededResult, options?: FormatOptions): string;
+export declare function getBuildNeeded(appId: string | undefined, options: BuildNeededOptions): Promise<BuildNeededResult>;
+export declare function checkBuildNeeded(appId: string | undefined, options: BuildNeededOptions): Promise<void>;
+export {};

package/dist/src/build/onboarding/ai-fit.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Fit estimation for the AI analysis result step in the onboarding TUI.
+ *
+ * The on-failure AI flow can return a multi-screen markdown diagnosis. If
+ * that text doesn't fit in the user's current terminal viewport we MUST
+ * route it through the scrollable `FullscreenAiViewer` — otherwise the
+ * earlier lines scroll out of view and the onboarding wizard ends up in
+ * an unreadable state.
+ *
+ * The estimator deliberately errs on the side of "doesn't fit": a
+ * false-positive scroll is fine (just one more keystroke for the user),
+ * but a false-negative inline render is bad UX (text disappears off the
+ * top of the screen).
+ */
+export declare const AI_RESULT_CHROME_ROWS = 10;
+export declare const AI_RUNNING_CHROME_ROWS = 10;
+export interface AiPreviewTail {
+    /** Lines to render (blank-padded to a constant rendered height). */
+    rows: string[];
+    /** Logical lines scrolled off the top (0 ⇒ the marker row renders blank). */
+    hidden: number;
+}
+/**
+ * Pick the visible tail of the live streaming analysis preview for the
+ * CURRENT terminal size.
+ *
+ * Wrap-aware: each logical line is budgeted as the rows it will actually
+ * occupy at `terminalCols` (via `estimateRenderedRows`), so the running frame
+ * can never grow past the viewport. No artificial padding: streamed text only
+ * appends, so the rendered height grows monotonically on its own — the frame
+ * starts compact (matching the other wizard steps) and grows downward, and is
+ * capped at the budget so it never overflows the full-height shell frame.
+ */
+export declare function pickAiPreviewTail(text: string, terminalRows: number, terminalCols: number): AiPreviewTail;
+/** Strip ANSI SGR escape codes so length matches what the user actually sees. */
+export declare function stripAnsi(text: string): string;
+/**
+ * Estimate how many terminal rows a multi-line, possibly ANSI-styled string
+ * will occupy when rendered by Ink at the given column width.
+ *
+ * Each logical line (split on '\n') becomes `ceil(visibleLen / cols)` rows,
+ * with a floor of 1 to account for empty lines that still consume a row.
+ */
+export declare function estimateRenderedRows(text: string, terminalCols: number): number;
+/**
+ * Decide whether the AI analysis text should be routed through the
+ * scrollable fullscreen viewer. Conservative — prefers true (scroll) when
+ * the estimate is close to the available row budget.
+ *
+ * @param text         The AI analysis markdown (already rendered to ANSI).
+ * @param terminalRows Total terminal rows from `useStdout().stdout?.rows`.
+ * @param terminalCols Total terminal cols from `useStdout().stdout?.columns`.
+ * @param chromeRows   Reserved rows for the surrounding wizard chrome.
+ *                     Defaults to `AI_RESULT_CHROME_ROWS`.
+ */
+export declare function isAiAnalysisTooTall(text: string, terminalRows: number, terminalCols: number, chromeRows?: number): boolean;
+export type AiResultStep = 'ai-analysis-result' | 'ai-analysis-result-scroll';
+/**
+ * Decide which AI-result step should be active for the CURRENT terminal size.
+ *
+ * Routing is BIDIRECTIONAL and driven by the single `isAiAnalysisTooTall`
+ * predicate, so it settles deterministically at any size — at a given size
+ * exactly one outcome is stable, so it can't oscillate:
+ *   - inline + now too tall (terminal shrank)  → scroll
+ *   - scroll + now fits      (terminal grew)    → inline   ← the missing case
+ *
+ * Before, only the inline→scroll direction existed: once the viewer opened
+ * (e.g. after shrinking), growing the terminal never returned to the inline
+ * render — the user was stuck in the scroll viewer showing "all N lines" with
+ * empty space.
+ *
+ * `viewedFull` (the user manually dismissed the viewer with Esc/Enter) pins the
+ * inline step so a later resize can't shove a dismissed analysis back into the
+ * viewer. It only gates the inline→scroll direction; leaving the viewer when it
+ * fits is always allowed.
+ *
+ * @returns the step to switch to, or `null` when the current step is already
+ *   correct (so the caller can skip a no-op `setStep`).
+ */
+export declare function resolveAiResultRoute(params: {
+    current: AiResultStep;
+    text: string | null;
+    viewedFull: boolean;
+    terminalRows: number;
+    terminalCols: number;
+}): AiResultStep | null;
+/**
+ * Pick the slice of `lines` starting at `scrollOffset` that PACKS the
+ * `viewportRows` rendered rows of a terminal `terminalCols` wide.
+ *
+ * Packs lines until the cumulative wrapped row count reaches or exceeds
+ * `viewportRows`, INCLUDING the line that crosses the boundary. That last line
+ * may render past the viewport; the viewer clips it with `overflow: hidden` so
+ * the visible area is always FULL of text when more lines remain. (Stopping
+ * before the boundary line — the old behaviour — left the unused rows as an
+ * empty gap when a long line couldn't fully fit.)
+ *
+ * Always returns at least one line if the input is non-empty and the
+ * `scrollOffset` is in-range — even if that line wraps to more rows than the
+ * viewport.
+ */
+export declare function pickVisibleLines(lines: string[], scrollOffset: number, viewportRows: number, terminalCols: number): string[];
+/**
+ * Compute the largest `scrollOffset` that still keeps content visible at the
+ * bottom of the viewport — i.e. the offset where the LAST line is rendered
+ * within the viewport. Walks backwards from the end, packing as many tail
+ * lines as fit (accounting for wrap), and returns the offset of the first
+ * fully-visible tail line.
+ */
+export declare function computeMaxScrollOffset(lines: string[], viewportRows: number, terminalCols: number): number;