@sanity/runtime-cli 17.15.0-next.gd07e8fe → 17.15.0-next.ge190195

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-next.gd07e8fe/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0-next.ge190195/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-next.gd07e8fe/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0-next.ge190195/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-next.gd07e8fe/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0-next.ge190195/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-next.gd07e8fe/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0-next.ge190195/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-next.gd07e8fe/src/commands/blueprints/doctor.ts)_
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0-next.ge190195/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-next.gd07e8fe/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0-next.ge190195/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-next.gd07e8fe/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0-next.ge190195/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-next.gd07e8fe/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0-next.ge190195/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-next.gd07e8fe/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.15.0-next.ge190195/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-next.gd07e8fe/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0-next.ge190195/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-next.gd07e8fe/src/commands/blueprints/promote.ts)_
+_See code: [src/commands/blueprints/promote.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0-next.ge190195/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-next.gd07e8fe/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0-next.ge190195/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-next.gd07e8fe/src/commands/functions/add.ts)_
+_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0-next.ge190195/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-next.gd07e8fe/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0-next.ge190195/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-next.gd07e8fe/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0-next.ge190195/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-next.gd07e8fe/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0-next.ge190195/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-next.gd07e8fe/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0-next.ge190195/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-next.gd07e8fe/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0-next.ge190195/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-next.gd07e8fe/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v17.15.0-next.ge190195/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 

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/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/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;