@gravity-rail/cli 0.6.0 → 0.7.1

package/dist/lib.d.ts

@@ -1,6 +1,7 @@
 import { ApiClient } from '@gravity-rail/client';
 import { E as EnvironmentConfig, C as CredentialsManager } from './cli-client-context-9KRUt6O-.js';
 export { a as ConciergeAppContextPayload, b as buildCliConciergeAppContext } from './cli-client-context-9KRUt6O-.js';
+import { GravityRailClient, PhoneCall } from '@gravity-rail/sdk';
 
 /** Metadata extracted from a paginated API response */
 interface PaginationMeta {
@@ -131,6 +132,8 @@ declare function stderr(msg: string): void;
 interface GlobalOptions {
     env: string;
     realm?: string;
+    /** Override API base URL (also: GRAVITY_RAIL_API_URL env var). */
+    apiUrl?: string;
     outputFormat?: string;
     verbose?: boolean;
     allowWrite?: boolean;
@@ -241,9 +244,33 @@ declare class AuthRequiredError extends CLIError {
 }
 declare function handleError(err: unknown): never;
 
+/**
+ * Whether the CLI should read --data / --file / stdin for this command.
+ *
+ * CRUD create/update handlers rely on COMMON_ARGS for --data, but those flags are
+ * not listed on cmd.args — without this helper, `gr members update --data …` silently
+ * skips the body.
+ */
+declare function commandNeedsJsonBody(cmd: CommandDef, parsedArgs: ParsedArgs): boolean;
 /** Read JSON input from --data string, --file path, or stdin (if piped) */
 declare function readJsonInput(args: ParsedArgs): Promise<unknown | undefined>;
 
+/** True when the number is a provisioned test placeholder, not a real handset. */
+declare function isLikelySeedPhoneNumber(phone: string): boolean;
+/**
+ * Poll until the outbound PhoneCall for a chat reaches a terminal or connected state.
+ * Throws CLIError when Twilio reports failure (often within 1–2s).
+ */
+declare function waitForOutboundPhoneCallOutcome(client: GravityRailClient, workspaceUuid: string, chatId: number, memberId: number, options?: {
+    timeoutMs?: number;
+    intervalMs?: number;
+}): Promise<PhoneCall>;
+/**
+ * Resolve the workspace PhoneNumber id to use for outbound voice.
+ * Order: explicit flag → workspace defaults → first voice-enabled line.
+ */
+declare function resolveVoicePhoneNumberId(client: GravityRailClient, workspaceUuid: string, explicitId?: number): Promise<number>;
+
 /**
  * @deprecated Use `SimpleCrudConfig` with `simpleCrudCommands()` for new code.
  *
@@ -270,6 +297,8 @@ interface CrudConfig<T = unknown> {
     extra?: CommandDef[];
     /** Example lines shown in help for the create command */
     createExamples?: string[];
+    /** Example lines shown in help for the update command */
+    updateExamples?: string[];
     /**
      * Controls how the CRUD list handler interacts with pagination.
      *
@@ -366,6 +395,10 @@ declare class CommandRegistry {
     /** Generate help text. If prefix given, show commands under that prefix. */
     getHelp(prefix?: string[]): string;
     private getCommandHelp;
+    /** All registered domains (for docs generation and introspection). */
+    getDomains(): readonly DomainDef[];
+    /** All registered commands (for docs generation and introspection). */
+    getAllCommands(): CommandDef[];
     private getTopLevelHelp;
 }
 
@@ -405,6 +438,18 @@ interface ConciergeMessage {
 declare function listConciergeChats(ctx: AuthenticatedContext): Promise<ConciergeChat[]>;
 declare function createConciergeChat(ctx: AuthenticatedContext, title?: string): Promise<ConciergeChat>;
 declare function getConciergeChat(ctx: AuthenticatedContext, chatId: number): Promise<ConciergeChat>;
+interface ConciergeCallResult {
+    callSid: string;
+    startedAt: string;
+}
+interface ConciergeSmsResult {
+    messageSid: string;
+    conversationId: string;
+}
+declare function originateConciergeCall(ctx: AuthenticatedContext, kind?: string): Promise<ConciergeCallResult>;
+declare function originateConciergeSms(ctx: AuthenticatedContext, kind?: string): Promise<ConciergeSmsResult>;
+declare function startAccountPhoneVerify(ctx: AuthenticatedContext, phone: string): Promise<void>;
+declare function confirmAccountPhoneVerify(ctx: AuthenticatedContext, code: string): Promise<void>;
 declare function getConciergeChatMessages(ctx: AuthenticatedContext, chatId: number): Promise<ConciergeMessage[]>;
 
 /**
@@ -424,6 +469,7 @@ declare function authBrowserCommand(ctx: AuthenticatedContext, args: Record<stri
  * but without requiring a workspace.
  */
 
+declare function conciergeOutboundCommand(hctx: CommandHandlerContext): Promise<void>;
 declare function conciergeCommand(hctx: CommandHandlerContext): Promise<void>;
 
 /**
@@ -458,4 +504,4 @@ declare function organizationsListCommand(ctx: AuthenticatedContext): Promise<vo
 
 declare function whoamiCommand(ctx: AuthenticatedContext): Promise<void>;
 
-export { type ArgDef, AuthRequiredError, type AuthenticatedContext, CLIError, COL, type CommandContext, type CommandDef, type CommandHandlerContext, CommandRegistry, type ConciergeChat, type ConciergeMessage, type DomainDef, type GlobalOptions, LIST_PAGINATION_ARGS, type OutputFormat, type OutputOptions, PAGINATION_ARGS, type PaginationMeta, type ParsedArgs, type PublicGlobalOptions, type TableColumn, authBrowserCommand, chatCommand, conciergeCommand, createAuthenticatedContext, createConciergeChat, createContext, createPublicAuthenticatedContext, createPublicContext, crudCommands, detectOutputFormat, devImportLocalCommand, extractPaginationMeta, fetchAllCursorPages, fetchAllPages, formatPaginationWarning, getConciergeChat, getConciergeChatMessages, getStartedCommand, handleError, isCursorPaginatedResponse, isDirectoryTrusted, isListResult, isPagePaginatedResponse, isPaginatedResponse, listConciergeChats, listResult, loginCommand, logoutCommand, manageCommand, organizationsListCommand, outputData, outputSingle, parseArgs, parsePaginationArgs, readJsonInput, registerPublicDomains, requireAuth, requireDirectoryTrust, requireNumber, requireString, simpleCrudCommands, stderr, unwrapItems, whoamiCommand };
+export { type ArgDef, AuthRequiredError, type AuthenticatedContext, CLIError, COL, type CommandContext, type CommandDef, type CommandHandlerContext, CommandRegistry, type ConciergeChat, type ConciergeMessage, type DomainDef, type GlobalOptions, LIST_PAGINATION_ARGS, type OutputFormat, type OutputOptions, PAGINATION_ARGS, type PaginationMeta, type ParsedArgs, type PublicGlobalOptions, type TableColumn, authBrowserCommand, chatCommand, commandNeedsJsonBody, conciergeCommand, conciergeOutboundCommand, confirmAccountPhoneVerify, createAuthenticatedContext, createConciergeChat, createContext, createPublicAuthenticatedContext, createPublicContext, crudCommands, detectOutputFormat, devImportLocalCommand, extractPaginationMeta, fetchAllCursorPages, fetchAllPages, formatPaginationWarning, getConciergeChat, getConciergeChatMessages, getStartedCommand, handleError, isCursorPaginatedResponse, isDirectoryTrusted, isLikelySeedPhoneNumber, isListResult, isPagePaginatedResponse, isPaginatedResponse, listConciergeChats, listResult, loginCommand, logoutCommand, manageCommand, organizationsListCommand, originateConciergeCall, originateConciergeSms, outputData, outputSingle, parseArgs, parsePaginationArgs, readJsonInput, registerPublicDomains, requireAuth, requireDirectoryTrust, requireNumber, requireString, resolveVoicePhoneNumberId, simpleCrudCommands, startAccountPhoneVerify, stderr, unwrapItems, waitForOutboundPhoneCallOutcome, whoamiCommand };