@sanity/runtime-cli 16.0.3 → 17.1.0-next.g3cb2d2e

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g @sanity/runtime-cli
 $ sanity-run COMMAND
 running command...
 $ sanity-run (--version)
-@sanity/runtime-cli/16.0.3 linux-x64 node-v24.16.0
+@sanity/runtime-cli/17.1.0-next.g3cb2d2e linux-x64 node-v24.18.0
 $ sanity-run --help [COMMAND]
 USAGE
   $ sanity-run COMMAND
@@ -103,7 +103,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/v16.0.3/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0-next.g3cb2d2e/src/commands/blueprints/add.ts)_
 
 ## `sanity-run blueprints config`
 
@@ -140,7 +140,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/v16.0.3/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0-next.g3cb2d2e/src/commands/blueprints/config.ts)_
 
 ## `sanity-run blueprints deploy`
 
@@ -194,7 +194,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/v16.0.3/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0-next.g3cb2d2e/src/commands/blueprints/deploy.ts)_
 
 ## `sanity-run blueprints destroy`
 
@@ -232,7 +232,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/v16.0.3/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0-next.g3cb2d2e/src/commands/blueprints/destroy.ts)_
 
 ## `sanity-run blueprints doctor`
 
@@ -263,7 +263,7 @@ EXAMPLES
   $ sanity-run blueprints doctor --fix
 ```
 
-_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v16.0.3/src/commands/blueprints/doctor.ts)_
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0-next.g3cb2d2e/src/commands/blueprints/doctor.ts)_
 
 ## `sanity-run blueprints info`
 
@@ -300,7 +300,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/v16.0.3/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0-next.g3cb2d2e/src/commands/blueprints/info.ts)_
 
 ## `sanity-run blueprints init [DIR]`
 
@@ -312,7 +312,7 @@ USAGE
     --stack-id <value> | --stack-name <value>] [--project-id <value> | --organization-id <value>]
 
 ARGUMENTS
-  [DIR]  Directory to create the local Blueprint in
+  [DIR]  Directory to create the local Blueprint in (defaults to the current directory)
 
 FLAGS
   --blueprint-type=<option>  Blueprint manifest type to use for the local Blueprint
@@ -339,9 +339,14 @@ DESCRIPTION
 
   After initialization, use 'blueprints plan' to preview changes, then 'blueprints deploy' to apply them.
 
+  Running without a directory prompts to confirm the current directory. Run 'blueprints init .' to initialize in the
+  current directory without a prompt.
+
 EXAMPLES
   $ sanity-run blueprints init
 
+  $ sanity-run blueprints init .
+
   $ sanity-run blueprints init [directory]
 
   $ sanity-run blueprints init --blueprint-type <json|js|ts>
@@ -359,7 +364,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/v16.0.3/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0-next.g3cb2d2e/src/commands/blueprints/init.ts)_
 
 ## `sanity-run blueprints logs`
 
@@ -405,7 +410,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/v16.0.3/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0-next.g3cb2d2e/src/commands/blueprints/logs.ts)_
 
 ## `sanity-run blueprints mint-deploy-token`
 
@@ -450,7 +455,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/v16.0.3/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.1.0-next.g3cb2d2e/src/commands/blueprints/mint-deploy-token.ts)_
 
 ## `sanity-run blueprints plan`
 
@@ -483,7 +488,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/v16.0.3/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0-next.g3cb2d2e/src/commands/blueprints/plan.ts)_
 
 ## `sanity-run blueprints promote`
 
@@ -519,7 +524,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/v16.0.3/src/commands/blueprints/promote.ts)_
+_See code: [src/commands/blueprints/promote.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0-next.g3cb2d2e/src/commands/blueprints/promote.ts)_
 
 ## `sanity-run blueprints stacks`
 
@@ -555,7 +560,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/v16.0.3/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0-next.g3cb2d2e/src/commands/blueprints/stacks.ts)_
 
 ## `sanity-run functions add`
 
@@ -607,7 +612,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/v16.0.3/src/commands/functions/add.ts)_
+_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0-next.g3cb2d2e/src/commands/functions/add.ts)_
 
 ## `sanity-run functions dev`
 
@@ -642,7 +647,7 @@ EXAMPLES
   $ sanity-run functions dev --timeout 60
 ```
 
-_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v16.0.3/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0-next.g3cb2d2e/src/commands/functions/dev.ts)_
 
 ## `sanity-run functions env add NAME KEY VALUE`
 
@@ -672,7 +677,7 @@ EXAMPLES
   $ sanity-run functions env add MyFunction API_URL https://api.example.com/
 ```
 
-_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v16.0.3/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0-next.g3cb2d2e/src/commands/functions/env/add.ts)_
 
 ## `sanity-run functions env list NAME`
 
@@ -699,7 +704,7 @@ EXAMPLES
   $ sanity-run functions env list MyFunction
 ```
 
-_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v16.0.3/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0-next.g3cb2d2e/src/commands/functions/env/list.ts)_
 
 ## `sanity-run functions env remove NAME KEY`
 
@@ -728,7 +733,7 @@ EXAMPLES
   $ sanity-run functions env remove MyFunction API_URL
 ```
 
-_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v16.0.3/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0-next.g3cb2d2e/src/commands/functions/env/remove.ts)_
 
 ## `sanity-run functions logs [NAME]`
 
@@ -768,7 +773,7 @@ EXAMPLES
   $ sanity-run functions logs <name> --delete
 ```
 
-_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v16.0.3/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0-next.g3cb2d2e/src/commands/functions/logs.ts)_
 
 ## `sanity-run functions test [NAME]`
 
@@ -825,7 +830,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/v16.0.3/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0-next.g3cb2d2e/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 
@@ -845,5 +850,5 @@ DESCRIPTION
   Display help for sanity-run.
 ```
 
-_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/6.2.46/src/commands/help.ts)_
+_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/6.2.53/src/commands/help.ts)_
 <!-- commandsstop -->

package/dist/actions/functions/test.js

@@ -1,4 +1,4 @@
-import invoke from '../../utils/functions/invoke-local.js';
+import invoke from '../../utils/functions/invoke/local.js';
 export async function testAction(resource, payload, context, options) {
     try {
         const { json, logs, error } = await invoke(resource, payload, context, options);

package/dist/baseCommands.js

@@ -4,6 +4,8 @@ import { findBlueprintFile, loadBlueprintFile, parseBlueprintContent, } from './
 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';
 import { presentBlueprintParserErrors } from './utils/display/errors.js';
 import { Logger } from './utils/logger.js';
 import { styleText } from './utils/style-text.js';
@@ -319,10 +321,15 @@ export class ResolvedCommand extends RuntimeCommand {
         // 5. Scope
         if (needsScope) {
             if (!resolved.scopeType || !resolved.scopeId) {
-                this.error('Missing scope: provide --project-id or --organization-id, or run `blueprints init` to create a Blueprint config (.sanity/blueprint.config.json).', {
+                // In CI environments, since .sanity/blueprint.config.json is not guaranteed to exist, we can provide a more specific hint
+                const errorMessage = config.isCi
+                    ? 'set SANITY_PROJECT_ID or SANITY_ORGANIZATION_ID.'
+                    : 'provide --project-id or --organization-id, or run `blueprints init` to create a Blueprint config (.sanity/blueprint.config.json).';
+                this.error(`Missing scope: ${errorMessage}`, {
                     suggestions: [
                         `Run \`${this.config.bin} blueprints doctor\` to check your configuration.`,
                     ],
+                    ref: CI_SETUP_DOCS_URL,
                 });
             }
             this.scopeType = resolved.scopeType;
@@ -341,10 +348,14 @@ export class ResolvedCommand extends RuntimeCommand {
                 stackId = await resolveStackIdByNameOrId(stackOverride, auth, log);
             }
             if (!stackId) {
-                this.error(`Missing Stack: provide --stack, or set a Stack in your Blueprint config (\`${this.config.bin} blueprints config --edit\`).`, {
+                const errorMessage = config.isCi
+                    ? "couldn't determine which Stack to target. Set SANITY_BLUEPRINT_STACK_ID."
+                    : `provide --stack, or set a Stack in your Blueprint config (\`${this.config.bin} blueprints config --edit\`).`;
+                this.error(`Missing Stack: ${errorMessage}`, {
                     suggestions: [
                         `Run \`${this.config.bin} blueprints doctor\` to check your configuration.`,
                     ],
+                    ref: CI_SETUP_DOCS_URL,
                 });
             }
             this.stackId = stackId;

package/dist/commands/blueprints/init.js

@@ -11,9 +11,12 @@ export default class InitCommand extends RuntimeCommand {
 This is typically the first command you run in a new project. It creates a local Blueprint manifest file (sanity.blueprint.ts, .js, or .json) and provisions a new remote Stack.
 Additionally, a Blueprint configuration file is created in .sanity/ containing the scope and Stack IDs. This is .gitignored by default.
 
-After initialization, use 'blueprints plan' to preview changes, then 'blueprints deploy' to apply them.`;
+After initialization, use 'blueprints plan' to preview changes, then 'blueprints deploy' to apply them.
+
+Running without a directory prompts to confirm the current directory. Run 'blueprints init .' to initialize in the current directory without a prompt.`;
     static examples = [
         '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> .',
         '<%= config.bin %> <%= command.id %> [directory]',
         '<%= config.bin %> <%= command.id %> --blueprint-type <json|js|ts>',
         '<%= config.bin %> <%= command.id %> --organization-id <organizationId>',
@@ -25,7 +28,7 @@ After initialization, use 'blueprints plan' to preview changes, then 'blueprints
     ];
     static args = {
         dir: Args.string({
-            description: 'Directory to create the local Blueprint in',
+            description: 'Directory to create the local Blueprint in (defaults to the current directory)',
         }),
     };
     static flags = {

package/dist/config.d.ts

@@ -17,6 +17,7 @@ declare const _default: {
     isLive: boolean;
     apiUrl: string;
     populusApiUrl: string;
+    isCi: boolean;
     token: string | null;
 };
 export default _default;

package/dist/config.js

@@ -3,6 +3,7 @@ import { env } from 'node:process';
 import { fileURLToPath } from 'node:url';
 import * as pkg from 'empathic/package';
 import getToken from './utils/get-token.js';
+import isTrueish from './utils/isTrueish.js';
 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`.
@@ -29,7 +30,11 @@ const isTest = nodeEnv === 'test';
 const sanityEnv = env.SANITY_INTERNAL_ENV?.toLowerCase() ?? 'production';
 const sanityProd = sanityEnv === 'production';
 const isLive = sanityProd || sanityEnv === 'staging';
-const isPublishing = env?.PUBLISHING?.toLowerCase() === 'true';
+const isPublishing = isTrueish(env?.PUBLISHING);
+// https://github.com/sanity-io/cli/blob/adf90ea6691ee6c36849e426de9729533706f47f/packages/%40sanity/cli-core/src/util/isCi.ts
+const isCi = 
+// Travis CI, CircleCI, Gitlab CI, Appveyor, CodeShip, Travis CI, Jenkins, TeamCity
+isTrueish(env?.CI) || isTrueish(env?.CONTINUOUS_INTEGRATION) || isTrueish(env?.BUILD_NUMBER);
 const apiUrls = {
     production: 'https://api.sanity.io/',
     staging: 'https://api.sanity.work/',
@@ -74,6 +79,7 @@ export default {
     isLive,
     apiUrl,
     populusApiUrl,
+    isCi,
     get token() {
         return _token === undefined ? loadToken() : _token;
     },

package/dist/constants.d.ts

@@ -43,3 +43,4 @@ export declare const LABEL_MEDIA_LIBRARY_ASSET_UPDATE = "Media Library Asset Upd
 export declare const LABEL_MEDIA_LIBRARY_ASSET_DELETE = "Media Library Asset Delete";
 export declare const LABEL_SCHEDULED = "Scheduled";
 export declare const LABEL_SYNC_TAG_INVALIDATE = "Sync Tag Invalidate";
+export declare const CI_SETUP_DOCS_URL = "https://www.sanity.io/docs/blueprints/deploy-blueprints-from-ci";

package/dist/constants.js

@@ -48,3 +48,4 @@ export const LABEL_MEDIA_LIBRARY_ASSET_UPDATE = 'Media Library Asset Update';
 export const LABEL_MEDIA_LIBRARY_ASSET_DELETE = 'Media Library Asset Delete';
 export const LABEL_SCHEDULED = 'Scheduled';
 export const LABEL_SYNC_TAG_INVALIDATE = 'Sync Tag Invalidate';
+export const CI_SETUP_DOCS_URL = 'https://www.sanity.io/docs/blueprints/deploy-blueprints-from-ci';

package/dist/cores/blueprints/init.js

@@ -1,5 +1,6 @@
 import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
+import { cwd } from 'node:process';
 import { confirm } from '@inquirer/prompts';
 import { findBlueprintFile, readLocalBlueprint, writeBlueprintToDisk, } from '../../actions/blueprints/blueprint.js';
 import { writeConfigFile } from '../../actions/blueprints/config.js';
@@ -11,6 +12,7 @@ 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 { isInteractive } from '../../utils/interactive.js';
 import { styleText } from '../../utils/style-text.js';
 import { blueprintConfigCore } from './config.js';
 /** Derive scope type and ID from mutually exclusive flag values. */
@@ -25,8 +27,10 @@ export async function blueprintInitCore(options) {
     const { bin = 'sanity', log, token, knownProjectId, args, flags, validateResources } = options;
     const { dir: flagDir, example: flagExample, 'blueprint-type': flagBlueprintType, 'project-id': flagProjectId, 'organization-id': flagOrganizationId, 'stack-id': flagStackId, 'stack-name': flagStackName, verbose = false, } = flags;
     const { dir: argDir } = args;
-    const userProvidedDirName = argDir || flagDir;
-    const blueprintDir = userProvidedDirName || '.';
+    const explicitDir = argDir || flagDir;
+    const isHere = !explicitDir || explicitDir === '.' || explicitDir === './';
+    const blueprintDir = isHere ? '.' : explicitDir;
+    const userProvidedDirName = isHere ? undefined : explicitDir;
     const validationError = validateFlags({
         stackId: flagStackId,
         stackName: flagStackName,
@@ -65,6 +69,16 @@ 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.' };
+            }
+        }
         return handleFreshInitialization({
             blueprintDir,
             userProvidedDirName,

package/dist/cores/functions/test.js

@@ -8,6 +8,7 @@ import { resolveDeployedResources } from '../../utils/blueprints/resolve-deploye
 import buildPayload from '../../utils/functions/build-payload.js';
 import { fetchAsset, fetchDocument } from '../../utils/functions/fetch-document.js';
 import { findFunctionInResources, getFunctionNames } from '../../utils/functions/find.js';
+import { runFunction } from '../../utils/functions/invoke/nested.js';
 import { parseJsonObject } from '../../utils/parse-json-object.js';
 import { isEventType, } from '../../utils/types.js';
 export async function functionTestCore(options) {
@@ -146,12 +147,54 @@ export async function functionTestCore(options) {
             : {
                 event: 'scheduled',
             };
+        // Records each nested context.invoke() so they can be surfaced in order after the spinner resolves.
+        const nestedRuns = [];
+        let nestedOrder = 0;
+        /**
+         * Re-entrant callback that resolves a nested context.invoke(name, payload):
+         * it finds the named function in the same blueprint, reuses the already
+         * resolved resources, and runs it via the shared invoke-chain helper (which
+         * applies the depth/cycle guard and extends the call stack). Passing itself
+         * as onNestedInvoke keeps it recursable. Every run is recorded so it can be
+         * 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 order = ++nestedOrder;
+            const nestedResource = findFunctionInResources(blueprint.resources, nestedName);
+            const result = await runFunction(nestedResource, { payload: { data: nestedPayload }, event: 'nested' }, { ...ctx, resources: resolvedResources }, { depth, callStack, onNestedInvoke: runNested });
+            nestedRuns.push({ order, name: nestedName, logs: result.logs, error: result.error });
+            return result;
+        };
+        const logNestedRuns = () => {
+            for (const run of [...nestedRuns].sort((a, b) => a.order - b.order)) {
+                log(`↳ BEGIN: invoke('${run.name}')`);
+                // Show any logs received
+                if (run.logs?.trim()) {
+                    log(run.logs.trim());
+                }
+                // Before any error occurs
+                if (run.error) {
+                    log(run.error.stack || run.error.message || run.error.name);
+                }
+                log(`↳ END: invoke('${run.name}')`);
+            }
+        };
         const spinner = log.ora('Executing function...').start();
         const { json: response, logs, error, } = await testAction(resource, invokeOptions, contextOptions, {
             timeout: timeout ? timeout : resource.timeout,
+            onNestedInvoke: runNested,
+            depth: 0,
+            callStack: [fnName],
         });
         if (error) {
             spinner.fail('Function execution failed.');
+            // Surface the function's own logs even on failure
+            if (logs?.trim()) {
+                log('Logs:');
+                log(logs);
+            }
+            logNestedRuns();
             const errorMessage = error.stack || error.message || error.name;
             const isTimeout = error.message?.includes('Timeout');
             return {
@@ -166,6 +209,7 @@ export async function functionTestCore(options) {
         spinner.succeed('Function execution succeeded.');
         log('Logs:');
         log(logs || '');
+        logNestedRuns();
         if (response) {
             log('Response:');
             log(JSON.stringify(response, null, 2));

package/dist/server/app.js

@@ -1,7 +1,7 @@
 import { existsSync, readFileSync, watchFile } from 'node:fs';
 import * as http from 'node:http';
 import { default as mime } from 'mime-types';
-import { WebSocketServer } from 'ws';
+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';
@@ -10,6 +10,35 @@ import { isRecord } from '../utils/is-record.js';
 import { isEventType, isGroqContextOptions, } from '../utils/types.js';
 import { handleInvokeRequest } from './handlers/invoke.js';
 const app = (host, port, validateResources, executionOptions) => {
+    const wss = new WebSocketServer({ port: 8974 });
+    // Send a JSON envelope to every connected UI client.
+    const broadcast = (envelope) => {
+        const message = JSON.stringify(envelope);
+        for (const client of wss.clients) {
+            if (client.readyState === WebSocket.OPEN)
+                client.send(message);
+        }
+    };
+    let nestedOrder = 0;
+    /**
+     * Re-entrant callback that resolves a nested `context.invoke(name, payload)` by
+     * re-entering the invoke pipeline (which spawns its own child) and streams the
+     * nested run to the UI. Passing `nestedInvoke` to itself keeps it recursable.
+     */
+    const nestedInvoke = async (name, payload, ctx, depth, callStack) => {
+        const order = ++nestedOrder;
+        const result = await handleInvokeRequest(name, { data: payload }, { event: 'nested' }, ctx, validateResources, executionOptions, depth, callStack, nestedInvoke);
+        broadcast({
+            type: 'nested-invoke',
+            name,
+            order,
+            logs: result.logs,
+            json: result.json,
+            error: result.error,
+            timings: result.timings,
+        });
+        return result;
+    };
     const requestListener = async (req, res) => {
         res.setHeader('Content-Type', 'application/json');
         switch (true) {
@@ -50,7 +79,7 @@ const app = (host, port, validateResources, executionOptions) => {
                                     delete context.clientOptions.token;
                                 }
                             }
-                            const result = await handleInvokeRequest(functionName, event, metadata, context, validateResources, executionOptions);
+                            const result = await handleInvokeRequest(functionName, event, metadata, context, validateResources, executionOptions, 0, [], nestedInvoke);
                             // Add Server-Timing header
                             const timingHeaders = [];
                             for (const [key, value] of Object.entries(result.timings)) {
@@ -235,7 +264,6 @@ const app = (host, port, validateResources, executionOptions) => {
     };
     const server = http.createServer(requestListener);
     server.listen(port, host, () => { });
-    const wss = new WebSocketServer({ port: 8974 });
     wss.on('connection', function connection(ws) {
         ws.on('error', console.error);
         const fileInfo = findBlueprintFile();

package/dist/server/handlers/invoke.d.ts

@@ -1,4 +1,4 @@
-import type { InvocationResponse, InvokeContextOptions, InvokeExecutionOptions, InvokePayloadMetadata } from '../../utils/types.js';
-export declare function handleInvokeRequest(functionName: string, event: Record<string, unknown>, metadata: InvokePayloadMetadata, context: InvokeContextOptions, validateResources: boolean, executionOptions?: Partial<InvokeExecutionOptions>): Promise<InvocationResponse & {
+import type { InvocationResponse, InvokeContextOptions, InvokeExecutionOptions, InvokePayloadMetadata, NestedInvoke } from '../../utils/types.js';
+export declare function handleInvokeRequest(functionName: string, event: Record<string, unknown>, metadata: InvokePayloadMetadata, context: InvokeContextOptions, validateResources: boolean, executionOptions?: Partial<InvokeExecutionOptions>, depth?: number, callStack?: string[], onNestedInvoke?: NestedInvoke): Promise<InvocationResponse & {
     timings: Record<string, number>;
 }>;

package/dist/server/handlers/invoke.js

@@ -2,10 +2,10 @@ import { readLocalBlueprint } from '../../actions/blueprints/blueprint.js';
 import config from '../../config.js';
 import { resolveDeployedResources } from '../../utils/blueprints/resolve-deployed-resources.js';
 import { findFunctionInResources } from '../../utils/functions/find.js';
-import invoke from '../../utils/functions/invoke-local.js';
+import { runFunction } from '../../utils/functions/invoke/nested.js';
 import { Logger } from '../../utils/logger.js';
 const silentLogger = Logger(() => { });
-export async function handleInvokeRequest(functionName, event, metadata, context, validateResources, executionOptions) {
+export async function handleInvokeRequest(functionName, event, metadata, context, validateResources, executionOptions, depth = 0, callStack = [], onNestedInvoke) {
     const start = performance.now();
     const { resources, stackId, scopeType, scopeId } = await readLocalBlueprint(silentLogger, {
         resources: validateResources,
@@ -22,9 +22,12 @@ export async function handleInvokeRequest(functionName, event, metadata, context
         payload: event,
         ...metadata,
     };
-    const response = await invoke(resource, payload, { ...context, resources: resolvedResources }, {
+    const response = await runFunction(resource, payload, { ...context, resources: resolvedResources }, {
         forceColor: executionOptions?.forceColor ?? false,
-        timeout: executionOptions?.timeout ?? resource.timeout,
+        timeout: executionOptions?.timeout,
+        depth,
+        callStack,
+        onNestedInvoke,
     });
     const timings = { ...response.timings, 'blueprint:read': readBlueprintTime };
     return { ...response, timings };