@sanity/runtime-cli 17.15.0 → 17.16.0-next.g26925c0

package/README.md

@@ -90,7 +90,7 @@ EXAMPLES
   $ sanity-run blueprints add function --name my-function --fn-type document-create --fn-type document-update --lang js
 ```
 
-_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.g26925c0/src/commands/blueprints/add.ts)_
 
 ## `sanity-run blueprints config`
 
@@ -127,7 +127,7 @@ EXAMPLES
   $ sanity-run blueprints config --edit --project-id <projectId> --stack <name-or-id>
 ```
 
-_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.g26925c0/src/commands/blueprints/config.ts)_
 
 ## `sanity-run blueprints deploy`
 
@@ -183,7 +183,7 @@ EXAMPLES
   $ sanity-run blueprints deploy --new-stack-name <new-name>
 ```
 
-_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.g26925c0/src/commands/blueprints/deploy.ts)_
 
 ## `sanity-run blueprints destroy`
 
@@ -221,7 +221,7 @@ EXAMPLES
   $ sanity-run blueprints destroy --stack <name-or-id> --project-id <projectId> --force --no-wait
 ```
 
-_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.g26925c0/src/commands/blueprints/destroy.ts)_
 
 ## `sanity-run blueprints doctor`
 
@@ -253,7 +253,7 @@ EXAMPLES
   $ sanity-run blueprints doctor --fix
 ```
 
-_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0/src/commands/blueprints/doctor.ts)_
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.g26925c0/src/commands/blueprints/doctor.ts)_
 
 ## `sanity-run blueprints info`
 
@@ -291,7 +291,7 @@ EXAMPLES
   $ sanity-run blueprints info --organization-id <orgId> --stack <name-or-id>
 ```
 
-_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.g26925c0/src/commands/blueprints/info.ts)_
 
 ## `sanity-run blueprints init [DIR]`
 
@@ -355,7 +355,7 @@ EXAMPLES
   $ sanity-run blueprints init old-stack --type <json|js|ts> --project-id <projectId> --stack-id <existingStackId>
 ```
 
-_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.g26925c0/src/commands/blueprints/init.ts)_
 
 ## `sanity-run blueprints logs`
 
@@ -401,7 +401,7 @@ EXAMPLES
   $ sanity-run blueprints logs --before 2026-05-01T00:00:00Z
 ```
 
-_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.g26925c0/src/commands/blueprints/logs.ts)_
 
 ## `sanity-run blueprints mint-deploy-token`
 
@@ -446,7 +446,7 @@ EXAMPLES
   $ sanity-run blueprints mint-deploy-token --organization-id <orgId>
 ```
 
-_See code: [src/commands/blueprints/mint-deploy-token.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0/src/commands/blueprints/mint-deploy-token.ts)_
+_See code: [src/commands/blueprints/mint-deploy-token.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.g26925c0/src/commands/blueprints/mint-deploy-token.ts)_
 
 ## `sanity-run blueprints plan`
 
@@ -479,7 +479,7 @@ EXAMPLES
   $ sanity-run blueprints plan --organization-id <orgId> --stack <name-or-id>
 ```
 
-_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.g26925c0/src/commands/blueprints/plan.ts)_
 
 ## `sanity-run blueprints promote`
 
@@ -515,7 +515,7 @@ EXAMPLES
   $ sanity-run blueprints promote --new-stack-name <new-name>
 ```
 
-_See code: [src/commands/blueprints/promote.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0/src/commands/blueprints/promote.ts)_
+_See code: [src/commands/blueprints/promote.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.g26925c0/src/commands/blueprints/promote.ts)_
 
 ## `sanity-run blueprints stacks`
 
@@ -556,7 +556,7 @@ EXAMPLES
   $ sanity-run blueprints stacks --organization-id <organizationId> --include-projects
 ```
 
-_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.g26925c0/src/commands/blueprints/stacks.ts)_
 
 ## `sanity-run functions add`
 
@@ -608,7 +608,7 @@ EXAMPLES
   $ sanity-run functions add --name my-function --type document-create --type document-update --lang js
 ```
 
-_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0/src/commands/functions/add.ts)_
+_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.g26925c0/src/commands/functions/add.ts)_
 
 ## `sanity-run functions dev`
 
@@ -643,7 +643,7 @@ EXAMPLES
   $ sanity-run functions dev --timeout 60
 ```
 
-_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.g26925c0/src/commands/functions/dev.ts)_
 
 ## `sanity-run functions env add NAME KEY VALUE`
 
@@ -676,7 +676,7 @@ EXAMPLES
   $ sanity-run functions env add --stack <name-or-id> MyFunction API_URL https://api.example.com/
 ```
 
-_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.g26925c0/src/commands/functions/env/add.ts)_
 
 ## `sanity-run functions env list NAME`
 
@@ -706,7 +706,7 @@ EXAMPLES
   $ sanity-run functions env list --stack <name-or-id> MyFunction
 ```
 
-_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.g26925c0/src/commands/functions/env/list.ts)_
 
 ## `sanity-run functions env remove NAME KEY`
 
@@ -738,7 +738,7 @@ EXAMPLES
   $ sanity-run functions env remove --stack <name-or-id> MyFunction API_URL
 ```
 
-_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.g26925c0/src/commands/functions/env/remove.ts)_
 
 ## `sanity-run functions logs [NAME]`
 
@@ -778,7 +778,7 @@ EXAMPLES
   $ sanity-run functions logs <name> --delete
 ```
 
-_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.g26925c0/src/commands/functions/logs.ts)_
 
 ## `sanity-run functions test [NAME]`
 
@@ -836,7 +836,7 @@ EXAMPLES
   $ sanity-run functions test <name> --event update --data-before '{ "title": "before" }' --data-after '{ "title": "after" }'
 ```
 
-_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-next.g26925c0/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 

package/dist/actions/blueprints/blueprint.d.ts

@@ -1,18 +1,17 @@
 import type { BlueprintResource } from '@sanity/blueprints';
+import { type StackConfig, type ConfigSource as StackConfigSource, type StackIds } from '@sanity/blueprints/resolve';
 import { type Blueprint } from '@sanity/blueprints-parser';
 import type { Logger } from '../../utils/logger.js';
 import type { BlueprintParserError, ScopeType } from '../../utils/types.js';
 import { type LocatedBlueprintsConfig } from './config.js';
-import { type ConfigSource } from './resolve.js';
-declare const SUPPORTED_FILE_EXTENSIONS: readonly ['.json', '.js', '.mjs', '.ts'];
-type BlueprintFileExtension = (typeof SUPPORTED_FILE_EXTENSIONS)[number];
+type BlueprintFileExtension = '.json' | '.js' | '.mjs' | '.ts';
 export declare const JSON_BLUEPRINT_CONTENT: {
     blueprintVersion: string;
     resources: never[];
 };
 export declare const TS_BLUEPRINT_CONTENT: string;
 /** Function type with attached attributes */
-export type BlueprintModule = ((args?: unknown) => Record<string, unknown>) & {
+export type BlueprintModule = ((args?: unknown) => unknown) & {
     organizationId?: string;
     projectId?: string;
     stackId?: string;
@@ -23,12 +22,22 @@ type FileInfo = {
     extension: BlueprintFileExtension;
 };
 /**
- * Finds the blueprint file in the given path or current working directory
+ * Finds the blueprint file in the given path or current working directory, searching parent directories
+ * @see {@link findBlueprintFilePath} in `@sanity/blueprints/resolve`
  * @returns The path, file name, and extension of the blueprint file
  */
 export declare function findBlueprintFile(blueprintPath?: string): FileInfo | null;
-/** @see resolve.ts for the canonical definition */
-export type { ConfigSource } from './resolve.js';
+/**
+ * Where a resolved id came from: a `@sanity/blueprints/resolve` source,
+ * or `inferred` for the legacy `ST-<projectId>` Stack id backfill
+ */
+export type ConfigSource = StackConfigSource | 'inferred';
+/** Resolved Stack ids and scope, with the CLI's sources */
+export interface ResolvedIds extends Omit<StackConfig, 'sources'> {
+    sources: {
+        [K in keyof StackIds]?: ConfigSource;
+    };
+}
 /** Result of loading a blueprint file from disk. */
 export interface LoadedBlueprintFile {
     rawBlueprint: Record<string, unknown>;
@@ -69,6 +78,7 @@ export interface ReadBlueprintResult {
 /**
  * Load a blueprint file from disk: read JSON or import+execute a JS/TS module.
  * Returns the raw blueprint data and the module reference (if dynamic).
+ * @see {@link loadBlueprintFileFromDisk} in `@sanity/blueprints/resolve`
  */
 export declare function loadBlueprintFile(fileInfo: FileInfo): Promise<LoadedBlueprintFile>;
 /**
@@ -87,7 +97,7 @@ export interface LocalBlueprint extends ParsedBlueprintContent {
 /**
  * Find, load, and parse a local blueprint file in one step.
  * Does not read the config file or resolve IDs -- callers that need
- * scope/stack information should use `readConfigFile` + `resolveIds` separately.
+ * scope/stack information should use `readConfigFile` + `resolveStackConfig` separately.
  *
  * @param blueprintPath Path to a blueprint file or directory containing one
  * @param options.validateResources Whether to validate function resources
@@ -99,7 +109,7 @@ export declare function loadAndParseBlueprint(blueprintPath?: string, options?:
  * Reads the blueprint file from disk and parses it.
  * Resolves IDs from environment > blueprint module > config file.
  * Can infer stackId from projectId for legacy ST-<projectId> stacks.
- * @see {@link loadBlueprintFile} {@link readConfigFile} {@link resolveIds} {@link parseBlueprintContent}
+ * @see {@link loadBlueprintFile} {@link readConfigFile} {@link resolveStackConfig} {@link parseBlueprintContent}
  * @todo deprecate in favor of decomposed functions
  * @returns Known information about the Blueprint, config, and Stack
  */
@@ -114,3 +124,4 @@ export declare function addResourceToBlueprint<T extends BlueprintResource>({ bl
     blueprintFilePath?: string;
     resource: T;
 }): T | undefined;
+export {};

package/dist/actions/blueprints/blueprint.js

@@ -1,20 +1,12 @@
-import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { basename, dirname, extname } from 'node:path';
-import { cwd } from 'node:process';
 import { pathToFileURL } from 'node:url';
+import { findBlueprintFile as findBlueprintFilePath, loadBlueprintFile as loadBlueprintFileFromDisk, resolveStackConfig, } from '@sanity/blueprints/resolve';
 import blueprintParserValidator from '@sanity/blueprints-parser';
-import * as find from 'empathic/find';
 import { createJiti } from 'jiti';
 import { SANITY_FUNCTION_DOCUMENT, SANITY_FUNCTION_DURABLE, SANITY_FUNCTION_MEDIA_LIBRARY_ASSET, SANITY_FUNCTION_SCHEDULED, } from '../../constants.js';
 import { validateResources } from '../../utils/blueprints/validate-resources.js';
 import { backfillProjectBasedStackId, readConfigFile, } from './config.js';
-import { resolveIds } from './resolve.js';
-const SUPPORTED_FILE_EXTENSIONS = ['.json', '.js', '.mjs', '.ts'];
-let SUPPORTED_FILE_NAMES = SUPPORTED_FILE_EXTENSIONS.map((ext) => `blueprint${ext}`);
-SUPPORTED_FILE_NAMES = [
-    ...SUPPORTED_FILE_NAMES,
-    ...SUPPORTED_FILE_NAMES.map((name) => `sanity.${name}`),
-];
 export const JSON_BLUEPRINT_CONTENT = {
     blueprintVersion: '2024-10-01',
     resources: [],
@@ -29,88 +21,42 @@ export default defineBlueprint({
 })
 `.trim();
 /**
- * Finds the blueprint file in the given path or current working directory
+ * Finds the blueprint file in the given path or current working directory, searching parent directories
+ * @see {@link findBlueprintFilePath} in `@sanity/blueprints/resolve`
  * @returns The path, file name, and extension of the blueprint file
  */
 export function findBlueprintFile(blueprintPath) {
-    let dirToSearch = cwd();
-    if (blueprintPath) {
-        const pathExists = existsSync(blueprintPath);
-        if (!pathExists)
-            return null;
-        const stat = statSync(blueprintPath);
-        if (stat.isFile()) {
-            return {
-                blueprintFilePath: blueprintPath,
-                fileName: basename(blueprintPath),
-                extension: extname(blueprintPath),
-            };
-        }
-        if (stat.isDirectory()) {
-            dirToSearch = blueprintPath;
-        }
-    }
-    const blueprintFile = find.any(SUPPORTED_FILE_NAMES, { cwd: dirToSearch });
-    if (!blueprintFile)
+    const blueprintFilePath = findBlueprintFilePath(blueprintPath);
+    if (!blueprintFilePath)
         return null;
     return {
-        blueprintFilePath: blueprintFile,
-        fileName: basename(blueprintFile),
-        extension: extname(blueprintFile),
+        blueprintFilePath,
+        fileName: basename(blueprintFilePath),
+        extension: extname(blueprintFilePath),
     };
 }
 /**
  * Load a blueprint file from disk: read JSON or import+execute a JS/TS module.
  * Returns the raw blueprint data and the module reference (if dynamic).
+ * @see {@link loadBlueprintFileFromDisk} in `@sanity/blueprints/resolve`
  */
 export async function loadBlueprintFile(fileInfo) {
-    const { blueprintFilePath, fileName, extension } = fileInfo;
-    let rawBlueprint;
-    let blueprintModule;
+    const { blueprintFilePath, fileName } = fileInfo;
     try {
-        switch (extension) {
-            case '.json': {
-                const blueprintString = readFileSync(blueprintFilePath, 'utf8').toString();
-                rawBlueprint = JSON.parse(blueprintString);
-                break;
-            }
-            case '.js':
-            case '.mjs': {
-                const mod = await import(blueprintFilePath);
-                blueprintModule = mod.default;
-                break;
-            }
-            case '.ts': {
-                const jiti = createJiti(dirname(blueprintFilePath));
-                const modDefault = await jiti.import(pathToFileURL(blueprintFilePath).href, { default: true });
-                blueprintModule = modDefault;
-                break;
-            }
-            default:
-                throw Error(`Unsupported Blueprint manifest extension: ${extension}`);
-        }
+        const { blueprint, module } = await loadBlueprintFileFromDisk(blueprintFilePath, {
+            // Use jiti without module cache to avoid stale loads
+            loader: (path) => {
+                return createJiti(path, { moduleCache: false }).import(pathToFileURL(path).href, {
+                    default: true,
+                });
+            },
+        });
+        return { rawBlueprint: { ...blueprint }, module };
     }
     catch (err) {
-        throw Error(`Could not parse Blueprint manifest: ${fileName}\n${err}`);
-    }
-    // Dynamic modules: extract attached properties, then execute to get raw blueprint
-    if (blueprintModule) {
-        if (typeof blueprintModule === 'function') {
-            try {
-                rawBlueprint = blueprintModule();
-            }
-            catch {
-                throw Error(`Error executing Blueprint manifest: ${fileName}`);
-            }
-        }
-        else {
-            throw Error(`Blueprint manifest ${fileName} must export a default function.`);
-        }
-    }
-    if (typeof rawBlueprint === 'undefined') {
-        throw Error('Could not read Blueprint manifest.');
+        const message = err instanceof Error ? err.message : String(err);
+        throw Error(`Could not parse Blueprint manifest: ${fileName}\n${message}`);
     }
-    return { rawBlueprint, module: blueprintModule };
 }
 /**
  * Run the blueprint parser/validator on raw blueprint data.
@@ -142,7 +88,7 @@ export function parseBlueprintContent(rawBlueprint, options) {
 /**
  * Find, load, and parse a local blueprint file in one step.
  * Does not read the config file or resolve IDs -- callers that need
- * scope/stack information should use `readConfigFile` + `resolveIds` separately.
+ * scope/stack information should use `readConfigFile` + `resolveStackConfig` separately.
  *
  * @param blueprintPath Path to a blueprint file or directory containing one
  * @param options.validateResources Whether to validate function resources
@@ -165,7 +111,7 @@ export async function loadAndParseBlueprint(blueprintPath, options = { validateR
  * Reads the blueprint file from disk and parses it.
  * Resolves IDs from environment > blueprint module > config file.
  * Can infer stackId from projectId for legacy ST-<projectId> stacks.
- * @see {@link loadBlueprintFile} {@link readConfigFile} {@link resolveIds} {@link parseBlueprintContent}
+ * @see {@link loadBlueprintFile} {@link readConfigFile} {@link resolveStackConfig} {@link parseBlueprintContent}
  * @todo deprecate in favor of decomposed functions
  * @returns Known information about the Blueprint, config, and Stack
  */
@@ -180,7 +126,7 @@ export async function readLocalBlueprint(logger, validate, blueprintPath) {
     // 2. Read the config file
     const blueprintConfig = readConfigFile(fileInfo.blueprintFilePath);
     // 3. Resolve IDs: env > module > config
-    const resolved = resolveIds({
+    const resolved = resolveStackConfig({
         module: loaded.module,
         config: blueprintConfig,
     });

package/dist/actions/blueprints/config.d.ts

@@ -9,6 +9,7 @@ export interface BlueprintsConfig extends ConfigUpdate {
     blueprintConfigVersion?: typeof BLUEPRINT_CONFIG_VERSION;
     runtimeCliVersion?: typeof RUNTIME_CLI_VERSION;
     updatedAt?: number;
+    internalEnv?: string;
 }
 export interface LocatedBlueprintsConfig extends BlueprintsConfig {
     configPath: string;

package/dist/actions/blueprints/config.js

@@ -1,6 +1,6 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
-import { cwd } from 'node:process';
+import { cwd, env } from 'node:process';
 import config, { BLUEPRINT_CONFIG_DIR, BLUEPRINT_CONFIG_FILE, BLUEPRINT_CONFIG_VERSION, RUNTIME_CLI_VERSION, } from '../../config.js';
 import { getProject } from '../sanity/projects.js';
 import { listStacks } from './stacks.js';
@@ -48,6 +48,12 @@ export function writeConfigFile(blueprintFilePath, options) {
     config.blueprintConfigVersion = BLUEPRINT_CONFIG_VERSION;
     config.runtimeCliVersion = RUNTIME_CLI_VERSION;
     config.updatedAt = Date.now();
+    if (env.SANITY_INTERNAL_ENV) {
+        config.internalEnv = env.SANITY_INTERNAL_ENV;
+    }
+    else {
+        delete config.internalEnv;
+    }
     writeFileSync(configPath, JSON.stringify(config, null, 2));
     return config;
 }

package/dist/baseCommands.js

@@ -1,8 +1,8 @@
 // * https://oclif.io/docs/base_class
 import { Command, CommandHelp, Errors, Flags as OclifFlags } from '@oclif/core';
+import { resolveStackConfig } from '@sanity/blueprints/resolve';
 import { findBlueprintFile, loadBlueprintFile, parseBlueprintContent, } from './actions/blueprints/blueprint.js';
 import { backfillProjectBasedStackId, readConfigFile, } from './actions/blueprints/config.js';
-import { resolveIds } from './actions/blueprints/resolve.js';
 import { getStack, resolveStackIdByNameOrId } from './actions/blueprints/stacks.js';
 import config from './config.js';
 import { CI_SETUP_DOCS_URL } from './constants.js';
@@ -295,8 +295,8 @@ export class ResolvedCommand extends RuntimeCommand {
             };
         }
         // 4. Resolve IDs
-        const resolved = resolveIds({
-            flags: {
+        const resolved = resolveStackConfig({
+            overrides: {
                 projectId: this.flags['project-id'],
                 organizationId: this.flags['organization-id'],
             },

package/dist/config.d.ts

@@ -1,7 +1,6 @@
 export declare const BLUEPRINT_CONFIG_VERSION = "v2025-05-08";
 export declare const BLUEPRINTS_API_VERSION: string;
-export declare const BLUEPRINT_CONFIG_DIR = ".sanity";
-export declare const BLUEPRINT_CONFIG_FILE = "blueprint.config.json";
+export { STACK_CONFIG_DIR as BLUEPRINT_CONFIG_DIR, STACK_CONFIG_FILE as BLUEPRINT_CONFIG_FILE, } from '@sanity/blueprints/resolve';
 export declare const RUNTIME_CLI_NAME = "@sanity/runtime-cli";
 export declare let RUNTIME_CLI_VERSION: string | undefined;
 export declare const RUNTIME_CLI_USER_AGENT: string;

package/dist/config.js

@@ -8,8 +8,7 @@ export const BLUEPRINT_CONFIG_VERSION = 'v2025-05-08';
 // Default API version for Blueprints service calls.
 // Overridable globally via env, or per-endpoint via the `version` arg to `blueprintsUrl`.
 export const BLUEPRINTS_API_VERSION = env.SANITY_BLUEPRINTS_API_VERSION ?? 'v2026-06-15';
-export const BLUEPRINT_CONFIG_DIR = '.sanity';
-export const BLUEPRINT_CONFIG_FILE = 'blueprint.config.json';
+export { STACK_CONFIG_DIR as BLUEPRINT_CONFIG_DIR, STACK_CONFIG_FILE as BLUEPRINT_CONFIG_FILE, } from '@sanity/blueprints/resolve';
 export const RUNTIME_CLI_NAME = '@sanity/runtime-cli';
 export let RUNTIME_CLI_VERSION;
 try {

package/dist/cores/blueprints/doctor.js

@@ -1,11 +1,11 @@
 import { readFileSync } from 'node:fs';
 import { dirname } from 'node:path';
 import { arch, cwd, env, version as nodeVersion, platform } from 'node:process';
+import { resolveStackConfig } from '@sanity/blueprints/resolve';
 import { formatDateTime } from '@sanity/cli-core/dates';
 import * as resolve from 'empathic/resolve';
 import { loadAndParseBlueprint, } from '../../actions/blueprints/blueprint.js';
 import { readConfigFile } from '../../actions/blueprints/config.js';
-import { resolveIds } from '../../actions/blueprints/resolve.js';
 import { getStack } from '../../actions/blueprints/stacks.js';
 import config, { RUNTIME_CLI_VERSION } from '../../config.js';
 import { presentBlueprintParserErrors } from '../../utils/display/errors.js';
@@ -92,7 +92,7 @@ export async function blueprintDoctorCore(options) {
             validateResources: options.validateResources || false,
         });
         const blueprintConfig = readConfigFile(blueprint.fileInfo.blueprintFilePath);
-        const resolved = resolveIds({
+        const resolved = resolveStackConfig({
             module: blueprint.module,
             config: blueprintConfig,
         });

package/dist/cores/blueprints/init.js

@@ -125,6 +125,16 @@ async function handleExistingBlueprint(options) {
             error: 'Flag --example cannot be used with an existing Blueprint.',
         };
     }
+    const existingBlueprint = await readLocalBlueprint(log, { resources: validateResources || false }, existingBlueprintFile.blueprintFilePath);
+    const hasStack = Boolean(existingBlueprint.blueprintConfig?.stackId);
+    if (hasStack) {
+        const overwrite = await confirm({
+            message: 'This Blueprint has an existing Stack. Are you sure you want to re-initialize?',
+            default: true,
+        });
+        if (!overwrite)
+            return { success: false, error: 'Initialization cancelled.' };
+    }
     // --stack-name with a scope flag means create a new stack before configuring
     let resolvedStackId = flagStackId;
     if (!resolvedStackId && flagStackName) {
@@ -142,7 +152,7 @@ async function handleExistingBlueprint(options) {
     }
     // unknown intent, prompt for confirmation
     const flagProvidedConfig = [flagProjectId, flagOrganizationId, flagStackId].some(Boolean);
-    if (!flagProvidedConfig && !flagStackName) {
+    if (!flagProvidedConfig && !hasStack && !flagStackName) {
         const overwrite = await confirm({
             message: "This Blueprint doesn't have a deployment Stack yet. Configure one now?",
             default: true,
@@ -150,7 +160,6 @@ async function handleExistingBlueprint(options) {
         if (!overwrite)
             return { success: false, error: 'Initialization cancelled.' };
     }
-    const existingBlueprint = await readLocalBlueprint(log, { resources: validateResources || false }, existingBlueprintFile.blueprintFilePath);
     return blueprintConfigCore({
         blueprint: existingBlueprint,
         bin,

package/dist/cores/functions/test.js

@@ -1,7 +1,7 @@
 import { dirname } from 'node:path';
 import { testAction } from '../../actions/functions/test.js';
 import config from '../../config.js';
-import { STEP_PHASE_GLYPH } from '../../constants.js';
+import { SANITY_FUNCTION_DURABLE, STEP_PHASE_GLYPH } from '../../constants.js';
 import { resolveDeployedResources } from '../../utils/blueprints/resolve-deployed-resources.js';
 import { createDurableJsonCollector } from '../../utils/functions/durable-logs.js';
 import { findFunctionInResources, getFunctionNames } from '../../utils/functions/find.js';
@@ -88,15 +88,38 @@ export async function functionTestCore(options) {
          * surfaced after the spinner resolves, including failed ones — a downstream
          * error is fire-and-forget (it doesn't reject the caller) but is still shown.
          */
-        const runNested = async (nestedName, nestedPayload, ctx, depth, callStack) => {
+        const runNested = async (nestedName, nestedPayload, ctx, depth, callStack, metadata) => {
             const order = ++nestedOrder;
             const nestedResource = findFunctionInResources(blueprint.resources, nestedName);
-            const result = await runFunction(nestedResource, { payload: nestedPayload, event: 'nested' }, { ...ctx, resources: resolvedResources }, { depth, callStack, onNestedInvoke: runNested });
-            nestedRuns.push({ order, name: nestedName, logs: result.logs, error: result.error });
-            return result;
+            const isLiveDurable = metadata?.origin === 'step.delegate' && nestedResource.type === SANITY_FUNCTION_DURABLE;
+            if (isLiveDurable) {
+                log(`↳ BEGIN: invoke('${nestedName}')`);
+            }
+            try {
+                const result = await runFunction(nestedResource, { payload: nestedPayload, event: 'nested' }, { ...ctx, resources: resolvedResources }, { depth, callStack, onNestedInvoke: runNested, onStepEvent });
+                if (result.error && isLiveDurable) {
+                    log(result.error.stack || result.error.message);
+                }
+                nestedRuns.push({
+                    order,
+                    name: nestedName,
+                    logs: result.logs,
+                    error: result.error,
+                    isLiveDurable,
+                });
+                return result;
+            }
+            finally {
+                if (isLiveDurable) {
+                    log(`↳ END: invoke('${nestedName}')`);
+                }
+            }
         };
         const logNestedRuns = () => {
             for (const run of [...nestedRuns].sort((a, b) => a.order - b.order)) {
+                // Skip if is Durable so log ordering is retained
+                if (run.isLiveDurable)
+                    continue;
                 log(`↳ BEGIN: invoke('${run.name}')`);
                 // Show any logs received
                 if (run.logs?.trim()) {

package/dist/server/app.js

@@ -1,11 +1,11 @@
 import { existsSync, readFileSync, watchFile } from 'node:fs';
 import * as http from 'node:http';
 import { dirname } from 'node:path';
+import { resolveStackConfig } from '@sanity/blueprints/resolve';
 import { default as mime } from 'mime-types';
 import { WebSocket, WebSocketServer } from 'ws';
 import { findBlueprintFile, loadAndParseBlueprint } from '../actions/blueprints/blueprint.js';
 import { readConfigFile } from '../actions/blueprints/config.js';
-import { resolveIds } from '../actions/blueprints/resolve.js';
 import config from '../config.js';
 import { isRecord } from '../utils/is-record.js';
 import { isEventType, isGroqContextOptions, } from '../utils/types.js';
@@ -47,7 +47,7 @@ const app = (host, port, validateResources, executionOptions) => {
                     const blueprint = await loadAndParseBlueprint(undefined, { validateResources });
                     const { parsedBlueprint, fileInfo, module: blueprintModule } = blueprint;
                     const blueprintConfig = readConfigFile(fileInfo.blueprintFilePath);
-                    const { projectId, organizationId } = resolveIds({
+                    const { projectId, organizationId } = resolveStackConfig({
                         module: blueprintModule,
                         config: blueprintConfig,
                     });

package/dist/server/static/components/app.css

@@ -191,7 +191,7 @@ body {
 .border-right {
   border-right-width: 1px;
   border-right-style: solid;
-  border-top-color: var(--card-border-color);
+  border-right-color: var(--card-border-color);
 }
 
 .hr-border {
@@ -413,6 +413,13 @@ ol[type='content'] li:hover:not(.selected:not(.selected)) {
   border-right: none;
 }
 
+fieldset {
+  & :is(input:not([role='switch']), select, textarea) {
+    border: 1px solid light-dark(var(--gray-200), var(--gray-800)) !important;
+    border-radius: var(--radius-2);
+  }
+}
+
 & :is(input:not([is='switch']), select, textarea) {
   border: 1px solid light-dark(var(--gray-200), var(--gray-800)) !important;
   border-radius: var(--radius-2);

package/dist/utils/functions/child-process-wrapper.js

@@ -86,7 +86,7 @@ process.on('message', async (data) => {
         {
           emit: (e) => process.send(JSON.stringify({type: 'step-event', event: e})),
           wait: (ms) => new Promise((resolve) => setTimeout(resolve, noWait ? 0 : ms)),
-          invoke: invoker.invoke,
+          invoke: invoker.delegate,
         },
       )
     } else {

package/dist/utils/functions/child-runtime/invoke.d.ts

@@ -1,4 +1,5 @@
 export function createInvoker(): {
   invoke: (name: string, payload?: Record<string, unknown>) => Promise<unknown>
+  delegate: (name: string, payload?: Record<string, unknown>) => Promise<unknown>
   handleResponse: (msg: unknown) => void
 }

package/dist/utils/functions/child-runtime/invoke.js

@@ -10,6 +10,17 @@ export function createInvoker() {
   const pending = new Map()
   let invokeSeq = 0
 
+  function sendInvokeRequest(name, payload = {}, metadata = {}) {
+    if (typeof name !== 'string' || name.length === 0) {
+      return Promise.reject(new Error('context.invoke requires a function name'))
+    }
+    const id = String(++invokeSeq)
+    return new Promise((resolve, reject) => {
+      pending.set(id, {resolve, reject})
+      process.send(JSON.stringify({type: 'invoke-request', id, name, payload, metadata}))
+    })
+  }
+
   /**
    * `context.invoke(name, payload)` — ask the parent to execute another blueprint
    * function and resolve with its return value. Sent over IPC and correlated by id.
@@ -18,14 +29,20 @@ export function createInvoker() {
    * @returns {Promise<unknown>}
    */
   function invoke(name, payload = {}) {
-    if (typeof name !== 'string' || name.length === 0) {
-      return Promise.reject(new Error('context.invoke requires a function name'))
-    }
-    const id = String(++invokeSeq)
-    return new Promise((resolve, reject) => {
-      pending.set(id, {resolve, reject})
-      process.send(JSON.stringify({type: 'invoke-request', id, name, payload}))
-    })
+    return sendInvokeRequest(name, payload)
+  }
+
+  /**
+   * durable `step.delegate(name, payload)` — ask the parent durable to execute another blueprint function
+   * and resolve with its return value. Sent over IPC and correlated by id. Adds an `origin` field to the message so the parent can
+   * distinguish between a normal invoke and a durable delegate for logging purposes.
+   * @param {string} name
+   * @param {Record<string, unknown>} [payload]
+   * @returns {Promise<unknown>}
+   */
+  function delegate(name, payload = {}) {
+    const metadata = {origin: 'step.delegate'}
+    return sendInvokeRequest(name, payload, metadata)
   }
 
   function handleResponse(msg) {
@@ -43,5 +60,5 @@ export function createInvoker() {
     }
   }
 
-  return {invoke, handleResponse}
+  return {delegate, invoke, handleResponse}
 }

package/dist/utils/functions/extract-durable-config.js

@@ -5,7 +5,7 @@ import { SANITY_FUNCTION_DURABLE } from '../../constants.js';
 import { isLocalFunctionResource } from '../types.js';
 import { findFunctionEntryPoint } from './find-entry-point.js';
 import { transpileFunction } from './transpile/function.js';
-const DURABLE_CONFIG_KEYS = ['event', 'concurrency', 'debounce', 'debounceKey'];
+const DURABLE_CONFIG_KEYS = ['event', 'concurrency', 'debounce'];
 /**
  * Extracts the blueprint config from the function source code and mutates it to the resource object.
  * This is used for durable functions that may not have a config defined in the blueprint.
@@ -47,9 +47,6 @@ export const extractDurableConfig = async (resource, blueprintFileDir) => {
     if (resource.debounce === undefined && config?.debounce !== undefined) {
         resource.debounce = config.debounce;
     }
-    if (resource.debounceKey === undefined && config?.debounceKey !== undefined) {
-        resource.debounceKey = config.debounceKey;
-    }
     // Validate the resource after merging the config values
     const errors = validateDurableFunction(resource);
     if (errors.length > 0) {

package/dist/utils/functions/invoke/local.js

@@ -156,14 +156,14 @@ export default async function invoke(resource, payload, context, options) {
         // Resolve a nested `context.invoke(name, payload)` by re-entering the invoke
         // pipeline via the supplied callback, then hand the result back to the child.
         async function handleNestedInvoke(msg) {
-            const { id, name, payload: nestedPayload } = msg;
+            const { id, name, payload: nestedPayload, metadata } = msg;
             pauseTimer();
             const nestedStart = performance.now();
             try {
                 if (!onNestedInvoke) {
                     throw new Error('Nested context.invoke is not supported in this context');
                 }
-                const nested = await onNestedInvoke(name, nestedPayload ?? {}, context, depth + 1, callStack);
+                const nested = await onNestedInvoke(name, nestedPayload ?? {}, context, depth + 1, callStack, metadata);
                 nestedTimings[`invoke:${name}`] =
                     (nestedTimings[`invoke:${name}`] ?? 0) + (performance.now() - nestedStart);
                 // Fire-and-forget contract: in production `context.invoke` returns once the
@@ -231,7 +231,12 @@ export default async function invoke(resource, payload, context, options) {
                 }
                 // Nested invoke request — handle without tearing down the child.
                 if (msg?.type === 'invoke-request') {
-                    handleNestedInvoke({ id: msg.id, name: msg.name, payload: msg.payload });
+                    handleNestedInvoke({
+                        id: msg.id,
+                        name: msg.name,
+                        payload: msg.payload,
+                        metadata: msg.metadata,
+                    });
                     return;
                 }
                 // Terminal result message.

package/dist/utils/functions/invoke/nested.js

@@ -28,7 +28,7 @@ export function assertNestedInvokeAllowed(name, depth, callStack) {
  * stack extended by this function, and normalize timings.
  */
 export async function runFunction(resource, payload, context, options) {
-    const { forceColor, timeout, depth = 0, callStack = [], onNestedInvoke } = options;
+    const { forceColor, timeout, depth = 0, callStack = [], onNestedInvoke, onStepEvent } = options;
     assertNestedInvokeAllowed(resource.name, depth, callStack);
     const response = await invoke(resource, payload, context, {
         forceColor,
@@ -36,6 +36,7 @@ export async function runFunction(resource, payload, context, options) {
         onNestedInvoke,
         depth,
         callStack: [...callStack, resource.name],
+        onStepEvent,
     });
     return { ...response, timings: response.timings ?? {} };
 }

package/dist/utils/types.d.ts

@@ -187,12 +187,15 @@ export interface InvokeExecutionOptions {
     /** Don't wait the full duration during a wait durable event @internal */
     noWait?: boolean;
 }
+export type NestedInvokeMetadata = {
+    origin?: 'step.delegate';
+};
 /**
  * Re-entrant callback that executes a named function from the blueprint on behalf
  * of a nested `context.invoke(name, payload)` and returns its invocation result.
  * @internal
  */
-export type NestedInvoke = (name: string, payload: Record<string, unknown>, context: InvokeContextOptions, depth: number, callStack: string[]) => Promise<InvocationResponse & {
+export type NestedInvoke = (name: string, payload: Record<string, unknown>, context: InvokeContextOptions, depth: number, callStack: string[], metadata?: NestedInvokeMetadata) => Promise<InvocationResponse & {
     timings: Record<string, number>;
 }>;
 /**
@@ -233,6 +236,7 @@ export type ChildToParentMessage = {
     name: string;
     payload: Record<string, unknown>;
     isDurable?: boolean;
+    metadata?: NestedInvokeMetadata;
 } | {
     type: 'result';
     json?: JsonInvocationResponse;

package/oclif.manifest.json

@@ -3148,5 +3148,5 @@
       ]
     }
   },
-  "version": "17.15.0"
+  "version": "17.16.0-next.g26925c0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sanity/runtime-cli",
   "description": "Sanity's Runtime CLI for Blueprints and Functions",
-  "version": "17.15.0",
+  "version": "17.16.0-next.g26925c0",
   "author": "Sanity Runtime Team",
   "type": "module",
   "license": "MIT",
@@ -68,7 +68,7 @@
     "@oclif/core": "^4.14.0",
     "@oclif/plugin-help": "^6.3.0",
     "@sanity-labs/oclif-plugin-skills-flag": "^0.2.1",
-    "@sanity/blueprints": "^0.27.0",
+    "@sanity/blueprints": "^0.28.0",
     "@sanity/blueprints-parser": "^0.5.0",
     "@sanity/cli-build": "^6.3.0",
     "@sanity/cli-core": "^3.7.0",

package/dist/actions/blueprints/resolve.d.ts

@@ -1,51 +0,0 @@
-import type { ScopeType } from '../../utils/types.js';
-/**
- * Source of a resolved config value.
- * - flags: from CLI flags like `--project-id`
- * - env: from the environment - usually CLI var like `SANITY_ORGANIZATION_ID`
- * - module: from the blueprint module - undocumented escape hatch
- * - config: from the config file - .sanity/blueprint.config.json most common
- * - inferred: legacy `ST-<projectId>` stacks from launch
- */
-export type ConfigSource = 'flags' | 'env' | 'module' | 'config' | 'inferred';
-/** A set of optional IDs from a single source. */
-export interface IdValues {
-    organizationId?: string;
-    projectId?: string;
-    stackId?: string;
-}
-/**
- * Sources to resolve IDs from, in descending priority.
- * Each key maps to a source; the first non-empty value wins.
- *
- * - `env` defaults to reading SANITY_* process.env vars
- * - `module` and `config` accept any object with `{organizationId?, projectId?, stackId?}`
- */
-export interface IdSources {
-    flags?: IdValues | null;
-    env?: IdValues | null;
-    module?: IdValues | null;
-    config?: IdValues | null;
-}
-export interface ResolvedIds {
-    organizationId?: string;
-    projectId?: string;
-    stackId?: string;
-    scopeType?: ScopeType;
-    scopeId?: string;
-    sources: {
-        organizationId?: ConfigSource;
-        projectId?: ConfigSource;
-        stackId?: ConfigSource;
-    };
-}
-/**
- * Resolve organization, project, and stack IDs from a prioritized set of sources.
- * Precedence: flags > env > module > config.
- * Derives scopeType/scopeId from the resolved IDs (project > organization).
- *
- * Env vars are read from process.env by default (SANITY_ORGANIZATION_ID,
- * SANITY_PROJECT_ID, SANITY_BLUEPRINT_STACK_ID). Pass `env` explicitly to
- * override, or `null` to skip.
- */
-export declare function resolveIds(sources?: IdSources): ResolvedIds;

package/dist/actions/blueprints/resolve.js

@@ -1,52 +0,0 @@
-import { env as processEnv } from 'node:process';
-/**
- * Resolve organization, project, and stack IDs from a prioritized set of sources.
- * Precedence: flags > env > module > config.
- * Derives scopeType/scopeId from the resolved IDs (project > organization).
- *
- * Env vars are read from process.env by default (SANITY_ORGANIZATION_ID,
- * SANITY_PROJECT_ID, SANITY_BLUEPRINT_STACK_ID). Pass `env` explicitly to
- * override, or `null` to skip.
- */
-export function resolveIds(sources = {}) {
-    const envValues = sources.env !== undefined
-        ? sources.env
-        : {
-            organizationId: processEnv.SANITY_ORGANIZATION_ID,
-            projectId: processEnv.SANITY_PROJECT_ID,
-            stackId: processEnv.SANITY_BLUEPRINT_STACK_ID,
-        };
-    const ordered = [
-        { source: 'flags', values: sources.flags },
-        { source: 'env', values: envValues },
-        { source: 'module', values: sources.module },
-        { source: 'config', values: sources.config },
-    ];
-    const result = { sources: {} };
-    for (const { source, values } of ordered) {
-        if (values === null || values === undefined)
-            continue;
-        if (!result.organizationId && values.organizationId) {
-            result.organizationId = values.organizationId;
-            result.sources.organizationId = source;
-        }
-        if (!result.projectId && values.projectId) {
-            result.projectId = values.projectId;
-            result.sources.projectId = source;
-        }
-        if (!result.stackId && values.stackId) {
-            result.stackId = values.stackId;
-            result.sources.stackId = source;
-        }
-    }
-    // Scope is as specific as possible; project > organization
-    if (result.projectId) {
-        result.scopeType = 'project';
-        result.scopeId = result.projectId;
-    }
-    else if (result.organizationId) {
-        result.scopeType = 'organization';
-        result.scopeId = result.organizationId;
-    }
-    return result;
-}