@sanity/runtime-cli 17.0.0 → 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/17.0.0 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/v17.0.0/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/v17.0.0/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/v17.0.0/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/v17.0.0/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/v17.0.0/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/v17.0.0/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]`
 
@@ -364,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/v17.0.0/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`
 
@@ -410,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/v17.0.0/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`
 
@@ -455,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/v17.0.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.1.0-next.g3cb2d2e/src/commands/blueprints/mint-deploy-token.ts)_
 
 ## `sanity-run blueprints plan`
 
@@ -488,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/v17.0.0/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`
 
@@ -524,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/v17.0.0/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`
 
@@ -560,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/v17.0.0/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`
 
@@ -612,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/v17.0.0/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`
 
@@ -647,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/v17.0.0/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`
 
@@ -677,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/v17.0.0/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`
 
@@ -704,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/v17.0.0/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`
 
@@ -733,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/v17.0.0/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]`
 
@@ -773,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/v17.0.0/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]`
 
@@ -830,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/v17.0.0/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]`
 
@@ -850,5 +850,5 @@ DESCRIPTION
   Display help for sanity-run.
 ```
 
-_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/6.2.50/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/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/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 };

package/dist/server/static/components/console-panel.js

@@ -1,4 +1,4 @@
-/* globals customElements document */
+/* globals customElements document window */
 import {ApiBaseElement} from './api-base.js'
 import {getSharedStyleSheets} from './shared-styles.js'
 
@@ -36,6 +36,16 @@ template.innerHTML = `
 `
 
 class ConsolePanel extends ApiBaseElement {
+  /**
+   * Nested context.invoke() output for the current run, kept as a list so the
+   * final render can order it by call order. Nested runs finish innermost-first
+   * (A → B → C resolves C then B), so each carries an `order` stamped when it was
+   * initiated; the final render sorts by it. Buffered separately so it survives
+   * the result render, which would otherwise overwrite the console when Preserve
+   * Log is off.
+   */
+  nestedEntries = []
+
   constructor() {
     super()
     this.attachShadow({mode: 'open'}).appendChild(template.content.cloneNode(true))
@@ -45,25 +55,59 @@ class ConsolePanel extends ApiBaseElement {
     if (!this.consoleOutput || !result) return
 
     const {error, logs} = result
-    let update = ''
+    // Always show the logs. Then append the error, rather than replacing the logs with it.
+    let update = logs ?? ''
     if (error) {
-      // Display error details in the console
-      update = (error.stack || error.message || error.name) ?? 'An error occurred.'
-    } else {
-      // Display regular logs
-      update = logs ?? '' // Handle case where logs might be null/undefined
+      const errText = (error.stack || error.message || error.name) ?? 'An error occurred.'
+      update = update.trim() ? `${update.trimEnd()}\n${errText}` : errText
     }
 
     if (this.api.store.preserveLog) {
+      // Nested output was already appended live during the run; keep it in place.
       this.consoleOutput.innerText = this.consoleOutput.innerText + update
     } else {
-      this.consoleOutput.innerText = update
+      // Re-render so the nested output is shown in call order rather than the
+      // completion order it streamed in (and so it survives this overwrite).
+      this.consoleOutput.innerText = update + this.renderNestedEntries()
+    }
+  }
+
+  // Join the nested runs in call order (the order they were initiated).
+  renderNestedEntries = () =>
+    [...this.nestedEntries]
+      .sort((a, b) => a.order - b.order)
+      .map((e) => e.text)
+      .join('')
+
+  updateNested = (event) => {
+    const nestedInvoke = event.detail
+    if (!this.consoleOutput || !nestedInvoke) return
+
+    const {name, order, logs, json, error} = nestedInvoke
+    // Always show the logs. Then append the error, rather than replacing the logs with it.
+    let body = logs ?? ''
+    if (error) {
+      const errText = (error.stack || error.message || error.name) ?? 'An error occurred.'
+      body = body.trim() ? `${body.trimEnd()}\n${errText}` : errText
+    } else if (typeof json !== 'undefined') {
+      body += `${body && !body.endsWith('\n') ? '\n' : ''}→ returned ${JSON.stringify(json)}\n`
     }
+
+    const text = `↳ BEGIN: invoke('${name}')\n${body.trim()}\n↳ END: invoke('${name}')\n`
+    this.nestedEntries.push({order, text})
+    // Append live for immediate feedback; the final result render reorders.
+    this.consoleOutput.innerText = this.consoleOutput.innerText + text
+  }
+
+  // A new invocation is starting; drop the previous run's nested output.
+  resetNested = ({inprogress}) => {
+    if (inprogress) this.nestedEntries = []
   }
 
   clear = () => {
     const backUp = this.api.store.preserveLog
     this.api.store.result = {logs: undefined, error: undefined}
+    this.nestedEntries = []
     this.consoleOutput.innerText = ''
     this.api.store.preserveLog = backUp
   }
@@ -75,9 +119,14 @@ class ConsolePanel extends ApiBaseElement {
     this.consoleOutput = this.shadowRoot.querySelector('#console-output')
     this.addEventListener('clear-console', this.clear)
 
+    // Nested context.invoke() runs arrive as a stream of discrete DOM events
+    // (not state) so none are dropped when several land in one frame.
+    window.addEventListener('nested-invoke', this.updateNested)
+
     // Subscribe to changes in the result state to update the console
     if (this.api) {
       this.api.subscribe(this.updateConsole, ['result'])
+      this.api.subscribe(this.resetNested, ['inprogress'])
       // Initial update in case result is already populated
       if (this.api.store.result) {
         this.updateConsole({result: this.api.store.result})
@@ -90,9 +139,11 @@ class ConsolePanel extends ApiBaseElement {
 
   disconnectedCallback() {
     this.removeEventListener('clear-console', this.clear)
+    window.removeEventListener('nested-invoke', this.updateNested)
     // Unsubscribe when the element is removed from the DOM
     if (this.api) {
       this.api.unsubscribe(this.updateConsole)
+      this.api.unsubscribe(this.resetNested)
     }
   }
 }

package/dist/server/static/components/rule-panel.js

@@ -43,14 +43,17 @@ class RulePanel extends ApiBaseElement {
         break
     }
 
-    const transaction = rule.state.update({
-      changes: {
-        from: 0,
-        insert: func.event ? JSON.stringify(func.event, null, 2) : '',
-        to: rule.state.doc.length,
-      },
-    })
-    rule.dispatch(transaction)
+    // Guard against the sate not being setup
+    if (rule?.state) {
+      const transaction = rule.state.update({
+        changes: {
+          from: 0,
+          insert: func.event ? JSON.stringify(func.event, null, 2) : '',
+          to: rule.state.doc.length,
+        },
+      })
+      rule.dispatch(transaction)
+    }
   }
 
   async connectedCallback() {

package/dist/server/static/components/shared-styles.js

@@ -1,31 +1,34 @@
 /* globals fetch */
 
-let cachedStyleSheets = null
+let sharedStyleSheetsPromise = null
 
-export async function getSharedStyleSheets() {
-  if (cachedStyleSheets) {
-    return cachedStyleSheets
-  }
+async function loadSharedStyleSheets() {
+  // Fetch both stylesheets
+  const [mCssResponse, appCssResponse] = await Promise.all([
+    fetch('./vendor/m-.css'),
+    fetch('./components/app.css'),
+  ])
 
-  try {
-    // Fetch both stylesheets
-    const [mCssResponse, appCssResponse] = await Promise.all([
-      fetch('./vendor/m-.css'),
-      fetch('./components/app.css'),
-    ])
+  const [mCssText, appCssText] = await Promise.all([mCssResponse.text(), appCssResponse.text()])
 
-    const [mCssText, appCssText] = await Promise.all([mCssResponse.text(), appCssResponse.text()])
+  // Create CSSStyleSheet objects
+  const mSheet = new CSSStyleSheet()
+  const appSheet = new CSSStyleSheet()
 
-    // Create CSSStyleSheet objects
-    const mSheet = new CSSStyleSheet()
-    const appSheet = new CSSStyleSheet()
+  await Promise.all([mSheet.replace(mCssText), appSheet.replace(appCssText)])
 
-    await Promise.all([mSheet.replace(mCssText), appSheet.replace(appCssText)])
+  return [mSheet, appSheet]
+}
 
-    cachedStyleSheets = [mSheet, appSheet]
-    return cachedStyleSheets
-  } catch (error) {
-    console.error('Failed to load shared stylesheets:', error)
-    return []
+export function getSharedStyleSheets() {
+  if (!sharedStyleSheetsPromise) {
+    sharedStyleSheetsPromise = loadSharedStyleSheets().catch((error) => {
+      console.error('Failed to load shared stylesheets:', error)
+      // Reset so a later caller can retry instead of being stuck with [].
+      sharedStyleSheetsPromise = null
+      return []
+    })
   }
+
+  return sharedStyleSheetsPromise
 }