@gravity-rail/cli 0.36.1 → 0.40.0

package/dist/lib.d.ts

@@ -139,6 +139,15 @@ declare const COL: {
     description: () => TableColumn<any>;
     enabled: () => TableColumn<any>;
 };
+/**
+ * Print a follow-on suggestion under the result, table output only.
+ *
+ * Suppressed for json/jsonl so machine consumers get parseable output — a hint
+ * written to stdout would corrupt it.
+ */
+declare function hint(opts: {
+    outputFormat?: string;
+}, lines: string[]): void;
 /** Write a status/progress message to stderr (never pollutes stdout) */
 declare function stderr(msg: string): void;
 /**
@@ -279,6 +288,8 @@ interface CommandDef<T = unknown> {
     requiresAuth?: boolean;
     /** Whether this command mutates data. Requires --allow-write to execute. */
     mutates?: boolean;
+    /** Set false for commands that read a dedicated binary/CSV file argument. */
+    acceptsJsonInput?: boolean;
     columns?: TableColumn<T>[];
     handler: (hctx: CommandHandlerContext) => Promise<void>;
 }
@@ -445,6 +456,19 @@ interface CrudConfig<T = unknown> {
      *               an options object would be misinterpreted.
      *
      * Default: `false` (safe — never forwards pagination options unless opted in).
+     *
+     * If the backend is a `PaginatedResponse` **and** the SDK method takes an
+     * options object `{page?, pageSize?}`, you MUST set `'full'`. Without it,
+     * `gr <entity> list` (and any script that shells out to it) silently returns
+     * page 1. The truncation notice is stderr-only; `_run_gr` discards stderr on
+     * success, so a scripted "complete" inventory cannot tell (#26162 / PR #26655
+     * — `gr workflows list` had no `--all` at all). `'full'` plus `--all` is the
+     * pair that makes a read page-complete.
+     *
+     * `'full'` cannot wrap a positional signature such as
+     * `getWorkspaceMembers(wid, page, pageSize, search, …)`: the handler would
+     * pass `{page, pageSize}` as the `page` argument. Convert that method to an
+     * options object (see `getAgents` / `getWorkflows`) before opting in.
      */
     paginationSupport?: 'full' | 'client-only' | false;
     /**
@@ -689,4 +713,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, type GlobalOptionsResult, type GlobalOptionsSpec, LIST_PAGINATION_ARGS, type OutputFormat, type OutputOptions, PAGINATION_ARGS, type PaginationMeta, type ParsedArgs, type ParsedGlobalOptions, type PublicGlobalOptions, type TableColumn, WORKSPACE_EXPORT_ZIP, type WorkspaceExportZipInput, authBrowserCommand, authImportDevCommand, authListCommand, authSwitchCommand, chatCommand, commandNeedsJsonBody, conciergeCommand, conciergeOutboundCommand, confirmAccountPhoneVerify, createAuthenticatedContext, createConciergeChat, createContext, createPublicAuthenticatedContext, createPublicContext, crudCommands, detectOutputFormat, devImportLocalCommand, extractPaginationMeta, fetchAllCursorPages, fetchAllPages, flushStdout, formatPaginationWarning, getConciergeChat, getConciergeChatMessages, getStartedCommand, handleError, importDevProfiles, isCursorPaginatedResponse, isDirectoryTrusted, isLikelySeedPhoneNumber, isListResult, isPagePaginatedResponse, isPaginatedResponse, isWorkspaceExportZip, listConciergeChats, listResult, loginCommand, logoutCommand, manageCommand, organizationsListCommand, originateConciergeCall, originateConciergeSms, outputData, outputSingle, parseArgs, parseGlobalOptions, parsePaginationArgs, profilesFromDevRealms, readJsonInput, registerPublicDomains, requireAuth, requireDirectoryTrust, requireNumber, requireString, resolveVoicePhoneNumberId, simpleCrudCommands, startAccountPhoneVerify, stderr, topLevelCommands, unwrapItems, waitForOutboundPhoneCallOutcome, whoamiCommand };
+export { type ArgDef, AuthRequiredError, type AuthenticatedContext, CLIError, COL, type CommandContext, type CommandDef, type CommandHandlerContext, CommandRegistry, type ConciergeChat, type ConciergeMessage, type DomainDef, type GlobalOptions, type GlobalOptionsResult, type GlobalOptionsSpec, LIST_PAGINATION_ARGS, type OutputFormat, type OutputOptions, PAGINATION_ARGS, type PaginationMeta, type ParsedArgs, type ParsedGlobalOptions, type PublicGlobalOptions, type TableColumn, WORKSPACE_EXPORT_ZIP, type WorkspaceExportZipInput, authBrowserCommand, authImportDevCommand, authListCommand, authSwitchCommand, chatCommand, commandNeedsJsonBody, conciergeCommand, conciergeOutboundCommand, confirmAccountPhoneVerify, createAuthenticatedContext, createConciergeChat, createContext, createPublicAuthenticatedContext, createPublicContext, crudCommands, detectOutputFormat, devImportLocalCommand, extractPaginationMeta, fetchAllCursorPages, fetchAllPages, flushStdout, formatPaginationWarning, getConciergeChat, getConciergeChatMessages, getStartedCommand, handleError, hint, importDevProfiles, isCursorPaginatedResponse, isDirectoryTrusted, isLikelySeedPhoneNumber, isListResult, isPagePaginatedResponse, isPaginatedResponse, isWorkspaceExportZip, listConciergeChats, listResult, loginCommand, logoutCommand, manageCommand, organizationsListCommand, originateConciergeCall, originateConciergeSms, outputData, outputSingle, parseArgs, parseGlobalOptions, parsePaginationArgs, profilesFromDevRealms, readJsonInput, registerPublicDomains, requireAuth, requireDirectoryTrust, requireNumber, requireString, resolveVoicePhoneNumberId, simpleCrudCommands, startAccountPhoneVerify, stderr, topLevelCommands, unwrapItems, waitForOutboundPhoneCallOutcome, whoamiCommand };