@sanity/runtime-cli 17.7.1 → 17.8.0

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.7.1/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/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.7.1/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/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.7.1/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/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.7.1/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/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.7.1/src/commands/blueprints/doctor.ts)_
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/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.7.1/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/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.7.1/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/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.7.1/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/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.7.1/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.8.0/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.7.1/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/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.7.1/src/commands/blueprints/promote.ts)_
+_See code: [src/commands/blueprints/promote.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/src/commands/blueprints/promote.ts)_
 
 ## `sanity-run blueprints stacks`
 
@@ -551,7 +551,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.7.1/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/src/commands/blueprints/stacks.ts)_
 
 ## `sanity-run functions add`
 
@@ -603,7 +603,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.7.1/src/commands/functions/add.ts)_
+_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/src/commands/functions/add.ts)_
 
 ## `sanity-run functions dev`
 
@@ -638,7 +638,7 @@ EXAMPLES
   $ sanity-run functions dev --timeout 60
 ```
 
-_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v17.7.1/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/src/commands/functions/dev.ts)_
 
 ## `sanity-run functions env add NAME KEY VALUE`
 
@@ -671,7 +671,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.7.1/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/src/commands/functions/env/add.ts)_
 
 ## `sanity-run functions env list NAME`
 
@@ -701,7 +701,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.7.1/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/src/commands/functions/env/list.ts)_
 
 ## `sanity-run functions env remove NAME KEY`
 
@@ -733,7 +733,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.7.1/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/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.7.1/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/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.7.1/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 

package/dist/constants.d.ts

@@ -1,3 +1,4 @@
+import type { DurableStepPhase } from './utils/types.js';
 export declare const SANITY_ACCESS_ROLE = "sanity.access.role";
 export declare const SANITY_ACCESS_ROBOT = "sanity.access.robot";
 export declare const SANITY_FUNCTION_PREFIX = "sanity.function.";
@@ -50,3 +51,4 @@ export declare const LABEL_PUBSUB = "PubSub";
 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";
+export declare const STEP_PHASE_GLYPH: Record<DurableStepPhase, string>;

package/dist/constants.js

@@ -56,3 +56,8 @@ export const LABEL_PUBSUB = 'PubSub';
 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';
+export const STEP_PHASE_GLYPH = {
+    start: '▶',
+    complete: '✔',
+    error: '✖',
+};

package/dist/cores/functions/test.js

@@ -3,7 +3,7 @@ import { dirname, join } from 'node:path';
 import { cwd } from 'node:process';
 import { testAction } from '../../actions/functions/test.js';
 import config from '../../config.js';
-import { SANITY_FUNCTION_DOCUMENT, SANITY_FUNCTION_MEDIA_LIBRARY_ASSET } from '../../constants.js';
+import { SANITY_FUNCTION_DOCUMENT, SANITY_FUNCTION_DURABLE, SANITY_FUNCTION_MEDIA_LIBRARY_ASSET, STEP_PHASE_GLYPH, } from '../../constants.js';
 import { resolveDeployedResources } from '../../utils/blueprints/resolve-deployed-resources.js';
 import buildPayload from '../../utils/functions/build-payload.js';
 import { fetchAsset, fetchDocument } from '../../utils/functions/fetch-document.js';
@@ -11,6 +11,20 @@ import { findFunctionInResources, getFunctionNames } from '../../utils/functions
 import { runFunction } from '../../utils/functions/invoke/nested.js';
 import { parseJsonObject } from '../../utils/parse-json-object.js';
 import { isEventType, } from '../../utils/types.js';
+/**
+ * CLI lines for a durable run, in emission order; bare `start` events dropped.
+ * @param events
+ */
+function renderStepTimeline(events) {
+    return events
+        .filter((event) => event.phase !== 'start')
+        .map((event) => {
+        const glyph = STEP_PHASE_GLYPH[event.phase] ?? '•';
+        const duration = typeof event.durationMs === 'number' ? ` (${Math.round(event.durationMs)}ms)` : '';
+        const detail = event.phase === 'error' && event.error ? ` ${event.error.message}` : '';
+        return `  ${glyph} ${event.name} [${event.kind}]${duration}${detail}`;
+    });
+}
 export async function functionTestCore(options) {
     const { blueprint, log, error, args, flags, helpText } = options;
     const { name: fnName } = args;
@@ -42,6 +56,7 @@ export async function functionTestCore(options) {
         const resource = findFunctionInResources(blueprint.resources, fnName); // throws if not found
         const docFunction = resource.type === SANITY_FUNCTION_DOCUMENT;
         const mediaFunction = resource.type === SANITY_FUNCTION_MEDIA_LIBRARY_ASSET;
+        const durableFunction = resource.type === SANITY_FUNCTION_DURABLE;
         const resolvedResources = await resolveDeployedResources({
             resources: blueprint.resources,
             stackId: blueprint.stackId,
@@ -51,7 +66,10 @@ export async function functionTestCore(options) {
             logger: log,
         });
         const blueprintFileDir = dirname(blueprint.fileInfo.blueprintFilePath);
-        const contextOptions = docFunction || mediaFunction
+        const isMediaSource = mediaFunction || (durableFunction && resource.event?.type === 'media-library');
+        const eventResourceType = isMediaSource ? 'media-library' : 'dataset';
+        const eventResourceId = (isMediaSource ? mediaLibraryId : `${projectId}.${dataset}`) || '';
+        const contextOptions = docFunction || mediaFunction || durableFunction
             ? {
                 clientOptions: {
                     apiVersion: api,
@@ -59,8 +77,8 @@ export async function functionTestCore(options) {
                     projectId,
                     organizationId,
                 },
-                eventResourceType: docFunction ? 'dataset' : 'media-library',
-                eventResourceId: (docFunction ? `${projectId}.${dataset}` : mediaLibraryId) || '',
+                eventResourceType,
+                eventResourceId,
                 functionResourceType: 'project',
                 functionResourceId: projectId || '',
                 resources: resolvedResources,
@@ -139,19 +157,22 @@ export async function functionTestCore(options) {
                 payload = buildPayload({ data, file });
             }
         }
-        const invokeOptions = docFunction || mediaFunction
-            ? {
-                event: eventType,
-                payload,
-                before,
-                after,
-            }
-            : {
-                event: 'scheduled',
-            };
+        let invokeOptions;
+        if (docFunction || mediaFunction) {
+            invokeOptions = { event: eventType, payload, before, after };
+        }
+        else {
+            invokeOptions = { event: durableFunction ? 'durable' : 'scheduled', payload: { data: payload } };
+        }
         // Records each nested context.invoke() so they can be surfaced in order after the spinner resolves.
         const nestedRuns = [];
         let nestedOrder = 0;
+        const stepEvents = [];
+        const onStepEvent = durableFunction
+            ? (event) => {
+                stepEvents.push(event);
+            }
+            : undefined;
         /**
          * Re-entrant callback that resolves a nested context.invoke(name, payload):
          * it finds the named function in the same blueprint, reuses the already
@@ -188,6 +209,7 @@ export async function functionTestCore(options) {
             onNestedInvoke: runNested,
             depth: 0,
             callStack: [fnName],
+            onStepEvent,
         });
         if (error) {
             spinner.fail('Function execution failed.');
@@ -199,6 +221,12 @@ export async function functionTestCore(options) {
             logNestedRuns();
             const errorMessage = error.stack || error.message || error.name;
             const isTimeout = error.message?.includes('Timeout');
+            if (durableFunction && stepEvents.length > 0) {
+                log('Steps:');
+                for (const line of renderStepTimeline(stepEvents)) {
+                    log(line);
+                }
+            }
             return {
                 success: false,
                 error: errorMessage,
@@ -216,6 +244,12 @@ export async function functionTestCore(options) {
             log('Response:');
             log(JSON.stringify(response, null, 2));
         }
+        if (durableFunction && stepEvents.length > 0) {
+            log('Steps:');
+            for (const line of renderStepTimeline(stepEvents)) {
+                log(line);
+            }
+        }
         return { success: true, json: { response, logs } };
     }
     catch (error) {

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

@@ -3,6 +3,7 @@ import {isAbsolute, join} from 'node:path'
 import process from 'node:process'
 import {pathToFileURL} from 'node:url'
 import {installConsole} from './child-runtime/console.js'
+import {runDurable} from './child-runtime/durable.js'
 import {createInvoker} from './child-runtime/invoke.js'
 import {createResourcesApi} from './child-runtime/resources.js'
 
@@ -40,7 +41,7 @@ process.on('message', async (data) => {
 
   // Otherwise this is the initial start message. Support the legacy untyped
   // `{srcPath, payload}` shape as well as the new `{type: 'start', ...}`.
-  const {srcPath, payload} = jsonData
+  const {srcPath, payload, isDurable} = jsonData
   const {context, ...event} = payload
 
   let logs = ''
@@ -78,11 +79,22 @@ process.on('message', async (data) => {
 
     // Allow the handler to invoke other blueprint functions by name.
     context.invoke = invoker.invoke
-    json = await handler({
-      context,
-      event,
-      done: async () => new Response(null, {status: 204}),
-    })
+
+    if (isDurable) {
+      json = await runDurable(
+        handler,
+        {context, event, logger: console},
+        {
+          emit: (e) => process.send(JSON.stringify({type: 'step-event', event: e})),
+        },
+      )
+    } else {
+      json = await handler({
+        context,
+        event,
+        done: async () => new Response(null, {status: 204}),
+      })
+    }
 
     // Restore streams
     process.stdout.write = originalStdoutWrite

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

@@ -0,0 +1,18 @@
+import type {DurableContext, DurableHandler, DurableLogger, GenericEvent} from '@sanity/functions'
+import type {DurableStepEvent} from '../../types.js'
+
+type RunDurableArgs = {
+  context: DurableContext
+  event: GenericEvent
+  logger: DurableLogger
+}
+
+type DurableIO = {
+  emit: (event: DurableStepEvent) => void
+}
+
+export function runDurable(
+  handler: DurableHandler,
+  args: RunDurableArgs,
+  io: DurableIO,
+): Promise<unknown>

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

@@ -0,0 +1,46 @@
+import {performance} from 'node:perf_hooks'
+
+/**
+ * Runs a durable function handler
+ * @param handler - callback being run
+ * @param context - data to send to the operation
+ * @param event - the step being run
+ * @param logger
+ * @param io
+ */
+export async function runDurable(handler, {context, event, logger}, io) {
+  const track = async (name, kind, produce) => {
+    io.emit({name, kind, phase: 'start'})
+    const startedAt = performance.now()
+    try {
+      const value = await produce()
+      io.emit({
+        name,
+        kind,
+        phase: 'complete',
+        output: value,
+        durationMs: performance.now() - startedAt,
+      })
+      return value
+    } catch (err) {
+      io.emit({
+        name,
+        kind,
+        phase: 'error',
+        error: {
+          name: err?.name ?? 'Error',
+          message: err?.message ?? String(err),
+          stack: err?.stack ?? '',
+        },
+        durationMs: performance.now() - startedAt,
+      })
+      throw err
+    }
+  }
+
+  const step = {
+    run: ({name, handler: fn}) => track(name, 'run', () => fn({logger, attempt: 1})),
+  }
+
+  return handler({context, event, step, logger})
+}

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

@@ -5,6 +5,7 @@ import { setTimeout } from 'node:timers';
 import { fileURLToPath } from 'node:url';
 import * as groq from 'groq-js';
 import config from '../../../config.js';
+import { SANITY_FUNCTION_DURABLE } from '../../../constants.js';
 import { groupBlueprintResources } from '../../blueprints/group-resources.js';
 import { isGroqContextOptions, } from '../../types.js';
 import { acquireFunctionBuild } from './prepare.js';
@@ -42,7 +43,7 @@ export default async function invoke(resource, payload, context, options) {
     if (!resource.src) {
         throw new Error(`Function resource "${resource.name}" is missing the 'src' property.`);
     }
-    const { forceColor = true, timeout = 10, onNestedInvoke, depth = 0, callStack = [] } = options;
+    const { forceColor = true, timeout = 10, onNestedInvoke, depth = 0, callStack = [], onStepEvent = () => { }, } = options;
     // Apply the GROQ rule before preparing a build so a filtered-out event skips
     // the (potentially expensive) transpile entirely.
     let filteredData = payload?.payload?.data || {};
@@ -208,6 +209,10 @@ export default async function invoke(resource, payload, context, options) {
                 catch {
                     return;
                 }
+                if (msg?.type === 'step-event') {
+                    onStepEvent(msg.event);
+                    return;
+                }
                 // Nested invoke request — handle without tearing down the child.
                 if (msg?.type === 'invoke-request') {
                     handleNestedInvoke({ id: msg.id, name: msg.name, payload: msg.payload });
@@ -289,7 +294,12 @@ export default async function invoke(resource, payload, context, options) {
                     }),
                 },
             };
-            const startMessage = { type: 'start', srcPath: functionPath, payload };
+            const startMessage = {
+                type: 'start',
+                srcPath: functionPath,
+                payload,
+                isDurable: resource.type === SANITY_FUNCTION_DURABLE,
+            };
             child.send(JSON.stringify(startMessage));
         }
         function shutdown() {

package/dist/utils/progress.js

@@ -2,6 +2,9 @@ import { stderr } from 'node:process';
 import { onExit } from 'signal-exit';
 const ST = '\x1b\\';
 export const HEARTBEAT_INTERVAL_MS = 5_000;
+// Ora clobbers stderr.write and messes with OSC output.
+// Keep the original writer so progress sequences do not collide.
+const writeToStderr = stderr.write.bind(stderr);
 const STATES = {
     clear: 0,
     normal: 1,
@@ -24,7 +27,7 @@ function startHeartbeat(sequence) {
         return;
     heartbeat = setInterval(() => {
         if (stderr.isTTY && heartbeatSequence)
-            stderr.write(heartbeatSequence);
+            writeToStderr(heartbeatSequence);
     }, HEARTBEAT_INTERVAL_MS);
     heartbeat.unref();
 }
@@ -37,7 +40,7 @@ function write(state, value = 0) {
         exitHookRegistered = true;
         function clear() {
             stopHeartbeat();
-            stderr.write(`\x1b]9;4;0;0${ST}`);
+            writeToStderr(`\x1b]9;4;0;0${ST}`);
         }
         // arc/utils SIGINT handler clobbers our signal-exit; luckily it then calls process.exit()
         process.once('exit', clear); // triggered by arc/utils SIGINT handler
@@ -47,7 +50,7 @@ function write(state, value = 0) {
     const active = state === 'normal' || state === 'paused' || state === 'busy';
     if (!active)
         stopHeartbeat();
-    stderr.write(sequence);
+    writeToStderr(sequence);
     if (active)
         startHeartbeat(sequence);
 }

package/dist/utils/types.d.ts

@@ -111,7 +111,7 @@ export interface InvokeNonGroqPayloadOptions {
 export type InvokePayloadOptions = InvokeGroqPayloadOptions | InvokeNonGroqPayloadOptions;
 export type InvokePayloadMetadata = Pick<InvokeGroqPayloadOptions, 'event' | 'before' | 'after'> | Pick<InvokeNonGroqPayloadOptions, 'event'>;
 export type EventType = 'create' | 'update' | 'delete';
-export type NonGroqEventType = 'scheduled' | 'nested';
+export type NonGroqEventType = 'scheduled' | 'nested' | 'durable';
 export declare function isEventType(arg: string): arg is EventType;
 /** @internal */
 export interface InvokeGroqContextOptions {
@@ -161,6 +161,8 @@ export interface InvokeExecutionOptions {
     depth?: number;
     /** Function names already on the invoke call stack (innermost last), used to detect cycles. @internal */
     callStack?: string[];
+    /** Stream a durable step transition to the caller. @internal */
+    onStepEvent?: (event: DurableStepEvent) => void;
 }
 /**
  * Re-entrant callback that executes a named function from the blueprint on behalf
@@ -178,6 +180,7 @@ export type ParentToChildMessage = {
     type: 'start';
     srcPath: string;
     payload: unknown;
+    isDurable?: boolean;
 } | {
     type: 'invoke-response';
     id: string;
@@ -190,6 +193,9 @@ export type ParentToChildMessage = {
     id: string;
     ok: false;
     error: InvocationError;
+} | {
+    type: 'step-event';
+    event: DurableStepEvent;
 };
 /**
  * IPC messages sent from a function child process back up to the parent.
@@ -202,12 +208,16 @@ export type ChildToParentMessage = {
     id: string;
     name: string;
     payload: Record<string, unknown>;
+    isDurable?: boolean;
 } | {
     type: 'result';
     json?: JsonInvocationResponse;
     logs?: string;
     errorLogs?: string;
     error?: InvocationError;
+} | {
+    type: 'step-event';
+    event: DurableStepEvent;
 };
 /** @internal */
 export interface InvocationResponse {
@@ -290,4 +300,19 @@ export type Warning = {
     code: string;
     suggestions: string[];
 };
+/** @internal */
+export type DurableOperationSteps = 'run';
+/** @internal */
+export type DurableStepPhase = 'start' | 'complete' | 'error';
+/**
+ * Represents a single step in a durable operation
+ */
+export interface DurableStepEvent {
+    name: string;
+    kind: DurableOperationSteps;
+    phase: DurableStepPhase;
+    output?: unknown;
+    error?: InvocationError;
+    durationMs?: number;
+}
 export {};

package/oclif.manifest.json

@@ -3127,5 +3127,5 @@
       ]
     }
   },
-  "version": "17.7.1"
+  "version": "17.8.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sanity/runtime-cli",
   "description": "Sanity's Runtime CLI for Blueprints and Functions",
-  "version": "17.7.1",
+  "version": "17.8.0",
   "author": "Sanity Runtime Team",
   "type": "module",
   "license": "MIT",