@sanity/runtime-cli 17.4.0 → 17.5.0

package/dist/commands/blueprints/deploy.js

@@ -14,7 +14,9 @@ Use --no-wait to queue the deployment and return immediately without waiting for
 
 Use --fn-installer to force which package manager to use when deploying functions.
 
-Set SANITY_ASSET_TIMEOUT (seconds) to override the 60-second timeout for processing resource assets.
+Set SANITY_ASSET_TIMEOUT (seconds) to override the 180-second timeout for processing resource assets.
+
+Set SANITY_ASSET_CONCURRENCY to override how many resource assets are processed at once (default 4).
 
 Exit codes: 0 deployed, 2 deployment failed, 75 deployment accepted but completion could not be confirmed (rerun 'blueprints info' to check).`;
     static examples = [

package/dist/commands/blueprints/destroy.js

@@ -19,7 +19,7 @@ Exit codes: 0 destroyed, 2 destruction failed, 75 destruction accepted but compl
     static flags = {
         force: Flags.boolean({
             description: 'Force Stack destruction (skip confirmation)',
-            aliases: ['f'],
+            char: 'f',
             default: false,
         }),
         'project-id': Flags.string({

package/dist/commands/blueprints/info.d.ts

@@ -8,6 +8,7 @@ export default class InfoCommand extends ResolvedCommand<typeof InfoCommand> {
         stack: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'project-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'organization-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<Record<string, unknown> | undefined>;
 }

package/dist/commands/blueprints/info.js

@@ -23,6 +23,11 @@ Run 'blueprints stacks' to see all available Stacks in your project or organizat
         }),
         'project-id': Flags.string({ ...projectIdFlagConfig }),
         'organization-id': Flags.string({ ...organizationIdFlagConfig }),
+        verbose: Flags.boolean({
+            char: 'v',
+            description: 'Show resource and external IDs',
+            default: false,
+        }),
     };
     async run() {
         const result = await blueprintInfoCore({

package/dist/commands/blueprints/init.js

@@ -6,10 +6,9 @@ import { validTokenOrErrorMessage } from '../../utils/validated-token.js';
 export default class InitCommand extends RuntimeCommand {
     static summary = 'Initialize a Blueprint and create a remote Stack';
     static description = `A Blueprint is your local infrastructure-as-code configuration that defines Sanity resources (datasets, functions, etc.). A Stack is the remote deployment target where your Blueprint is applied.
-[NOTE: Currently, accounts are limited to three (3) Stacks per project scope.]
 
 This is typically the first command you run in a new project. It creates a local Blueprint manifest file (sanity.blueprint.ts, .js, or .json) and provisions a new remote Stack.
-Additionally, a Blueprint configuration file is created in .sanity/ containing the scope and Stack IDs. This is .gitignored by default.
+Additionally, a Blueprint configuration file is created in .sanity/ containing the scope and Stack IDs. A .gitignore covering node_modules, .env, and Function build output is created or updated; the .sanity/ config itself is not ignored.
 
 After initialization, use 'blueprints plan' to preview changes, then 'blueprints deploy' to apply them.
 

package/dist/commands/blueprints/logs.js

@@ -28,6 +28,7 @@ If you're not seeing expected logs, verify your Stack is deployed with 'blueprin
             char: 'w',
             description: 'Watch for new Stack logs',
             aliases: ['follow'],
+            exclusive: ['json'],
         }),
         limit: Flags.integer({
             char: 'l',

package/dist/commands/functions/add.js

@@ -23,7 +23,7 @@ After adding, use 'functions dev' to test locally, then 'blueprints deploy' to p
         example: Flags.string({
             description: 'Example to use for the Function',
             aliases: ['recipe'],
-            exclusive: ['name', 'fn-type', 'language', 'javascript', 'fn-helpers', 'fn-installer'],
+            exclusive: ['name', 'type', 'language', 'javascript', 'helpers', 'installer', 'install'],
         }),
         name: Flags.string({
             description: 'Name of the Function to add',
@@ -56,9 +56,9 @@ After adding, use 'functions dev' to test locally, then 'blueprints deploy' to p
             options: ['skip', ...INSTALLER_OPTIONS],
         }),
         install: Flags.boolean({
-            description: 'Shortcut for --fn-installer npm',
+            description: 'Shortcut for --installer npm',
             char: 'i',
-            exclusive: ['fn-installer'],
+            exclusive: ['installer'],
         }),
     };
     async run() {

package/dist/commands/functions/dev.js

@@ -9,11 +9,11 @@ export default class DevCommand extends ResolvedCommand {
 
 Open the emulator in your browser to interactively test your functions with the payload editor.
 
-Optionally, set the host and port with the --host and --port flags. Function timeout can be configured with the --timeout flag.
+Optionally, set the host and port with the --host and --port flags. Port 8974 is reserved for the emulator's live-reload WebSocket server. Function timeout can be configured with the --timeout flag.
 
 To invoke a function with the CLI, use 'functions test'.`;
     static examples = [
-        '<%= config.bin %> <%= command.id %> --host 127.0.0.1 --port 8974',
+        '<%= config.bin %> <%= command.id %> --host 127.0.0.1 --port 3333',
         '<%= config.bin %> <%= command.id %> --timeout 60',
     ];
     static flags = {

package/dist/commands/functions/logs.d.ts

@@ -15,5 +15,5 @@ export default class LogsCommand extends ResolvedCommand<typeof LogsCommand> {
         force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         watch: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
-    run(): Promise<Record<string, unknown> | undefined>;
+    run(): Promise<void | Record<string, unknown>>;
 }

package/dist/commands/functions/logs.js

@@ -46,6 +46,7 @@ Use --watch (-w) to stream logs in real-time. Use --delete to clear all logs for
             char: 'w',
             description: 'Watch for new logs (streaming mode)',
             aliases: ['follow'],
+            exclusive: ['json'],
         }),
     };
     async run() {
@@ -67,6 +68,8 @@ Use --watch (-w) to stream logs in real-time. Use --delete to clear all logs for
         });
         if (!result.success)
             this.coreError(result);
+        if (result.streaming)
+            return result.streaming;
         return result.json;
     }
 }

package/dist/cores/blueprints/deploy.js

@@ -4,21 +4,21 @@ import { getStack, updateStack } from '../../actions/blueprints/stacks.js';
 import { waitForOperation } from '../../actions/blueprints/wait-for-operation.js';
 import { checkUserPermission } from '../../actions/sanity/access.js';
 import { createHintCollector } from '../../utils/blueprints/hints.js';
-import { niceId } from '../../utils/display/presenters.js';
+import { check, niceId, severe } from '../../utils/display/presenters.js';
 import { CODE_OPERATION_UNCONFIRMED, EXIT_OPERATION_UNCONFIRMED } from '../../utils/exit-codes.js';
 import { styleText } from '../../utils/style-text.js';
 import { getWarnings } from '../../utils/warnings.js';
 export async function blueprintDeployCore(options) {
-    const { bin = 'sanity', log, auth, stackId, scopeType, scopeId, deployedStack, blueprint, flags, } = options;
+    const { bin = 'sanity', log: logger, auth, stackId, scopeType, scopeId, deployedStack, blueprint, flags, } = options;
     const { verbose } = flags;
     const noWait = flags['no-wait'] || false;
     const stackName = flags['new-stack-name'] ?? deployedStack.name;
     const installer = flags['fn-installer'] || undefined;
     const blueprintFileDir = dirname(blueprint.fileInfo.blueprintFilePath);
     const workspaceWarnings = getWarnings({ dir: blueprintFileDir });
-    log(`Deploying "${stackName}" ${niceId(deployedStack.id)}...`);
+    logger(`Deploying "${stackName}" ${niceId(deployedStack.id)}...`);
     try {
-        const { ok: checkOk, stack: currentStack } = await getStack({ stackId, auth, logger: log });
+        const { ok: checkOk, stack: currentStack } = await getStack({ stackId, auth, logger });
         if (!checkOk) {
             return { success: false, error: 'Failed to check current Stack status' };
         }
@@ -37,20 +37,20 @@ export async function blueprintDeployCore(options) {
         const preDeployResult = await preDeploy({
             scopeType,
             scopeId,
-            resources,
+            resources, // mutated by preDeploy
             stackId,
             stackName,
             auth,
             blueprintFileDir,
             installer,
-            log,
+            logger,
             bin,
             verbose,
+            onAssetEvent: createAssetEventHandler(logger),
         });
-        if (!preDeployResult?.success) {
+        if (!preDeployResult?.success)
             return preDeployResult;
-        }
-        const spinner = log.ora('Deploying...').start();
+        const deploySpinner = logger.ora('Deploying...').start();
         const { ok: deployOk, stack, error: deployError, } = await updateStack({
             stackId,
             stackMutation: {
@@ -61,10 +61,10 @@ export async function blueprintDeployCore(options) {
                 userMessage: flags.message,
             },
             auth,
-            logger: log,
+            logger,
         });
         if (!deployOk) {
-            spinner.fail(`${styleText('red', 'Failed')} to update Stack deployment`);
+            deploySpinner.fail(`${styleText('red', 'Failed')} to update Stack deployment`);
             const hints = createHintCollector(bin);
             if (deployError) {
                 hints.inspectMessage(deployError);
@@ -79,18 +79,18 @@ export async function blueprintDeployCore(options) {
                 ],
             };
         }
-        spinner.stop().clear();
+        deploySpinner.stop().clear();
         const legacyPermissionsNoticePromise = CHECK_LEGACY_DEPLOY_PERMISSION
             ? checkLegacyDeployPermission({
                 auth,
                 scopeType,
                 scopeId,
-                log,
+                log: logger,
             })
             : Promise.resolve(null);
         if (noWait) {
-            log(styleText(['bold', 'green'], 'Stack deployment started!'));
-            log(`Use \`npx ${bin} blueprints info\` to check status`);
+            logger(styleText(['bold', 'green'], 'Stack deployment started!'));
+            logger(`Use \`npx ${bin} blueprints info\` to check status`);
             const legacyWarning = await legacyPermissionsNoticePromise;
             const warnings = [...(legacyWarning ? [legacyWarning] : []), ...workspaceWarnings];
             return {
@@ -100,19 +100,19 @@ export async function blueprintDeployCore(options) {
                 warnings: warnings.length ? warnings : undefined,
             };
         }
-        log(styleText('dim', 'Stack deployment progress:'));
-        log('');
+        logger(styleText('dim', 'Stack deployment progress:'));
+        logger('');
         const outcome = await waitForOperation({
             stackId,
             operationId: stack.operationId,
             auth,
-            log,
+            log: logger,
             bin,
             verbose,
             progressNoun: 'deployment',
         });
         if (outcome.type === 'completed') {
-            log(styleText(['bold', 'green'], 'Stack deployment completed!'));
+            logger(styleText(['bold', 'green'], 'Stack deployment completed!'));
             const legacyWarning = await legacyPermissionsNoticePromise;
             const warnings = [...(legacyWarning ? [legacyWarning] : []), ...workspaceWarnings];
             return {
@@ -151,6 +151,56 @@ export async function blueprintDeployCore(options) {
         return { success: false, error: errorMessage };
     }
 }
+function createAssetEventHandler(logger) {
+    let spinner;
+    const results = [];
+    return (event) => {
+        switch (event.type) {
+            case 'progress': {
+                const { completed, total, slow } = event.progress;
+                const text = [
+                    `Processing assets (${completed}/${total})`,
+                    slow ? ', this can take a moment' : '',
+                ].join('');
+                if (spinner)
+                    spinner.text = text;
+                else
+                    spinner = logger.ora(text).start();
+                return;
+            }
+            case 'result': {
+                results.push(event.result);
+                return;
+            }
+            case 'complete': {
+                spinner?.stop();
+                spinner = undefined;
+                break;
+            }
+        }
+        // done. print report
+        for (const result of results) {
+            const { resource } = result;
+            if (!result.success) {
+                const summary = result.failureKind === 'upload'
+                    ? `Failed uploading ${resource.name} asset`
+                    : `Failed processing ${resource.name} asset`;
+                logger(` ${severe(summary)}`);
+                logger.error(`   ${result.error}`);
+                continue;
+            }
+            logger(` ${check(`${resource.name} ${niceId(resource.src)}`)}`);
+            logger(`   Source: ${resource.src}`);
+            if (result.hash) {
+                const hash = result.hash;
+                const h = hash.length > 24 ? `${hash.slice(0, 8)}...${hash.slice(-12)}` : hash;
+                logger.verbose(`   Hash: ${h}`);
+            }
+            if (result.exists)
+                logger.verbose('   Asset unchanged');
+        }
+    };
+}
 const CHECK_LEGACY_DEPLOY_PERMISSION = false;
 const BLUEPRINTS_PERMISSION_ENFORCEMENT_DATE = 'July 1, 2026';
 async function checkLegacyDeployPermission({ auth, scopeType, scopeId, log, }) {

package/dist/cores/functions/add.js

@@ -224,7 +224,7 @@ async function promptForFunctionName() {
     const functionName = await input({
         message: 'Enter function name:',
         validate: (input) => validateFunctionName(input) ||
-            'Invalid function name. Must be 6+ characters, no special characters, no spaces',
+            'Invalid function name. Must be 3+ characters, no special characters, no spaces',
     });
     return functionName;
 }

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

@@ -72,15 +72,15 @@ function resourceName(res, displayNameAttribute) {
         nameParts.push(styleText('green', `"${displayName}"`));
     return nameParts.join(' ');
 }
-function deployedResourceName(res, displayNameAttribute, _verbose = false) {
+function deployedResourceName(res, displayNameAttribute, verbose = false) {
     const nameParts = [styleText(['bold', 'green'], res.name)];
     const displayName = displayNameAttribute &&
         typeof res.parameters[displayNameAttribute] === 'string' &&
         res.parameters[displayNameAttribute];
     if (displayName && displayName !== res.name)
         nameParts.push(styleText('green', `"${displayName}"`));
-    // if (verbose)
-    nameParts.push(idList(res));
+    if (verbose)
+        nameParts.push(idList(res));
     return nameParts.join(' ');
 }
 function idList(res) {

package/dist/utils/style-text.js

@@ -1,3 +1,4 @@
+// TODO: move to ./display
 import { env } from 'node:process';
 import { styleText as nodeStyleText } from 'node:util';
 import { isInteractive } from './interactive.js';

package/oclif.manifest.json

@@ -373,7 +373,7 @@
     "blueprints:deploy": {
       "aliases": [],
       "args": {},
-      "description": "Applies your local Blueprint to the remote Stack, creating, updating, or removing resources as needed. This is the primary command for applying infrastructure changes.\n\nBefore deploying, run 'blueprints plan' to preview changes. After deployment, use 'blueprints info' to verify Stack status or 'blueprints logs' to monitor activity.\n\nUse --no-wait to queue the deployment and return immediately without waiting for completion.\n\nUse --fn-installer to force which package manager to use when deploying functions.\n\nSet SANITY_ASSET_TIMEOUT (seconds) to override the 60-second timeout for processing resource assets.\n\nExit codes: 0 deployed, 2 deployment failed, 75 deployment accepted but completion could not be confirmed (rerun 'blueprints info' to check).",
+      "description": "Applies your local Blueprint to the remote Stack, creating, updating, or removing resources as needed. This is the primary command for applying infrastructure changes.\n\nBefore deploying, run 'blueprints plan' to preview changes. After deployment, use 'blueprints info' to verify Stack status or 'blueprints logs' to monitor activity.\n\nUse --no-wait to queue the deployment and return immediately without waiting for completion.\n\nUse --fn-installer to force which package manager to use when deploying functions.\n\nSet SANITY_ASSET_TIMEOUT (seconds) to override the 180-second timeout for processing resource assets.\n\nSet SANITY_ASSET_CONCURRENCY to override how many resource assets are processed at once (default 4).\n\nExit codes: 0 deployed, 2 deployment failed, 75 deployment accepted but completion could not be confirmed (rerun 'blueprints info' to check).",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --message \"Enable staging dataset\"",
@@ -629,9 +629,7 @@
           "type": "option"
         },
         "force": {
-          "aliases": [
-            "f"
-          ],
+          "char": "f",
           "description": "Force Stack destruction (skip confirmation)",
           "name": "force",
           "allowNo": false,
@@ -781,8 +779,8 @@
           "type": "boolean"
         },
         "verbose": {
-          "description": "Verbose output",
-          "hidden": true,
+          "char": "v",
+          "description": "Show resource and external IDs",
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
@@ -855,7 +853,7 @@
           "name": "dir"
         }
       },
-      "description": "A Blueprint is your local infrastructure-as-code configuration that defines Sanity resources (datasets, functions, etc.). A Stack is the remote deployment target where your Blueprint is applied.\n[NOTE: Currently, accounts are limited to three (3) Stacks per project scope.]\n\nThis is typically the first command you run in a new project. It creates a local Blueprint manifest file (sanity.blueprint.ts, .js, or .json) and provisions a new remote Stack.\nAdditionally, a Blueprint configuration file is created in .sanity/ containing the scope and Stack IDs. This is .gitignored by default.\n\nAfter initialization, use 'blueprints plan' to preview changes, then 'blueprints deploy' to apply them.\n\nRunning without a directory prompts to confirm the current directory. Run 'blueprints init .' to initialize in the current directory without a prompt.",
+      "description": "A Blueprint is your local infrastructure-as-code configuration that defines Sanity resources (datasets, functions, etc.). A Stack is the remote deployment target where your Blueprint is applied.\n\nThis is typically the first command you run in a new project. It creates a local Blueprint manifest file (sanity.blueprint.ts, .js, or .json) and provisions a new remote Stack.\nAdditionally, a Blueprint configuration file is created in .sanity/ containing the scope and Stack IDs. A .gitignore covering node_modules, .env, and Function build output is created or updated; the .sanity/ config itself is not ignored.\n\nAfter initialization, use 'blueprints plan' to preview changes, then 'blueprints deploy' to apply them.\n\nRunning without a directory prompts to confirm the current directory. Run 'blueprints init .' to initialize in the current directory without a prompt.",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> .",
@@ -1132,6 +1130,9 @@
           ],
           "char": "w",
           "description": "Watch for new Stack logs",
+          "exclusive": [
+            "json"
+          ],
           "name": "watch",
           "allowNo": false,
           "type": "boolean"
@@ -1768,11 +1769,12 @@
           "description": "Example to use for the Function",
           "exclusive": [
             "name",
-            "fn-type",
+            "type",
             "language",
             "javascript",
-            "fn-helpers",
-            "fn-installer"
+            "helpers",
+            "installer",
+            "install"
           ],
           "name": "example",
           "hasDynamicHelp": false,
@@ -1856,9 +1858,9 @@
         },
         "install": {
           "char": "i",
-          "description": "Shortcut for --fn-installer npm",
+          "description": "Shortcut for --installer npm",
           "exclusive": [
-            "fn-installer"
+            "installer"
           ],
           "name": "install",
           "allowNo": false,
@@ -2024,9 +2026,9 @@
     "functions:dev": {
       "aliases": [],
       "args": {},
-      "description": "Runs a local, web-based development server to test your functions before deploying.\n\nOpen the emulator in your browser to interactively test your functions with the payload editor.\n\nOptionally, set the host and port with the --host and --port flags. Function timeout can be configured with the --timeout flag.\n\nTo invoke a function with the CLI, use 'functions test'.",
+      "description": "Runs a local, web-based development server to test your functions before deploying.\n\nOpen the emulator in your browser to interactively test your functions with the payload editor.\n\nOptionally, set the host and port with the --host and --port flags. Port 8974 is reserved for the emulator's live-reload WebSocket server. Function timeout can be configured with the --timeout flag.\n\nTo invoke a function with the CLI, use 'functions test'.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --host 127.0.0.1 --port 8974",
+        "<%= config.bin %> <%= command.id %> --host 127.0.0.1 --port 3333",
         "<%= config.bin %> <%= command.id %> --timeout 60"
       ],
       "flags": {
@@ -2410,6 +2412,9 @@
           ],
           "char": "w",
           "description": "Watch for new logs (streaming mode)",
+          "exclusive": [
+            "json"
+          ],
           "name": "watch",
           "allowNo": false,
           "type": "boolean"
@@ -3120,5 +3125,5 @@
       ]
     }
   },
-  "version": "17.4.0"
+  "version": "17.5.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sanity/runtime-cli",
   "description": "Sanity's Runtime CLI for Blueprints and Functions",
-  "version": "17.4.0",
+  "version": "17.5.0",
   "author": "Sanity Runtime Team",
   "type": "module",
   "license": "MIT",
@@ -26,6 +26,8 @@
   "files": [
     "./bin",
     "./dist",
+    "./SKILL.md",
+    "./skills",
     "./oclif.manifest.json"
   ],
   "bin": {
@@ -48,7 +50,7 @@
     "lint:fix": "npm run lint:write",
     "prepare": "npm run build",
     "postpack": "shx rm -f oclif.manifest.json",
-    "test": "vitest run && npm run test:depmgmt && npm run lint",
+    "test": "npm run typecheck && vitest run && npm run test:depmgmt && npm run lint",
     "test:depmgmt": "vitest run --config ./test-depmgmt/vitest.config.ts",
     "test:coverage": "vitest run --coverage --coverage.include \"runtime-cli/src/**/*\"",
     "test:scenarios": "vitest run test/scenarios",
@@ -63,19 +65,20 @@
     "@architect/hydrate": "~6.0.2",
     "@architect/inventory": "~6.1.0",
     "@inquirer/prompts": "^8.5.2",
-    "@oclif/core": "^4.13.2",
-    "@oclif/plugin-help": "^6.2.55",
+    "@oclif/core": "^4.13.3",
+    "@oclif/plugin-help": "^6.2.56",
     "@sanity-labs/design-tokens": "^0.0.2-alpha.2",
-    "@sanity/blueprints": "^0.23.1",
+    "@sanity-labs/oclif-plugin-skills-flag": "^0.2.1",
+    "@sanity/blueprints": "^0.23.2",
     "@sanity/blueprints-parser": "^0.4.0",
     "@sanity/cli-build": "^5.1.0",
-    "@sanity/cli-core": "^2.7.1",
-    "@sanity/client": "^7.26.0",
+    "@sanity/cli-core": "^2.8.1",
+    "@sanity/client": "^7.26.2",
     "adm-zip": "^0.6.0",
     "array-treeify": "^0.1.5",
     "cardinal": "^2.1.1",
     "empathic": "^2.0.1",
-    "eventsource": "^4.1.0",
+    "eventsource": "^4.1.1",
     "groq-js": "^2.0.0",
     "jiti": "^2.7.0",
     "mime-types": "^3.0.2",
@@ -84,12 +87,12 @@
     "strip-ansi": "^7.2.0",
     "tar-fs": "^3.1.3",
     "tar-stream": "^3.2.0",
-    "vite": "^8.1.5",
-    "ws": "^8.21.1",
+    "vite": "^8.2.1",
+    "ws": "^8.21.3",
     "xdg-basedir": "^5.1.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.5.6",
+    "@biomejs/biome": "2.5.7",
     "@codemirror/lang-json": "^6.0.2",
     "@codemirror/state": "^6.7.1",
     "@enhance/store": "^1.0.2",
@@ -97,7 +100,7 @@
     "@oclif/test": "^4.1.21",
     "@playwright/test": "^1.62.1",
     "@rollup/plugin-node-resolve": "^16.0.3",
-    "@sanity/functions": "^1.5.0",
+    "@sanity/functions": "^1.6.0",
     "@types/adm-zip": "^0.5.8",
     "@types/cardinal": "^2.1.1",
     "@types/mime-types": "^3.0.1",
@@ -108,10 +111,10 @@
     "@vitest/coverage-v8": "4.1.10",
     "codemirror": "^6.0.2",
     "mentoss": "^0.13.0",
-    "oclif": "^4.23.29",
+    "oclif": "^4.23.30",
     "pretty-bytes": "^7.1.1",
     "pretty-ms": "^9.3.0",
-    "rollup": "^4.62.3",
+    "rollup": "^4.62.4",
     "shx": "^0.4.0",
     "typescript": "^7.0.2",
     "vitest": "4.1.10"
@@ -121,7 +124,8 @@
     "dirname": "sanity-run",
     "commands": "./dist/commands",
     "plugins": [
-      "@oclif/plugin-help"
+      "@oclif/plugin-help",
+      "@sanity-labs/oclif-plugin-skills-flag"
     ],
     "topicSeparator": " ",
     "topics": {
@@ -133,6 +137,16 @@
       }
     }
   },
+  "oclif-plugin-skills-flag": {
+    "flag": "skill",
+    "aliases": [
+      "agent",
+      "llm",
+      "llms",
+      "skills"
+    ],
+    "directory": "skills"
+  },
   "publishConfig": {
     "access": "public",
     "provenance": false

package/skills/_functions-build.md

@@ -0,0 +1,23 @@
+# `npx @sanity/cli functions build`
+
+Build local Functions into zip archives. This command is hidden from generated help; use it when archive artifacts are explicitly needed, not as a required step before `blueprints deploy`.
+
+## Build
+
+Build every local Function in the Blueprint:
+
+```sh
+npx @sanity/cli functions build --json
+```
+
+Build one Function into a chosen directory:
+
+```sh
+npx @sanity/cli functions build process-order --out-dir artifacts/functions --json
+```
+
+Without `--out-dir`, archives are written to `.build/` beside the Blueprint manifest. An existing archive with the same Function name is replaced.
+
+The JSON result contains `built`, `errors`, and `outDir`. A run can succeed when some Functions build and others fail, so inspect `errors` even when the exit code is zero. If every build fails, the command exits with an error.
+
+The `.gitignore` written by `blueprints init` covers `functions/**/.build/`, not the top-level `.build/` these archives land in, so exclude the output directory before committing.

package/skills/_functions-list.md

@@ -0,0 +1,28 @@
+# `npx @sanity/cli functions list`
+
+List Functions deployed in a project or organization scope. This command is hidden from generated help. Results cover the whole scope rather than one Stack; use `blueprints info` for the resources of a single Stack.
+
+## Run
+
+Use the locally configured scope:
+
+```sh
+npx @sanity/cli functions list --json
+```
+
+Select a scope explicitly when working outside a local Blueprint:
+
+```sh
+npx @sanity/cli functions list --project-id PROJECT_ID --json
+npx @sanity/cli functions list --organization-id ORGANIZATION_ID --json
+```
+
+The two flags are mutually exclusive. No Blueprint manifest is required: the scope resolves from those flags, from `SANITY_PROJECT_ID` or `SANITY_ORGANIZATION_ID`, or from `.sanity/blueprint.config.json`, and the command fails with `Missing scope` when none of them do. The scope is sent with the request, so a project and its organization return different sets: scheduled Functions are organization-scoped, every other type is project-scoped.
+
+## Read the result
+
+The JSON result contains `functions`, `scopeType`, and `scopeId`. Each entry carries `id`, `name`, `displayName`, `type`, `runtime`, `status`, `memory`, `storage`, `timeout`, `resourceType`, `resourceId`, `url`, `createdAt`, and `updatedAt`. An empty scope still emits `{"functions": []}` and exits `0`, so check the array length rather than the exit code.
+
+Default output is one line per Function with its name, ID, type, and last update time. `--verbose` (`-v`) instead prints the type, update time, memory, timeout, and event rule of each.
+
+Treat this as an inspection command. `functions logs`, `functions env add`, and `functions env remove` address a Function by its Blueprint resource name resolved through the deployed Stack, not by the `id` shown here.

package/skills/blueprints-add.md

@@ -0,0 +1,8 @@
+# `npx @sanity/cli blueprints add`
+
+Treat this command as legacy compatibility only. It is deprecated and supports only the `function` resource type. Prefer `npx @sanity/cli functions add` for new work.
+
+## Agent guidance
+
+- Warn that the command is deprecated before adding new usage to scripts or documentation.
+- Migrate existing legacy invocations to `npx @sanity/cli functions add`.