@sanity/runtime-cli 13.0.2 → 13.1.0

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g @sanity/runtime-cli
 $ sanity-run COMMAND
 running command...
 $ sanity-run (--version)
-@sanity/runtime-cli/13.0.2 linux-x64 node-v24.12.0
+@sanity/runtime-cli/13.1.0 linux-x64 node-v24.13.0
 $ sanity-run --help [COMMAND]
 USAGE
   $ sanity-run COMMAND
@@ -98,7 +98,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/v13.0.2/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v13.1.0/src/commands/blueprints/add.ts)_
 
 ## `sanity-run blueprints config`
 
@@ -106,13 +106,12 @@ View or edit the local Blueprint configuration
 
 ```
 USAGE
-  $ sanity-run blueprints config [--project-id <value> -e] [--organization-id <value> ] [--stack-id <value> ]
+  $ sanity-run blueprints config [--project-id <value> -e] [--stack-id <value> ]
 
 FLAGS
-  -e, --edit                     Modify the configuration interactively, or directly when combined with ID flags.
-      --organization-id=<value>  Directly set the organization ID in the configuration. Requires --edit flag
-      --project-id=<value>       Directly set the project ID in the configuration. Requires --edit flag
-      --stack-id=<value>         Directly set the Stack ID in the configuration. Requires --edit flag
+  -e, --edit                Modify the configuration interactively, or directly when combined with ID flags.
+      --project-id=<value>  Directly set the project ID in the configuration. Requires --edit flag
+      --stack-id=<value>    Directly set the Stack ID in the configuration. Requires --edit flag
 
 DESCRIPTION
   View or edit the local Blueprint configuration
@@ -134,7 +133,7 @@ EXAMPLES
   $ sanity-run blueprints config --edit --project-id <projectId> --stack-id <stackId>
 ```
 
-_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v13.0.2/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v13.1.0/src/commands/blueprints/config.ts)_
 
 ## `sanity-run blueprints deploy`
 
@@ -164,7 +163,7 @@ EXAMPLES
   $ sanity-run blueprints deploy --no-wait
 ```
 
-_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v13.0.2/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v13.1.0/src/commands/blueprints/deploy.ts)_
 
 ## `sanity-run blueprints destroy`
 
@@ -172,15 +171,13 @@ Destroy the remote Stack deployment and its resources (will not delete local fil
 
 ```
 USAGE
-  $ sanity-run blueprints destroy [--project-id <value> --stack-id <value> --force] [--organization-id <value>  ]
-    [--no-wait]
+  $ sanity-run blueprints destroy [--project-id <value> --stack-id <value> --force] [--no-wait]
 
 FLAGS
-  --force                    Force Stack destruction (skip confirmation)
-  --no-wait                  Do not wait for Stack destruction to complete
-  --organization-id=<value>  Organization associated with the Stack
-  --project-id=<value>       Project associated with the Stack
-  --stack-id=<value>         Stack ID to destroy (defaults to current Stack)
+  --force               Force Stack destruction (skip confirmation)
+  --no-wait             Do not wait for Stack destruction to complete
+  --project-id=<value>  Project associated with the Stack
+  --stack-id=<value>    Stack ID to destroy (defaults to current Stack)
 
 DESCRIPTION
   Destroy the remote Stack deployment and its resources (will not delete local files)
@@ -198,7 +195,7 @@ EXAMPLES
   $ sanity-run blueprints destroy --stack-id <stackId> --project-id <projectId> --force --no-wait
 ```
 
-_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v13.0.2/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v13.1.0/src/commands/blueprints/destroy.ts)_
 
 ## `sanity-run blueprints doctor`
 
@@ -224,7 +221,7 @@ DESCRIPTION
   issues.
 ```
 
-_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v13.0.2/src/commands/blueprints/doctor.ts)_
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v13.1.0/src/commands/blueprints/doctor.ts)_
 
 ## `sanity-run blueprints info`
 
@@ -254,7 +251,7 @@ EXAMPLES
   $ sanity-run blueprints info --id <stackId>
 ```
 
-_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v13.0.2/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v13.1.0/src/commands/blueprints/info.ts)_
 
 ## `sanity-run blueprints init [DIR]`
 
@@ -263,7 +260,7 @@ Initialize a local Blueprint and optionally provision a remote Stack deployment
 ```
 USAGE
   $ sanity-run blueprints init [DIR] [--verbose] [--dir <value>] [--example <value> | --blueprint-type json|js|ts |
-    --stack-id <value> | --stack-name <value>] [--project-id <value>] [--organization-id <value>]
+    --stack-id <value> | --stack-name <value>] [--project-id <value>]
 
 ARGUMENTS
   [DIR]  Directory to create the local Blueprint in
@@ -273,7 +270,6 @@ FLAGS
                              <options: json|js|ts>
   --dir=<value>              Directory to create the local Blueprint in
   --example=<value>          Example to use for the local Blueprint
-  --organization-id=<value>  Sanity organization ID used to scope local Blueprint and remote Stack
   --project-id=<value>       Sanity project ID used to scope local Blueprint and remote Stack
   --stack-id=<value>         Existing Stack ID used to scope local Blueprint
   --stack-name=<value>       Name to use for a new Stack provisioned during initialization
@@ -305,7 +301,7 @@ EXAMPLES
   $ sanity-run blueprints init --blueprint-type <json|js|ts> --stack-name <stackName>
 ```
 
-_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v13.0.2/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v13.1.0/src/commands/blueprints/init.ts)_
 
 ## `sanity-run blueprints logs`
 
@@ -333,7 +329,7 @@ EXAMPLES
   $ sanity-run blueprints logs --watch
 ```
 
-_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v13.0.2/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v13.1.0/src/commands/blueprints/logs.ts)_
 
 ## `sanity-run blueprints plan`
 
@@ -356,7 +352,7 @@ EXAMPLES
   $ sanity-run blueprints plan
 ```
 
-_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v13.0.2/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v13.1.0/src/commands/blueprints/plan.ts)_
 
 ## `sanity-run blueprints stacks`
 
@@ -364,11 +360,10 @@ List all remote Stack deployments (defaults to the current Blueprint's project s
 
 ```
 USAGE
-  $ sanity-run blueprints stacks [--project-id <value> | --organization-id <value>]
+  $ sanity-run blueprints stacks [--project-id <value> | ]
 
 FLAGS
-  --organization-id=<value>  Organization ID to show Stack deployments for
-  --project-id=<value>       Project ID to show Stack deployments for
+  --project-id=<value>  Project ID to show Stack deployments for
 
 DESCRIPTION
   List all remote Stack deployments (defaults to the current Blueprint's project scope)
@@ -386,7 +381,7 @@ EXAMPLES
   $ sanity-run blueprints stacks --organization-id <organizationId>
 ```
 
-_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v13.0.2/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v13.1.0/src/commands/blueprints/stacks.ts)_
 
 ## `sanity-run functions add`
 
@@ -435,7 +430,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/v13.0.2/src/commands/functions/add.ts)_
+_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v13.1.0/src/commands/functions/add.ts)_
 
 ## `sanity-run functions dev`
 
@@ -469,7 +464,7 @@ EXAMPLES
   $ sanity-run functions dev --timeout 60
 ```
 
-_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v13.0.2/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v13.1.0/src/commands/functions/dev.ts)_
 
 ## `sanity-run functions env add NAME KEY VALUE`
 
@@ -496,7 +491,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/v13.0.2/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v13.1.0/src/commands/functions/env/add.ts)_
 
 ## `sanity-run functions env list NAME`
 
@@ -520,7 +515,7 @@ EXAMPLES
   $ sanity-run functions env list MyFunction
 ```
 
-_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v13.0.2/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v13.1.0/src/commands/functions/env/list.ts)_
 
 ## `sanity-run functions env remove NAME KEY`
 
@@ -546,7 +541,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/v13.0.2/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v13.1.0/src/commands/functions/env/remove.ts)_
 
 ## `sanity-run functions logs [NAME]`
 
@@ -585,7 +580,7 @@ EXAMPLES
   $ sanity-run functions logs <name> --delete
 ```
 
-_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v13.0.2/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v13.1.0/src/commands/functions/logs.ts)_
 
 ## `sanity-run functions test [NAME]`
 
@@ -595,8 +590,8 @@ Invoke a local Sanity Function
 USAGE
   $ sanity-run functions test [NAME] [--data-before <value> | [-d <value> | -f <value> | --document-id <value>] |  |
     | --file-before <value> | --file-after <value> | --document-id-before <value> | --document-id-after <value>]
-    [--data-after <value> |  |  |  |  |  |  | ] [-e create|update|delete] [-t <value>] [-a <value>] [--organization-id
-    <value>] [--with-user-token] [--media-library-id <value> | --project-id <value> | --dataset <value>]
+    [--data-after <value> |  |  |  |  |  |  | ] [-e create|update|delete] [-t <value>] [-a <value>] [--with-user-token]
+    [--media-library-id <value> | --project-id <value> | --dataset <value>]
 
 ARGUMENTS
   [NAME]  The name of the Sanity Function
@@ -617,7 +612,6 @@ FLAGS
       --file-after=<value>          Current document
       --file-before=<value>         Original document
       --media-library-id=<value>    Sanity Media Library ID to use
-      --organization-id=<value>     Sanity Organization ID to use
       --project-id=<value>          Sanity Project ID to use
       --with-user-token             Prime access token from CLI config
 
@@ -640,7 +634,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/v13.0.2/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v13.1.0/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 

package/dist/actions/blueprints/blueprint.js

@@ -1,6 +1,7 @@
 import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
 import { basename, dirname, extname } from 'node:path';
 import { cwd, env } from 'node:process';
+import { pathToFileURL } from 'node:url';
 import blueprintParserValidator from '@sanity/blueprints-parser';
 import { findUpSync } from 'find-up';
 import { createJiti } from 'jiti';
@@ -89,7 +90,7 @@ export async function readLocalBlueprint(logger, blueprintPath) {
             }
             case '.ts': {
                 const jiti = createJiti(dirname(foundFilePath));
-                const modDefault = await jiti.import(`file://${foundFilePath}`, { default: true });
+                const modDefault = await jiti.import(pathToFileURL(foundFilePath).href, { default: true });
                 blueprintModule = modDefault;
                 break;
             }

package/dist/actions/git.d.ts

@@ -1,3 +1,6 @@
 export declare const GITIGNORE_FOR_FUNCTIONS = "\n# Sanity Functions\nfunctions/**/.env*\nfunctions/**/.build/\nfunctions/**/node_modules/\n";
 export declare const GITIGNORE_TEMPLATE = "node_modules\n.env\n\n# Sanity Functions\nfunctions/**/.env*\nfunctions/**/.build/\nfunctions/**/node_modules/\n\n";
-export declare function writeGitignoreFile(nearFilePath: string): string | null;
+export type GitignoreResult = {
+    action: 'created' | 'updated' | 'unchanged';
+};
+export declare function writeGitignoreFile(nearFilePath: string): GitignoreResult;

package/dist/actions/git.js

@@ -20,9 +20,9 @@ export function writeGitignoreFile(nearFilePath) {
         // append GITIGNORE_FOR_FUNCTIONS to existing .gitignore
         const existingContent = readFileSync(gitignorePath, 'utf8').toString();
         if (existingContent.includes(GITIGNORE_FOR_FUNCTIONS))
-            return null;
-        content = `${existingContent}\n${GITIGNORE_FOR_FUNCTIONS}`;
+            return { action: 'unchanged' };
+        content = `${existingContent.trimEnd()}\n${GITIGNORE_FOR_FUNCTIONS}`;
     }
     writeFileSync(gitignorePath, content);
-    return content;
+    return { action: gitignoreExists ? 'updated' : 'created' };
 }

package/dist/commands/blueprints/config.js

@@ -30,6 +30,7 @@ If you need to switch your Blueprint to a different Stack, use --edit --stack-id
             description: 'Directly set the organization ID in the configuration. Requires --edit flag',
             aliases: ['organization', 'organizationId', 'org'],
             dependsOn: ['edit'],
+            hidden: true,
         }),
         'stack-id': Flags.string({
             description: 'Directly set the Stack ID in the configuration. Requires --edit flag',

package/dist/commands/blueprints/destroy.js

@@ -30,6 +30,7 @@ Use this to clean up test environments or decommission a Stack you no longer nee
             aliases: ['organizationId', 'organization', 'org'],
             dependsOn: ['stack-id', 'force'],
             exclusive: ['project-id'],
+            hidden: true,
         }),
         'stack-id': Flags.string({
             description: 'Stack ID to destroy (defaults to current Stack)',

package/dist/commands/blueprints/init.js

@@ -45,6 +45,7 @@ After initialization, use 'blueprints plan' to preview changes, then 'blueprints
         'organization-id': Flags.string({
             description: 'Sanity organization ID used to scope local Blueprint and remote Stack',
             aliases: ['organization', 'organizationId', 'org'],
+            hidden: true,
         }),
         'stack-id': Flags.string({
             description: 'Existing Stack ID used to scope local Blueprint',

package/dist/commands/blueprints/stacks.js

@@ -22,6 +22,7 @@ Use this to discover existing Stacks you can scope a local Blueprint to (using '
             description: 'Organization ID to show Stack deployments for',
             aliases: ['organizationId', 'organization', 'org'],
             exclusive: ['project-id'],
+            hidden: true,
         }),
     };
     async run() {

package/dist/commands/functions/test.js

@@ -110,6 +110,7 @@ Provide test data via --data (inline JSON), --file (JSON file), or --document-id
             description: 'Sanity Organization ID to use',
             aliases: ['organization', 'organizationId', 'org'],
             required: false,
+            hidden: true,
         }),
         'document-id': Flags.string({
             description: 'Document to fetch and send to function',

package/dist/constants.d.ts

@@ -1,4 +1,5 @@
 export declare const SANITY_ACCESS_ROLE = "sanity.access.role";
+export declare const SANITY_ACCESS_ROBOT = "sanity.access.robot";
 export declare const SANITY_FUNCTION_DOCUMENT = "sanity.function.document";
 export declare const SANITY_FUNCTION_MEDIA_LIBRARY_ASSET = "sanity.function.media-library.asset";
 export declare const SANITY_FUNCTION_SCHEDULE = "sanity.function.cron";

package/dist/constants.js

@@ -1,4 +1,5 @@
 export const SANITY_ACCESS_ROLE = 'sanity.access.role';
+export const SANITY_ACCESS_ROBOT = 'sanity.access.robot';
 export const SANITY_FUNCTION_DOCUMENT = 'sanity.function.document';
 export const SANITY_FUNCTION_MEDIA_LIBRARY_ASSET = 'sanity.function.media-library.asset';
 export const SANITY_FUNCTION_SCHEDULE = 'sanity.function.cron';

package/dist/cores/blueprints/init.d.ts

@@ -2,6 +2,7 @@ import type { ScopeType } from '../../utils/types.js';
 import type { CoreConfig, CoreResult } from '../index.js';
 export interface BlueprintInitOptions extends CoreConfig {
     token: string;
+    knownProjectId?: string;
     args: {
         dir?: string;
     };
@@ -33,6 +34,7 @@ export declare function resolveScopeAndStack(params: {
     organizationId: string | undefined;
     stackId: string | undefined;
     stackName: string | undefined;
+    knownProjectId?: string;
     log: CoreConfig['log'];
     token: string;
 }): Promise<ResolvedScope>;

package/dist/cores/blueprints/init.js

@@ -8,6 +8,7 @@ import { createEmptyStack } from '../../actions/blueprints/stacks.js';
 import { writeGitignoreFile } from '../../actions/git.js';
 import { writeOrUpdateNodeDependency } from '../../actions/node.js';
 import { verifyExampleExists, writeExample } from '../../actions/sanity/examples.js';
+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, promptForProject, promptForStack, } from '../../utils/display/prompt.js';
@@ -15,7 +16,7 @@ import { blueprintConfigCore } from './config.js';
 const SCOPE_PROJECT = 'project';
 const SCOPE_ORGANIZATION = 'organization';
 export async function blueprintInitCore(options) {
-    const { bin = 'sanity', log, token, args, flags } = options;
+    const { bin = 'sanity', log, token, knownProjectId, args, flags } = options;
     const { dir: flagDir, example: flagExample, 'blueprint-type': flagBlueprintType, 'project-id': flagProjectId, 'organization-id': flagOrganizationId, 'stack-id': flagStackId, 'stack-name': flagStackName, verbose: v = false, } = flags;
     const { dir: argDir } = args;
     const userProvidedDirName = argDir || flagDir;
@@ -84,6 +85,7 @@ export async function blueprintInitCore(options) {
             organizationId: flagOrganizationId,
             stackId: flagStackId,
             stackName: flagStackName,
+            knownProjectId,
             log,
             token,
         });
@@ -169,7 +171,7 @@ async function handleExampleInitialization(options) {
     return { success: true };
 }
 export async function resolveScopeAndStack(params) {
-    const { projectId, organizationId, stackId, stackName, log, token } = params;
+    const { projectId, organizationId, stackId, stackName, knownProjectId, log, token } = params;
     let scopeType = SCOPE_PROJECT;
     let scopeId;
     if (projectId) {
@@ -195,10 +197,33 @@ export async function resolveScopeAndStack(params) {
         resolvedStackId = stack.id;
     }
     if (!scopeId) {
-        log('\nBlueprints are associated with a Sanity Project. Please select one:');
-        const pickedProject = await promptForProject({ token, logger: log });
-        scopeType = SCOPE_PROJECT;
-        scopeId = pickedProject.projectId;
+        log('\nBlueprints are associated with a Sanity project.');
+        // If we have a CLI project ID, offer it as a suggestion
+        if (knownProjectId) {
+            const { ok, project } = await getProject({
+                token,
+                scopeId: knownProjectId,
+                scopeType: 'project',
+                logger: log,
+            });
+            if (ok && project) {
+                const useCliProject = await confirm({
+                    message: `The CLI is configured to use "${project.displayName}" (${knownProjectId}). Use this for the blueprint?`,
+                    default: true,
+                });
+                if (useCliProject) {
+                    scopeType = SCOPE_PROJECT;
+                    scopeId = knownProjectId;
+                }
+            }
+        }
+        // If still no scope (no knownProjectId, lookup failed, or user declined), prompt for selection
+        if (!scopeId) {
+            log('Select a project:');
+            const pickedProject = await promptForProject({ token, logger: log });
+            scopeType = SCOPE_PROJECT;
+            scopeId = pickedProject.projectId;
+        }
     }
     if (!resolvedStackId) {
         log('\nBlueprints are deployed to a "Stack".');
@@ -254,8 +279,13 @@ export async function createBlueprintFiles(params) {
         ...(scopeType === SCOPE_ORGANIZATION ? { organizationId: scopeId } : { projectId: scopeId }),
     });
     log(check(`${chalk.bold('Added configuration:')} ${displayPath}/${BLUEPRINT_CONFIG_DIR}/${BLUEPRINT_CONFIG_FILE}`));
-    writeGitignoreFile(blueprintFilePath);
-    log(check(`${chalk.bold('Added .gitignore:')}    ${displayPath}/.gitignore`));
+    const gitignoreResult = writeGitignoreFile(blueprintFilePath);
+    if (gitignoreResult.action === 'created') {
+        log(check(`${chalk.bold('Added .gitignore:')}    ${displayPath}/.gitignore`));
+    }
+    else if (gitignoreResult.action === 'updated') {
+        log(check(`${chalk.bold('Updated .gitignore:')}  ${displayPath}/.gitignore`));
+    }
     if (blueprintExtension !== 'json') {
         const blueprintsPackage = '@sanity/blueprints';
         try {

package/dist/cores/functions/add.js

@@ -6,6 +6,7 @@ import { highlight } from 'cardinal';
 import chalk from 'chalk';
 import { createFunctionResource } from '../../actions/blueprints/resources.js';
 import { verifyExampleExists, writeExample } from '../../actions/sanity/examples.js';
+import { SANITY_FUNCTION_MEDIA_LIBRARY_ASSET, SANITY_FUNCTION_SCHEDULE } from '../../constants.js';
 import { check, indent, warn } from '../../utils/display/presenters.js';
 import { validateFunctionName } from '../../utils/validate/resource.js';
 const generateFunctionBlueprintResourceTemplate = (fnName, eventNames) => {
@@ -71,7 +72,17 @@ export async function functionAddCore(options) {
             }
             else {
                 const objectLiteral = configString.replace(/^(\s*)"([a-zA-Z_$][a-zA-Z0-9_$]*)":/gm, '$1$2:');
-                log(indent(highlight(`defineDocumentFunction(${objectLiteral})`)));
+                let type = 'Document';
+                switch (functionConfig.type) {
+                    case SANITY_FUNCTION_MEDIA_LIBRARY_ASSET:
+                        type = 'MediaLibraryAsset';
+                        break;
+                    case SANITY_FUNCTION_SCHEDULE:
+                        type = 'Schedule';
+                        break;
+                    default:
+                }
+                log(indent(highlight(`define${type}Function(${objectLiteral})`)));
             }
         }
         else {

package/dist/server/static/vendor/vendor.bundle.js

@@ -5849,7 +5849,7 @@ class SelectionRange {
     Compare this range to another range.
     */
     eq(other, includeAssoc = false) {
-        return this.anchor == other.anchor && this.head == other.head &&
+        return this.anchor == other.anchor && this.head == other.head && this.goalColumn == other.goalColumn &&
             (!includeAssoc || !this.empty || this.assoc == other.assoc);
     }
     /**
@@ -7338,7 +7338,8 @@ class EditorState {
      - Other (anything else)
     */
     charCategorizer(at) {
-        return makeCategorizer(this.languageDataAt("wordChars", at).join(""));
+        let chars = this.languageDataAt("wordChars", at);
+        return makeCategorizer(chars.length ? chars[0] : "");
     }
     /**
     Find the word at the given position, meaning the range
@@ -7524,6 +7525,9 @@ class RangeValue {
 RangeValue.prototype.startSide = RangeValue.prototype.endSide = 0;
 RangeValue.prototype.point = false;
 RangeValue.prototype.mapMode = MapMode.TrackDel;
+function cmpVal(a, b) {
+    return a == b || a.constructor == b.constructor && a.eq(b);
+}
 /**
 A range associates a value with a range of positions.
 */
@@ -7830,7 +7834,7 @@ class RangeSet {
         for (;;) {
             if (sideA.to != sideB.to ||
                 !sameValues(sideA.active, sideB.active) ||
-                sideA.point && (!sideB.point || !sideA.point.eq(sideB.point)))
+                sideA.point && (!sideB.point || !cmpVal(sideA.point, sideB.point)))
                 return false;
             if (sideA.to > to)
                 return true;
@@ -8305,22 +8309,27 @@ function compare(a, startA, b, startB, length, comparator) {
     b.goto(startB);
     let endB = startB + length;
     let pos = startB, dPos = startB - startA;
-    for (;;) {
+    let bounds = !!comparator.boundChange;
+    for (let boundChange = false;;) {
         let dEnd = (a.to + dPos) - b.to, diff = dEnd || a.endSide - b.endSide;
         let end = diff < 0 ? a.to + dPos : b.to, clipEnd = Math.min(end, endB);
-        if (a.point || b.point) {
-            if (!(a.point && b.point && (a.point == b.point || a.point.eq(b.point)) &&
+        let point = a.point || b.point;
+        if (point) {
+            if (!(a.point && b.point && cmpVal(a.point, b.point) &&
                 sameValues(a.activeForPoint(a.to), b.activeForPoint(b.to))))
                 comparator.comparePoint(pos, clipEnd, a.point, b.point);
+            boundChange = false;
         }
         else {
+            if (boundChange)
+                comparator.boundChange(pos);
             if (clipEnd > pos && !sameValues(a.active, b.active))
                 comparator.compareRange(pos, clipEnd, a.active, b.active);
+            if (bounds && clipEnd < endB && (dEnd || a.openEnd(end) != b.openEnd(end)))
+                boundChange = true;
         }
         if (end > endB)
             break;
-        if ((dEnd || a.openEnd != b.openEnd) && comparator.boundChange)
-            comparator.boundChange(end);
         pos = end;
         if (diff <= 0)
             a.next();
@@ -8332,7 +8341,7 @@ function sameValues(a, b) {
     if (a.length != b.length)
         return false;
     for (let i = 0; i < a.length; i++)
-        if (a[i] != b[i] && !a[i].eq(b[i]))
+        if (a[i] != b[i] && !cmpVal(a[i], b[i]))
             return false;
     return true;
 }

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

@@ -2,6 +2,7 @@ import {table as renderTable} from 'node:console'
 import {existsSync, statSync} from 'node:fs'
 import {isAbsolute, join} from 'node:path'
 import process from 'node:process'
+import {pathToFileURL} from 'node:url'
 import {inspect} from 'node:util'
 
 export function getFunctionSource(src) {
@@ -12,9 +13,9 @@ export function getFunctionSource(src) {
     if (!existsSync(indexPath)) {
       throw Error(`Function directory ${pathToCheck} has no index.js`)
     }
-    return `file://${indexPath}`
+    return pathToFileURL(indexPath).href
   }
-  return `file://${pathToCheck}`
+  return pathToFileURL(pathToCheck).href
 }
 
 // Monkey patch console menthods to have logs match server log format

package/dist/utils/display/blueprints-formatting.d.ts

@@ -1,7 +1,7 @@
 import type { Blueprint, Resource } from '@sanity/blueprints-parser';
-import { type DeployedResource, type Stack } from '../types.js';
+import { type BlueprintResourceRecord, type Stack } from '../types.js';
 export declare function formatTitle(title: string, name: string): string;
-export declare function formatDeployedResourceTree(resources: DeployedResource[] | undefined, verbose?: boolean): string;
+export declare function formatDeployedResourceTree(resources: BlueprintResourceRecord[] | undefined, verbose?: boolean): string;
 export declare function formatResourceTree(resources: Resource[] | undefined, verbose?: boolean): string;
 export declare function formatStackInfo(stack: Stack | Blueprint, isCurrentStack?: boolean): string;
 export declare function formatStacksListing(stacks: Stack[], currentStackId?: string): string;

package/dist/utils/display/blueprints-formatting.js

@@ -1,10 +1,10 @@
 import { treeify } from 'array-treeify';
 import chalk from 'chalk';
-import { SANITY_ACCESS_ROLE, SANITY_FUNCTION_DOCUMENT, SANITY_FUNCTION_MEDIA_LIBRARY_ASSET, SANITY_FUNCTION_SCHEDULE, SANITY_PROJECT_CORS, SANITY_PROJECT_DATASET, SANITY_PROJECT_WEBHOOK, } from '../../constants.js';
-import { isCorsOriginResource, isDatasetResource, isRoleResource, isWebhookResource, } from '../types.js';
+import { SANITY_ACCESS_ROBOT, SANITY_ACCESS_ROLE, SANITY_FUNCTION_DOCUMENT, SANITY_FUNCTION_MEDIA_LIBRARY_ASSET, SANITY_FUNCTION_SCHEDULE, SANITY_PROJECT_CORS, SANITY_PROJECT_DATASET, SANITY_PROJECT_WEBHOOK, } from '../../constants.js';
+import { isCorsOriginResource, isDatasetResource, isRobotResource, isRoleResource, isWebhookResource, } from '../types.js';
 import { formatDate, formatDuration } from './dates.js';
 import { niceId } from './presenters.js';
-import { arrayifyCors, arrayifyDataset, arrayifyFunction, arrayifyRole, arrayifyWebhook, } from './resources-formatting.js';
+import { arrayifyCors, arrayifyDataset, arrayifyFunction, arrayifyRobot, arrayifyRole, arrayifyWebhook, } from './resources-formatting.js';
 const functionCategory = {
     label: 'Functions',
     displayNameAttribute: 'displayName',
@@ -18,6 +18,13 @@ const RESOURCE_CATEGORIES = {
             return isRoleResource(res) ? arrayifyRole(res) : [];
         },
     },
+    [SANITY_ACCESS_ROBOT]: {
+        label: 'Robots',
+        displayNameAttribute: 'label',
+        formatDetails(res) {
+            return isRobotResource(res) ? arrayifyRobot(res) : [];
+        },
+    },
     [SANITY_FUNCTION_DOCUMENT]: functionCategory,
     [SANITY_FUNCTION_MEDIA_LIBRARY_ASSET]: functionCategory,
     [SANITY_FUNCTION_SCHEDULE]: functionCategory,

package/dist/utils/display/prompt.js

@@ -32,24 +32,25 @@ export async function promptForProject({ token, knownOrganizationId, knownProjec
     if (organizations.length > 1) {
         const orgChoices = organizations.map(({ organization, projects }) => ({
             name: `"${organization.name}" ${niceId(organization.id)}`,
-            value: { organization, projects },
+            value: organization.id,
             disabled: !projects || projects.length === 0 ? '(0 Projects)' : false,
         }));
-        const pickedOrganization = await select({
+        const pickedOrgId = await select({
             message: 'Which Organization would you like to use?',
             choices: orgChoices,
             default: knownOrganizationId,
         });
-        projects = pickedOrganization.projects;
+        const pickedOrg = organizations.find((o) => o.organization.id === pickedOrgId);
+        projects = pickedOrg?.projects;
     }
     else {
         projects = organizations[0].projects;
     }
     const projectChoices = projects.map(({ displayName, id: projectId }) => ({
         name: `"${displayName}" ${niceId(projectId)}`,
-        value: { projectId, displayName },
+        value: projectId,
     }));
-    let pickedProject;
+    let pickedProjectId;
     if (projectChoices.length === 1) {
         const onlyProject = projectChoices[0];
         const confirmed = await confirm({
@@ -57,18 +58,21 @@ export async function promptForProject({ token, knownOrganizationId, knownProjec
             default: true,
         });
         if (confirmed)
-            pickedProject = onlyProject.value;
+            pickedProjectId = onlyProject.value;
         else
             throw new Error('No project selected');
     }
     else {
-        pickedProject = await select({
+        pickedProjectId = await select({
             message: 'Choose a Sanity Project:',
             choices: projectChoices,
             default: knownProjectId,
         });
     }
-    return pickedProject;
+    const pickedProject = projects.find((p) => p.id === pickedProjectId);
+    if (!pickedProject)
+        throw new Error('Project not found');
+    return { projectId: pickedProject.id, displayName: pickedProject.displayName };
 }
 /**
  * Prompt the user for a Stack ID after selecting a Project.
@@ -83,24 +87,24 @@ export async function promptForStack({ projectId, token, logger, }) {
     if (!stacksOk) {
         throw new Error(stacksErr || 'Failed to list Stacks');
     }
-    const newStackValue = { id: 'new', name: 'new' };
-    let pickedStackId = newStackValue;
+    const NEW_STACK_ID = 'new';
+    let pickedStackId = NEW_STACK_ID;
     if (stacks.length > 0) {
         const stackChoices = [];
         stackChoices.push(new Separator(chalk.underline('Create a new Stack:')));
-        stackChoices.push({ name: chalk.bold('New Stack ✨'), value: newStackValue });
+        stackChoices.push({ name: chalk.bold('New Stack ✨'), value: NEW_STACK_ID });
         stackChoices.push(new Separator(chalk.underline('Use an existing Stack:')));
         stackChoices.push(...stacks.map((s) => ({
             name: `"${s.name}" ${niceId(s.id)} ${chalk.dim(`(${s.resources.length} res)`)}`,
-            value: { id: s.id, name: s.name },
+            value: s.id,
         })));
         pickedStackId = await select({
             message: 'Select a deployment Stack:',
             choices: stackChoices,
-            default: newStackValue,
+            default: NEW_STACK_ID,
         });
     }
-    if (pickedStackId.id === 'new') {
+    if (pickedStackId === NEW_STACK_ID) {
         const stackName = await input({
             message: 'Enter a name for your new Stack:',
             validate: (input) => input.length > 0 || 'Stack name is required',
@@ -114,5 +118,8 @@ export async function promptForStack({ projectId, token, logger, }) {
         });
         return { stackId: stack.id, name: stackName };
     }
-    return { stackId: pickedStackId.id, name: pickedStackId.name };
+    const pickedStack = stacks.find((s) => s.id === pickedStackId);
+    if (!pickedStack)
+        throw new Error('Stack not found');
+    return { stackId: pickedStack.id, name: pickedStack.name };
 }

package/dist/utils/display/resources-formatting.d.ts

@@ -1,8 +1,9 @@
-import type { BlueprintCorsOriginResource, BlueprintDatasetResource, BlueprintDocumentWebhookResource, BlueprintRoleResource } from '@sanity/blueprints';
+import type { BlueprintCorsOriginResource, BlueprintDatasetResource, BlueprintDocumentWebhookResource, BlueprintRobotResource, BlueprintRoleResource } from '@sanity/blueprints';
 import type { TreeInput } from 'array-treeify';
 import { type FunctionResourceBase } from '../../utils/types.js';
 export declare function arrayifyFunction(fn: FunctionResourceBase): TreeInput;
 export declare function arrayifyCors(resource: BlueprintCorsOriginResource): TreeInput;
+export declare function arrayifyRobot(resource: BlueprintRobotResource): TreeInput;
 export declare function arrayifyRole(resource: BlueprintRoleResource): TreeInput;
 export declare function arrayifyDataset(resource: BlueprintDatasetResource): TreeInput;
 export declare function arrayifyWebhook(resource: BlueprintDocumentWebhookResource): TreeInput;

package/dist/utils/display/resources-formatting.js

@@ -49,6 +49,37 @@ export function arrayifyFunction(fn) {
 export function arrayifyCors(resource) {
     return [formatLabeledValue('origin', resource.origin)];
 }
+export function arrayifyRobot(resource) {
+    const details = [formatLabeledValue('label', resource.label)];
+    if (resource.memberships.length > 0) {
+        details.push(formatLabel('memberships'));
+        const memberships = [];
+        resource.memberships.forEach((m, i) => {
+            const membership = [];
+            membership.push(formatLabeledValue('resourceType', m.resourceType));
+            membership.push(formatLabeledValue('resourceId', m.resourceId));
+            if (m.roleNames.length > 0) {
+                membership.push(formatLabeledValue('roleNames', m.roleNames.join(', ')));
+            }
+            else {
+                membership.push(formatLabeledValue('roleNames', '[]'));
+            }
+            memberships.push(formatLabel(i.toString()));
+            memberships.push(membership);
+        });
+        details.push(memberships);
+    }
+    else {
+        details.push(formatLabeledValue('memberships', '[]'));
+    }
+    if (resource.resourceType) {
+        details.push(formatLabeledValue('resourceType', resource.resourceType));
+    }
+    if (resource.resourceId) {
+        details.push(formatLabeledValue('resourceId', resource.resourceId));
+    }
+    return details;
+}
 export function arrayifyRole(resource) {
     const details = [];
     if (resource.description)

package/dist/utils/find-function.js

@@ -13,7 +13,12 @@ export function findFunctionInBlueprint(blueprint, name) {
 export function findFunctionInStack(stack, name) {
     const func = stack?.resources?.find((r) => r?.type?.startsWith('sanity.function.') && r.name === name);
     if (!func)
-        throw Error(`Unable to find function ${name}`);
+        throw Error(`Unable to find function: "${name}"`);
+    if (!isDeployedResource(func))
+        throw Error(`Unable to find deployed function: "${name}"`);
     // return the deployed resource
     return func;
 }
+function isDeployedResource(r) {
+    return 'externalId' in r && typeof r.externalId === 'string';
+}

package/dist/utils/types.d.ts

@@ -1,4 +1,4 @@
-import { type BlueprintCorsOriginResource, type BlueprintDatasetResource, type BlueprintDocumentWebhookResource, type BlueprintResource, type BlueprintRoleResource } from '@sanity/blueprints';
+import { type BlueprintCorsOriginResource, type BlueprintDatasetResource, type BlueprintDocumentWebhookResource, type BlueprintResource, type BlueprintRobotResource, type BlueprintRoleResource } from '@sanity/blueprints';
 import type { Blueprint } from '@sanity/blueprints-parser';
 import { SANITY_FUNCTION_DOCUMENT, SANITY_FUNCTION_MEDIA_LIBRARY_ASSET, SANITY_FUNCTION_SCHEDULE } from '../constants.js';
 export type ScopeType = 'organization' | 'project';
@@ -48,11 +48,16 @@ interface FunctionResourceScheduleExpressionEvent {
     expression: string;
 }
 type FunctionResourceScheduleEvent = FunctionResourceScheduleExplicitEvent | FunctionResourceScheduleExpressionEvent;
-export interface DeployedResource extends BlueprintResource {
+/** The Blueprint resource as represented in the Blueprints API database */
+export interface BlueprintResourceRecord extends BlueprintResource {
     id: string;
-    externalId: string;
+    externalId?: string | null;
     parameters: Record<string, unknown>;
 }
+/** The deployed resource; complete with external ID */
+export interface DeployedResource extends BlueprintResourceRecord {
+    externalId: string;
+}
 export declare function isLocalFunctionResource(r: BlueprintResource): r is FunctionResourceBase;
 export declare function isDocumentFunctionResource<T extends BlueprintResource>(r: T): r is T & FunctionResourceDocument;
 export declare function isMediaLibraryAssetFunctionResource<T extends BlueprintResource>(r: T): r is T & FunctionResourceMediaLibraryAsset;
@@ -60,6 +65,7 @@ export declare function isScheduleFunctionResource<T extends BlueprintResource>(
 export declare function isLocalFunctionCollection<T extends BlueprintResource>(r: T): r is T & FunctionsCollection;
 export declare function isScheduleEvent(e: unknown): e is FunctionResourceScheduleEvent;
 export declare function isCorsOriginResource(r: unknown): r is BlueprintCorsOriginResource;
+export declare function isRobotResource(r: unknown): r is BlueprintRobotResource;
 export declare function isRoleResource(r: unknown): r is BlueprintRoleResource;
 export declare function isDatasetResource(r: unknown): r is BlueprintDatasetResource;
 export declare function isWebhookResource(r: unknown): r is BlueprintDocumentWebhookResource;
@@ -114,7 +120,7 @@ export interface Stack {
     displayName: string;
     scopeType: ScopeType;
     scopeId: string;
-    resources: Array<DeployedResource>;
+    resources: Array<BlueprintResourceRecord>;
     createdAt?: string;
     updatedAt?: string;
     recentOperation?: StackOperation;

package/dist/utils/types.js

@@ -1,4 +1,4 @@
-import { validateCorsOrigin, validateDataset, validateDocumentWebhook, validateRole, } from '@sanity/blueprints';
+import { validateCorsOrigin, validateDataset, validateDocumentWebhook, validateRobot, validateRole, } from '@sanity/blueprints';
 import { SANITY_FUNCTION_DOCUMENT, SANITY_FUNCTION_MEDIA_LIBRARY_ASSET, SANITY_FUNCTION_SCHEDULE, } from '../constants.js';
 // type narrowing with predicate functions
 export function isLocalFunctionResource(r) {
@@ -22,6 +22,9 @@ export function isScheduleEvent(e) {
 export function isCorsOriginResource(r) {
     return validateCorsOrigin(r).length === 0;
 }
+export function isRobotResource(r) {
+    return validateRobot(r).length === 0;
+}
 export function isRoleResource(r) {
     return validateRole(r).length === 0;
 }

package/oclif.manifest.json

@@ -253,6 +253,7 @@
             "edit"
           ],
           "description": "Directly set the organization ID in the configuration. Requires --edit flag",
+          "hidden": true,
           "name": "organization-id",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -431,6 +432,7 @@
           "exclusive": [
             "project-id"
           ],
+          "hidden": true,
           "name": "organization-id",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -694,6 +696,7 @@
             "org"
           ],
           "description": "Sanity organization ID used to scope local Blueprint and remote Stack",
+          "hidden": true,
           "name": "organization-id",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -931,6 +934,7 @@
           "exclusive": [
             "project-id"
           ],
+          "hidden": true,
           "name": "organization-id",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1512,6 +1516,7 @@
             "org"
           ],
           "description": "Sanity Organization ID to use",
+          "hidden": true,
           "name": "organization-id",
           "required": false,
           "hasDynamicHelp": false,
@@ -1809,5 +1814,5 @@
       ]
     }
   },
-  "version": "13.0.2"
+  "version": "13.1.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sanity/runtime-cli",
   "description": "Sanity's Runtime CLI for Blueprints and Functions",
-  "version": "13.0.2",
+  "version": "13.1.0",
   "author": "Sanity Runtime Team",
   "type": "module",
   "license": "MIT",
@@ -98,12 +98,12 @@
   "dependencies": {
     "@architect/hydrate": "^5.0.1",
     "@architect/inventory": "^5.0.0",
-    "@inquirer/prompts": "^8.0.1",
+    "@inquirer/prompts": "^8.2.0",
     "@oclif/core": "^4.8.0",
     "@oclif/plugin-help": "^6.2.36",
-    "@sanity/blueprints": "^0.7.0",
+    "@sanity/blueprints": "^0.8.0",
     "@sanity/blueprints-parser": "^0.3.0",
-    "@sanity/client": "^7.13.0",
+    "@sanity/client": "^7.14.0",
     "adm-zip": "^0.5.16",
     "array-treeify": "^0.1.5",
     "cardinal": "^2.1.1",
@@ -111,25 +111,24 @@
     "eventsource": "^4.1.0",
     "find-up": "^8.0.0",
     "get-folder-size": "^5.0.0",
-    "groq-js": "^1.21.0",
-    "inquirer": "^12.11.1",
+    "groq-js": "^1.25.0",
     "jiti": "^2.6.1",
     "mime-types": "^3.0.2",
-    "ora": "^9.0.0",
+    "ora": "^9.1.0",
     "tar-stream": "^3.1.7",
-    "vite": "^7.2.4",
-    "vite-tsconfig-paths": "^5.1.4",
-    "ws": "^8.18.3",
+    "vite": "^7.3.1",
+    "vite-tsconfig-paths": "^6.0.4",
+    "ws": "^8.19.0",
     "xdg-basedir": "^5.1.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.3.7",
+    "@biomejs/biome": "2.3.11",
     "@codemirror/lang-json": "^6.0.2",
-    "@codemirror/state": "^6.5.2",
+    "@codemirror/state": "^6.5.4",
     "@enhance/store": "^1.0.2",
     "@lezer/highlight": "^1.2.3",
     "@oclif/test": "^4.1.15",
-    "@playwright/test": "^1.56.1",
+    "@playwright/test": "^1.57.0",
     "@rollup/plugin-node-resolve": "^16.0.3",
     "@sanity/functions": "^1.1.0",
     "@types/adm-zip": "^0.5.7",
@@ -139,15 +138,15 @@
     "@types/tar-stream": "^3.1.4",
     "@types/ws": "^8.18.1",
     "codemirror": "^6.0.2",
-    "mentoss": "^0.12.0",
-    "oclif": "^4.22.57",
+    "mentoss": "^0.13.0",
+    "oclif": "^4.22.67",
     "pretty-bytes": "^7.1.0",
     "pretty-ms": "^9.3.0",
-    "rollup": "^4.53.3",
+    "rollup": "^4.55.3",
     "shx": "^0.4.0",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3",
-    "vitest": "4.0.13"
+    "vitest": "4.0.17"
   },
   "oclif": {
     "bin": "sanity-run",