@sanity/runtime-cli 17.10.0 → 17.11.1-next.gc1820a0

package/dist/cores/blueprints/init.js

@@ -1,5 +1,5 @@
 import { existsSync, readFileSync } from 'node:fs';
-import { join } from 'node:path';
+import { basename, dirname, join, resolve } from 'node:path';
 import { cwd } from 'node:process';
 import { confirm } from '@inquirer/prompts';
 import { findBlueprintFile, readLocalBlueprint, writeBlueprintToDisk, } from '../../actions/blueprints/blueprint.js';
@@ -11,8 +11,9 @@ import { verifyExampleExists, writeExample } from '../../actions/sanity/examples
 import { getProject } from '../../actions/sanity/projects.js';
 import { BLUEPRINT_CONFIG_DIR, BLUEPRINT_CONFIG_FILE } from '../../config.js';
 import { check, filePathRelativeToCwd, labeledId, warn } from '../../utils/display/presenters.js';
-import { promptForBlueprintType, promptForOrganization, promptForProjectInOrg, promptForStack, runScopeAndStackWizard, } from '../../utils/display/prompt.js';
+import { CancelledError, promptForBlueprintType, promptForInitLocation, promptForOrganization, promptForProjectInOrg, promptForStack, runScopeAndStackWizard, } from '../../utils/display/prompt.js';
 import { isInteractive } from '../../utils/interactive.js';
+import { installCommand, runCommand } from '../../utils/package-manager.js';
 import { styleText } from '../../utils/style-text.js';
 import { blueprintConfigCore } from './config.js';
 /** Derive scope type and ID from mutually exclusive flag values. */
@@ -29,8 +30,8 @@ export async function blueprintInitCore(options) {
     const { dir: argDir } = args;
     const explicitDir = argDir || flagDir;
     const isHere = !explicitDir || explicitDir === '.' || explicitDir === './';
-    const blueprintDir = isHere ? '.' : explicitDir;
-    const userProvidedDirName = isHere ? undefined : explicitDir;
+    let blueprintDir = isHere ? '.' : explicitDir;
+    let userProvidedDirName = isHere ? undefined : explicitDir;
     const validationError = validateFlags({
         stackId: flagStackId,
         stackName: flagStackName,
@@ -43,7 +44,7 @@ export async function blueprintInitCore(options) {
         const existingBlueprintFile = findBlueprintFile(blueprintDir);
         // existing blueprint file on disk → configure it for deployment
         if (existingBlueprintFile) {
-            return handleExistingBlueprint({
+            const result = await handleExistingBlueprint({
                 existingBlueprintFile,
                 bin,
                 log,
@@ -56,6 +57,11 @@ export async function blueprintInitCore(options) {
                 flagStackName,
                 verbose,
             });
+            // the config core owns the wizard, but the user ran `init`
+            if (!result.success && result.cancelled) {
+                return { success: false, error: 'Initialization cancelled.', cancelled: true };
+            }
+            return result;
         }
         // --example flag → scaffold from an example template
         if (flagExample) {
@@ -70,13 +76,21 @@ export async function blueprintInitCore(options) {
         }
         // no blueprint on disk → create new blueprint files from scratch
         if (!explicitDir && isInteractive) {
-            const proceed = await confirm({
-                message: `Initialize a Blueprint here in ${cwd()}?`,
-                default: true,
-            });
-            if (!proceed) {
-                log(`Run \`${bin} blueprints init <directory>\` to initialize in a different location.`);
-                return { success: false, error: 'Initialization cancelled.' };
+            const chosenDir = await promptForInitLocation(cwd());
+            if (chosenDir) {
+                blueprintDir = chosenDir;
+                userProvidedDirName = chosenDir;
+                // findBlueprintFile walks up, so only refuse on a manifest in the folder itself
+                const existing = findBlueprintFile(chosenDir);
+                if (existing && dirname(resolve(existing.blueprintFilePath)) === resolve(chosenDir)) {
+                    return {
+                        success: false,
+                        error: `A Blueprint already exists in "${chosenDir}".`,
+                        suggestions: [
+                            `Run \`${runCommand(bin)} blueprints init ${chosenDir}\` to configure it for deployment.`,
+                        ],
+                    };
+                }
             }
         }
         return handleFreshInitialization({
@@ -94,6 +108,9 @@ export async function blueprintInitCore(options) {
         });
     }
     catch (error) {
+        if (error instanceof CancelledError) {
+            return { success: false, error: 'Initialization cancelled.', cancelled: true };
+        }
         const errorMessage = error instanceof Error ? error.message : String(error);
         return { success: false, error: errorMessage };
     }
@@ -156,6 +173,7 @@ async function handleFreshInitialization(options) {
         stackId: flagStackId,
         stackName: flagStackName,
         knownProjectId,
+        blueprintDir,
         log,
         token,
     });
@@ -241,7 +259,7 @@ async function handleExampleInitialization(options) {
     const { blueprintFilePath } = discoveredBlueprint;
     writeConfigFile(blueprintFilePath, { projectId: resolvedProjectId, stackId: stack.id });
     log(check(`${styleText('bold', 'Configured:')} ${exampleDir}/${BLUEPRINT_CONFIG_DIR}/${BLUEPRINT_CONFIG_FILE}`));
-    log(`\n  Run "${styleText(['bold', 'magenta'], `cd ${exampleDir} && npm i`)}" and check out the README`);
+    log(`\n  Run "${styleText(['bold', 'magenta'], `cd ${exampleDir} && ${installCommand(exampleDir)}`)}" and check out the README`);
     if (instructions) {
         log('');
         log(instructions);
@@ -251,6 +269,7 @@ async function handleExampleInitialization(options) {
 export async function resolveScopeAndStack(params) {
     const { projectId, organizationId, stackId, stackName, knownProjectId, log, token } = params;
     const flagScope = resolveScopeFromFlags(projectId, organizationId);
+    const suggestedName = params.blueprintDir ? basename(resolve(params.blueprintDir)) : undefined;
     // --- Branch 1: Scope provided via flags ---
     if (flagScope) {
         const { scopeType, scopeId } = flagScope;
@@ -283,7 +302,13 @@ export async function resolveScopeAndStack(params) {
         // No stack flag: prompt for stack selection
         if (!resolvedStackId) {
             log('\nBlueprints are deployed to a "Stack".');
-            const stackResult = await promptForStack({ scopeType, scopeId, token, logger: log });
+            const stackResult = await promptForStack({
+                scopeType,
+                scopeId,
+                token,
+                logger: log,
+                suggestedName,
+            });
             if (typeof stackResult === 'symbol')
                 throw new Error('Unexpected back navigation');
             resolvedStackId = stackResult.stackId;
@@ -315,6 +340,7 @@ export async function resolveScopeAndStack(params) {
                     scopeId: knownProjectId,
                     token,
                     logger: log,
+                    suggestedName,
                 });
                 if (typeof stackResult === 'symbol')
                     throw new Error('Unexpected back navigation');
@@ -323,7 +349,11 @@ export async function resolveScopeAndStack(params) {
         }
     }
     // Full wizard: org -> scope -> project (if needed) -> stack
-    const wizard = await runScopeAndStackWizard({ token, logger: log });
+    const wizard = await runScopeAndStackWizard({
+        token,
+        logger: log,
+        suggestedStackName: suggestedName,
+    });
     return { scopeType: wizard.scopeType, scopeId: wizard.scopeId, stackId: wizard.stackId };
 }
 export async function determineBlueprintExtension(params) {
@@ -386,12 +416,18 @@ export async function createBlueprintFiles(params) {
             log.warn(warn(`Unable to add ${blueprintsPackage} to your project.`));
         }
     }
-    const nextStepParts = [];
+    const runLine = (command, purpose) => `  Run "${styleText(['bold', 'magenta'], command)}" ${purpose}`;
+    // project setup, only when there is something to do
+    const setupParts = [];
     if (userProvidedDirName)
-        nextStepParts.push(`cd ${userProvidedDirName}`);
+        setupParts.push(`cd ${userProvidedDirName}`);
     if (blueprintExtension !== 'json')
-        nextStepParts.push('npm install');
-    nextStepParts.push(`npx ${bin} blueprints --help`);
-    log(`\n  Run "${styleText(['bold', 'magenta'], nextStepParts.join(' && '))}" to get started`);
+        setupParts.push(installCommand(blueprintDir));
+    log('');
+    if (setupParts.length > 0)
+        log(runLine(setupParts.join(' && '), 'first'));
+    // the manifest starts empty, so name the command that fills it
+    log(runLine(`${runCommand(bin)} functions add`, 'to add a Function'));
+    log(runLine(`${runCommand(bin)} blueprints --help`, 'to see every command'));
     return { success: true };
 }

package/dist/cores/blueprints/plan.js

@@ -3,6 +3,7 @@ import { planStack, resolveStackIdByNameOrId } from '../../actions/blueprints/st
 import { extractDurableConfig } from '../../utils/blueprints/extract-durable-config.js';
 import { createHintCollector } from '../../utils/blueprints/hints.js';
 import { formatDeploymentPlan, formatResourceTree, hasActionableChanges, } from '../../utils/display/blueprints-formatting.js';
+import { runCommand } from '../../utils/package-manager.js';
 import { styleText } from '../../utils/style-text.js';
 import { getWarnings } from '../../utils/warnings.js';
 export async function blueprintPlanCore(options) {
@@ -18,12 +19,14 @@ export async function blueprintPlanCore(options) {
             ? {
                 success: false,
                 error: 'Missing authentication token',
-                suggestions: [`Run \`npx ${bin} login\` to authenticate.`],
+                suggestions: [`Run \`${runCommand(bin)} login\` to authenticate.`],
             }
             : {
                 success: false,
                 error: 'Missing Blueprint configuration',
-                suggestions: [`Run \`npx ${bin} blueprints doctor --fix\` to fix your configuration.`],
+                suggestions: [
+                    `Run \`${runCommand(bin)} blueprints doctor --fix\` to fix your configuration.`,
+                ],
             };
     }
     const stackId = flags.stack
@@ -34,7 +37,9 @@ export async function blueprintPlanCore(options) {
         return {
             success: false,
             error: 'Missing Stack deployment configuration',
-            suggestions: [`Run \`npx ${bin} blueprints doctor --fix\` to fix your configuration.`],
+            suggestions: [
+                `Run \`${runCommand(bin)} blueprints doctor --fix\` to fix your configuration.`,
+            ],
         };
     }
     const auth = { token, scopeType, scopeId };
@@ -69,7 +74,7 @@ export async function blueprintPlanCore(options) {
             error: 'Deployment plan has problems',
             suggestions: [
                 ...hints.getSuggestions(),
-                `Fix the issues above, then run \`npx ${bin} blueprints deploy\`.`,
+                `Fix the issues above, then run \`${runCommand(bin)} blueprints plan\` again.`,
             ],
         };
     }
@@ -77,10 +82,10 @@ export async function blueprintPlanCore(options) {
     log('');
     log(formatDeploymentPlan(planResponse.deploymentPlan));
     if (hasActionableChanges(planResponse.deploymentPlan)) {
-        log(`\n  Run "${styleText(['bold', 'magenta'], `npx ${bin} blueprints deploy`)}" to apply these Stack changes`);
+        log(`\n  Run "${styleText(['bold', 'magenta'], `${runCommand(bin)} blueprints deploy`)}" to apply these Stack changes`);
     }
     else {
-        log(`\n  ${styleText('dim', `No significant changes to deploy. Run \`npx ${bin} blueprints deploy\` to apply.`)}`);
+        log(`\n  ${styleText('dim', `No significant changes to deploy. Run \`${runCommand(bin)} blueprints deploy\` to apply.`)}`);
     }
     return {
         success: true,

package/dist/cores/blueprints/promote.js

@@ -2,6 +2,7 @@ import { confirm } from '@inquirer/prompts';
 import { patchConfigFile } from '../../actions/blueprints/config.js';
 import { promoteStack } from '../../actions/blueprints/stacks.js';
 import { niceId } from '../../utils/display/presenters.js';
+import { runCommand } from '../../utils/package-manager.js';
 export async function blueprintPromoteCore(options) {
     const { bin = 'sanity', log, stackId, auth, flags, deployedStack, blueprint } = options;
     const newStackName = flags['new-stack-name'];
@@ -47,7 +48,7 @@ export async function blueprintPromoteCore(options) {
             if (error && /access|permission|forbidden/i.test(error)) {
                 suggestions.push('Verify you have organization admin access.');
             }
-            suggestions.push(`Run \`npx ${bin} blueprints info\` to check the current Stack scope.`);
+            suggestions.push(`Run \`${runCommand(bin)} blueprints info\` to check the current Stack scope.`);
             return { success: false, error: error || 'Failed to promote Stack', suggestions };
         }
         spinner.stop().clear();
@@ -66,7 +67,7 @@ export async function blueprintPromoteCore(options) {
                 success: false,
                 error: 'Stack promoted, but could not update Blueprint config (.sanity/blueprint.config.json).',
                 suggestions: [
-                    `Run \`npx ${bin} blueprints config --edit\` to update your Blueprint config manually.`,
+                    `Run \`${runCommand(bin)} blueprints config --edit\` to update your Blueprint config manually.`,
                 ],
             };
         }

package/dist/cores/functions/add.js

@@ -8,7 +8,9 @@ import { verifyExampleExists, writeExample } from '../../actions/sanity/examples
 import { EVENT_DOCUMENT_CREATE, EVENT_DOCUMENT_DELETE, EVENT_DOCUMENT_UPDATE, EVENT_MEDIA_LIBRARY_ASSET_CREATE, EVENT_MEDIA_LIBRARY_ASSET_DELETE, EVENT_MEDIA_LIBRARY_ASSET_UPDATE, EVENT_PUBSUB, EVENT_SCHEDULED, EVENT_SYNC_TAG_INVALIDATE, FUNCTION_TYPES, LABEL_DOCUMENT_CREATE, LABEL_DOCUMENT_DELETE, LABEL_DOCUMENT_UPDATE, LABEL_MEDIA_LIBRARY_ASSET_CREATE, LABEL_MEDIA_LIBRARY_ASSET_DELETE, LABEL_MEDIA_LIBRARY_ASSET_UPDATE, LABEL_PUBSUB, LABEL_SCHEDULED, LABEL_SYNC_TAG_INVALIDATE, MAP_EVENT_TO_FUNCTION_TYPE, SANITY_FUNCTION_DOCUMENT, SANITY_FUNCTION_MEDIA_LIBRARY_ASSET, SANITY_FUNCTION_PUBSUB, SANITY_FUNCTION_SCHEDULED, SANITY_FUNCTION_SYNC_TAG_INVALIDATE, } from '../../constants.js';
 import { check, indent, warn } from '../../utils/display/presenters.js';
 import { validateFunctionName } from '../../utils/functions/validate-name.js';
+import { detectPackageManager } from '../../utils/package-manager.js';
 import { styleText } from '../../utils/style-text.js';
+import { INSTALLER_OPTIONS } from '../../utils/types.js';
 import { getWarnings } from '../../utils/warnings.js';
 export const generateFunctionBlueprintResourceTemplate = (fnName, eventNames) => {
     const functionType = MAP_EVENT_TO_FUNCTION_TYPE[eventNames[0]];
@@ -44,7 +46,8 @@ export async function functionAddCore(options) {
     const root = cwd();
     const { log, blueprint, flags } = options;
     const { blueprintFilePath } = blueprint.fileInfo;
-    const warnings = getWarnings({ dir: dirname(blueprintFilePath) });
+    const blueprintFileDir = dirname(blueprintFilePath);
+    const warnings = getWarnings({ dir: blueprintFileDir });
     const { example: flagExample, name: flagResourceName, type: flagType, javascript: flagJs, helpers: flagHelpers, install: flagI, installer: flagInstaller, } = flags;
     let { language: flagLang } = flags;
     flagLang = flagJs ? 'js' : flagLang;
@@ -183,7 +186,7 @@ export async function functionAddCore(options) {
         }
         else {
             addHelpers = flagHelpers || (await promptForAddHelpers());
-            installCommand = addHelpers ? await promptForInstallCommand() : null;
+            installCommand = addHelpers ? await promptForInstallCommand(blueprintFileDir) : null;
         }
         if (installCommand)
             log(`${styleText('magenta', 'Installing')} with ${installCommand}...`);
@@ -286,16 +289,17 @@ async function promptForAddHelpers() {
     });
     return addHelpers;
 }
-async function promptForInstallCommand() {
+async function promptForInstallCommand(dir) {
+    // hydrate only supports these three; a detected bun falls back to npm
+    const detected = detectPackageManager(dir);
+    const preferred = INSTALLER_OPTIONS.find((option) => option === detected) ?? 'npm';
     const command = await select({
         message: 'How to install the @sanity/functions helpers:',
         choices: [
-            { name: 'npm', value: 'npm' },
-            { name: 'pnpm', value: 'pnpm' },
-            { name: 'yarn', value: 'yarn' },
+            ...INSTALLER_OPTIONS.map((option) => ({ name: option, value: option })),
             { name: 'Skip install', value: null },
         ],
-        default: 'npm',
+        default: preferred,
     });
     return command;
 }

package/dist/cores/functions/env/add.js

@@ -1,4 +1,5 @@
 import { update } from '../../../actions/functions/env/update.js';
+import { ENV_MASK } from '../../../constants.js';
 import { findFunctionInStack } from '../../../utils/functions/find.js';
 import { resolveFunctionAuth } from '../../../utils/functions/resolve-auth.js';
 import { styleText } from '../../../utils/style-text.js';
@@ -17,5 +18,5 @@ export async function functionEnvAddCore(options) {
         };
     }
     spinner.succeed(`Update of ${args.key} succeeded`);
-    return { success: true, json: { name: args.name, key: args.key, value: args.value } };
+    return { success: true, json: { name: args.name, key: args.key, value: ENV_MASK } };
 }

package/dist/cores/functions/logs.js

@@ -58,8 +58,7 @@ async function streamLogs({ name, externalId, auth, log, }) {
             alreadyOpened = true;
         };
         const renderLog = (logEntry) => {
-            const { time, level, message } = logEntry;
-            log(formatLog(time, level, message, true));
+            log(formatLog(logEntry, true));
         };
         streamLogsAction(externalId, auth, renderLog, onOpen, (error) => log.error(`${styleText('red', 'Error:')} ${error}`), log);
         // Return a special key for streaming mode
@@ -92,27 +91,72 @@ async function getLogs({ name, externalId, auth, limit, json, utc, log, }) {
         const logLength = filteredLogs.length;
         log(`Found ${styleText('bold', logLength.toString())} log ${logLength === 1 ? 'entry' : 'entries'} for function ${styleText('yellow', name)}`);
         log('\n');
-        for (const { time, level, message } of filteredLogs) {
-            log(formatLog(time, level, message, utc));
+        for (const entry of filteredLogs) {
+            log(formatLog(entry, utc));
         }
     }
     else {
-        return { success: true, json: { logs: filteredLogs } };
+        const cleaned = filteredLogs.map(({ time, level, message, operationName, attempt, requestId, executionArn, }) => {
+            const isDurable = executionArn !== undefined;
+            const isStep = operationName !== undefined || attempt !== undefined;
+            const durableContext = isDurable ? (isStep ? 'step' : 'handler') : undefined;
+            return {
+                time,
+                level,
+                message,
+                requestId,
+                ...(durableContext ? { durableContext } : {}),
+                ...(operationName !== undefined ? { step: operationName } : {}),
+                ...(attempt !== undefined ? { attempt } : {}),
+            };
+        });
+        return { success: true, json: { logs: cleaned } };
     }
     return { success: true };
 }
-function formatLog(time, level, message, utc) {
+/**
+ * Formats a log entry for display in the console.
+ * @param entry
+ * @param utc
+ */
+function formatLog(entry, utc) {
+    const { time, level, message, operationName, attempt, executionArn } = entry;
     const date = new Date(time);
     const [dateString, timeString] = utc
         ? date.toISOString().slice(0, 19).split('T')
         : [date.toLocaleDateString(), date.toLocaleTimeString()];
+    const durableAnnotation = durableLogAnnotation({ operationName, attempt, executionArn });
     return [
         styleText('bold', dateString),
         styleText(['bold', 'blue'], timeString),
         logLevel(level.toUpperCase()),
+        ...(durableAnnotation ? [durableAnnotation] : []),
         message,
     ].join(' ');
 }
+/**
+ * Log annotation for durable functions.
+ * @param operationName
+ * @param attempt
+ * @param executionArn
+ */
+function durableLogAnnotation({ operationName, attempt, executionArn, }) {
+    /**
+     * executionArn is included on durable function logs, but not on regular function logs.
+     * If executionArn is defined, we can assume the log is from a durable function.
+     * If executionArn is defined and operationName and attempt are undefined, the logger is in the handler context
+     */
+    const annotationParts = [
+        executionArn !== undefined && operationName === undefined && attempt === undefined
+            ? 'handler'
+            : undefined,
+        ...(operationName ? [operationName] : []),
+        attempt !== undefined ? `attempt:${attempt}` : undefined,
+    ].filter((part) => part !== undefined);
+    return annotationParts.length > 0
+        ? styleText('grey', `[${annotationParts.join('|')}]`)
+        : undefined;
+}
 function logLevel(level) {
     switch (level) {
         case 'ERROR':

package/dist/cores/index.d.ts

@@ -39,6 +39,11 @@ export type CoreResult = {
     ref?: string;
     /** A machine-readable error code. */
     code?: string;
+    /**
+     * The user cancelled a prompt. A calling core reads it to keep its own message.
+     * Not printed: `code` would surface as `Code:` in the command output.
+     */
+    cancelled?: true;
     /** Overrides the process exit code (defaults to oclif's 2). */
     exitCode?: number;
     streaming?: never;

package/dist/server/static/vendor/vendor.bundle.js

@@ -27598,17 +27598,23 @@ function prettyBytes(number, options) {
 	}
 
 	const localeOptions = buildLocaleOptions(options);
+	const base = options.binary ? 1024 : 1000;
 
 	let exponent = 0;
 	if (number >= 1) {
-		exponent = Math.min(Math.floor(options.binary ? log(number) / Math.log(1024) : log10(number) / 3), UNITS.length - 1);
+		exponent = Math.min(Math.floor(options.binary ? log(number) / Math.log(base) : log10(number) / 3), UNITS.length - 1);
 	}
 
-	number = divide(number, (options.binary ? 1024 : 1000) ** exponent);
+	number = divide(number, base ** exponent);
 
 	if (!localeOptions) {
-		const minPrecision = Math.max(3, Math.floor(number).toString().length);
-		number = Number(number.toPrecision(minPrecision));
+		const minimumPrecision = Math.max(3, Math.floor(number).toString().length);
+		number = Number(number.toPrecision(minimumPrecision));
+
+		if (number >= base && exponent < UNITS.length - 1) {
+			number /= base;
+			exponent += 1;
+		}
 	}
 
 	const numberString = toLocaleString(number, options.locale, localeOptions);
@@ -27769,10 +27775,11 @@ function prettyMilliseconds(milliseconds, options) {
 				const roundedMilliseconds = millisecondsAndBelow >= 1
 					? Math.round(millisecondsAndBelow)
 					: Math.ceil(millisecondsAndBelow);
+				const maximumMilliseconds = 1000 - (10 ** -millisecondsDecimalDigits);
 
 				const millisecondsString = millisecondsDecimalDigits
-					? millisecondsAndBelow.toFixed(millisecondsDecimalDigits)
-					: roundedMilliseconds;
+					? Math.min(millisecondsAndBelow, maximumMilliseconds).toFixed(millisecondsDecimalDigits)
+					: Math.min(roundedMilliseconds, maximumMilliseconds);
 
 				add(
 					Number.parseFloat(millisecondsString),

package/dist/utils/blueprints/hints.js

@@ -1,3 +1,5 @@
+import { runCommand } from '../package-manager.js';
+const promoteToOrganization = (bin) => `Run \`${runCommand(bin)} blueprints promote\` to move from project to organization scope.`;
 /**
  * Patterns matched against ERROR/FATAL log entries during streaming operations
  * like deploy and destroy. Each entry is a [regex, suggestionFactory] tuple.
@@ -13,9 +15,12 @@ export const HINT_PATTERNS = [
     [
         // Function requires organization scope
         /must be attached to an organization scoped stack/,
-        (_match, bin) => [
-            `Run \`npx ${bin} blueprints promote\` to move from project to organization scope.`,
-        ],
+        (_match, bin) => [promoteToOrganization(bin)],
+    ],
+    [
+        // Resource needs an organization the project-scoped Stack cannot supply
+        /[Cc]annot resolve organization scope/,
+        (_match, bin) => [promoteToOrganization(bin)],
     ],
 ];
 /**

package/dist/utils/display/prompt.d.ts

@@ -3,6 +3,16 @@ import type { Logger } from '../logger.js';
 import type { ScopeType } from '../types.js';
 export declare const BACK: unique symbol;
 export type Back = typeof BACK;
+/** Thrown when the user picks "Cancel" in a prompt. Cores translate it to a clean result. */
+export declare class CancelledError extends Error {
+    constructor(message?: string);
+}
+/**
+ * Ask where a new Blueprint should go.
+ * Returns the chosen directory, or null to use the current one.
+ * @throws CancelledError when the user cancels.
+ */
+export declare function promptForInitLocation(currentDir: string): Promise<string | null>;
 export declare function promptForBlueprintType(): Promise<string>;
 /**
  * Fetches organizations and prompts the user to pick one (if multiple).
@@ -48,12 +58,14 @@ export declare function promptForProjectInOrg({ projects, knownProjectId, logger
  * Prompt the user for a Stack after scope has been determined.
  * Can create a new Stack or select an existing one.
  */
-export declare function promptForStack({ scopeType, scopeId, token, logger, allowBack, }: {
+export declare function promptForStack({ scopeType, scopeId, token, logger, allowBack, suggestedName, }: {
     scopeType: ScopeType;
     scopeId: string;
     token: string;
     logger: Logger;
     allowBack?: boolean;
+    /** Prefilled name for a new Stack, usually the project directory name. */
+    suggestedName?: string;
 }): Promise<{
     stackId: string;
     name: string;
@@ -62,11 +74,12 @@ export declare function promptForStack({ scopeType, scopeId, token, logger, allo
  * Full wizard: Organization -> Scope -> Project (if project-scoped) -> Stack.
  * Supports back-navigation between steps.
  */
-export declare function runScopeAndStackWizard({ token, knownOrganizationId, knownProjectId, logger, }: {
+export declare function runScopeAndStackWizard({ token, knownOrganizationId, knownProjectId, logger, suggestedStackName, }: {
     token: string;
     knownOrganizationId?: string;
     knownProjectId?: string;
     logger: Logger;
+    suggestedStackName?: string;
 }): Promise<{
     scopeType: ScopeType;
     scopeId: string;