@sanity/workbench-cli 1.4.0 → 1.6.0

package/dist/actions/deploy/buildExposes.js

@@ -1,27 +1,40 @@
+import { interfaceModuleId } from '../../contract.js';
 /**
  * The interface records deploy sends: the app view (only when `exposesAppView`),
  * every view, and every service.
  * @internal
  */ export function buildExposes(exposes, { appName, appTitle, exposesAppView, version }) {
-    const toRecord = (prefix, decl)=>({
-            moduleId: `${prefix}/${decl.name}`,
-            name: decl.name,
-            title: decl.title ?? decl.name,
-            type: decl.type,
-            version
-        });
     const records = [];
     if (exposesAppView) {
         records.push({
-            moduleId: 'App',
+            metadata: null,
+            moduleId: interfaceModuleId('app', appName),
             name: appName,
             title: appTitle,
             type: 'app',
             version
         });
     }
-    for (const view of exposes.views ?? [])records.push(toRecord('views', view));
-    for (const service of exposes.services ?? [])records.push(toRecord('services', service));
+    for (const view of exposes.views ?? []){
+        records.push({
+            metadata: null,
+            moduleId: interfaceModuleId('panel', view.name),
+            name: view.name,
+            title: view.title ?? view.name,
+            type: 'panel',
+            version
+        });
+    }
+    for (const service of exposes.services ?? []){
+        records.push({
+            metadata: null,
+            moduleId: interfaceModuleId('worker', service.name),
+            name: service.name,
+            title: service.title ?? service.name,
+            type: 'worker',
+            version
+        });
+    }
     return records;
 }
 const label = (item)=>item.title === item.name ? item.name : `${item.title} (${item.name})`;

package/dist/actions/deploy/buildExposes.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/actions/deploy/buildExposes.ts"],"sourcesContent":["import {type WorkbenchExposes} from '../../resolveWorkbenchApp.js'\nimport {type BrettInterface} from '../../services/applications.js'\n\ninterface BuildExposesContext {\n  appName: string\n  appTitle: string\n  /** Whether the build exposes the app view (`./App`) — apps with an `entry`, and every studio. */\n  exposesAppView: boolean\n  version: string\n}\n\n/**\n * The interface records deploy sends: the app view (only when `exposesAppView`),\n * every view, and every service.\n * @internal\n */\nexport function buildExposes(\n  exposes: WorkbenchExposes,\n  {appName, appTitle, exposesAppView, version}: BuildExposesContext,\n): BrettInterface[] {\n  const toRecord = (\n    prefix: string,\n    decl: {name: string; title?: string; type: string},\n  ): BrettInterface => ({\n    moduleId: `${prefix}/${decl.name}`,\n    name: decl.name,\n    title: decl.title ?? decl.name,\n    type: decl.type,\n    version,\n  })\n\n  const records: BrettInterface[] = []\n  if (exposesAppView) {\n    records.push({moduleId: 'App', name: appName, title: appTitle, type: 'app', version})\n  }\n  for (const view of exposes.views ?? []) records.push(toRecord('views', view))\n  for (const service of exposes.services ?? []) records.push(toRecord('services', service))\n  return records\n}\n\n/** A view or service as the deploy report and `--json` output surface it. */\nexport interface DeployedExpose {\n  name: string\n  src: string\n  title: string\n  type: string\n}\n\nconst label = (item: {name: string; title: string}) =>\n  item.title === item.name ? item.name : `${item.title} (${item.name})`\n\n/**\n * One `Title (name): src` report line per declared entry point.\n * @internal\n */\nexport function summarizeExposeGroup(\n  heading: string,\n  items: readonly {name: string; src: string; title: string}[],\n): string {\n  return `${heading}:\\n${items.map((item) => `  ${label(item)}: ${item.src}`).join('\\n')}`\n}\n\n/**\n * The deploy summary of an app's exposes: the structured records (for `--json`)\n * and one report line per non-empty group (for the human report).\n * @internal\n */\nexport function summarizeExposes({services, views}: WorkbenchExposes): {\n  exposes: DeployedExpose[]\n  lines: string[]\n} {\n  const toExpose = (decl: {\n    name: string\n    src: string\n    title?: string\n    type: string\n  }): DeployedExpose => ({\n    name: decl.name,\n    src: decl.src,\n    title: decl.title ?? decl.name,\n    type: decl.type,\n  })\n  const viewExposes = (views ?? []).map((view) => toExpose(view))\n  const serviceExposes = (services ?? []).map((service) => toExpose(service))\n\n  const lines: string[] = []\n  if (viewExposes.length > 0) lines.push(summarizeExposeGroup('Views', viewExposes))\n  if (serviceExposes.length > 0) lines.push(summarizeExposeGroup('Services', serviceExposes))\n  return {exposes: [...viewExposes, ...serviceExposes], lines}\n}\n"],"names":["buildExposes","exposes","appName","appTitle","exposesAppView","version","toRecord","prefix","decl","moduleId","name","title","type","records","push","view","views","service","services","label","item","summarizeExposeGroup","heading","items","map","src","join","summarizeExposes","toExpose","viewExposes","serviceExposes","lines","length"],"mappings":"AAWA;;;;CAIC,GACD,OAAO,SAASA,aACdC,OAAyB,EACzB,EAACC,OAAO,EAAEC,QAAQ,EAAEC,cAAc,EAAEC,OAAO,EAAsB;IAEjE,MAAMC,WAAW,CACfC,QACAC,OACoB,CAAA;YACpBC,UAAU,GAAGF,OAAO,CAAC,EAAEC,KAAKE,IAAI,EAAE;YAClCA,MAAMF,KAAKE,IAAI;YACfC,OAAOH,KAAKG,KAAK,IAAIH,KAAKE,IAAI;YAC9BE,MAAMJ,KAAKI,IAAI;YACfP;QACF,CAAA;IAEA,MAAMQ,UAA4B,EAAE;IACpC,IAAIT,gBAAgB;QAClBS,QAAQC,IAAI,CAAC;YAACL,UAAU;YAAOC,MAAMR;YAASS,OAAOR;YAAUS,MAAM;YAAOP;QAAO;IACrF;IACA,KAAK,MAAMU,QAAQd,QAAQe,KAAK,IAAI,EAAE,CAAEH,QAAQC,IAAI,CAACR,SAAS,SAASS;IACvE,KAAK,MAAME,WAAWhB,QAAQiB,QAAQ,IAAI,EAAE,CAAEL,QAAQC,IAAI,CAACR,SAAS,YAAYW;IAChF,OAAOJ;AACT;AAUA,MAAMM,QAAQ,CAACC,OACbA,KAAKT,KAAK,KAAKS,KAAKV,IAAI,GAAGU,KAAKV,IAAI,GAAG,GAAGU,KAAKT,KAAK,CAAC,EAAE,EAAES,KAAKV,IAAI,CAAC,CAAC,CAAC;AAEvE;;;CAGC,GACD,OAAO,SAASW,qBACdC,OAAe,EACfC,KAA4D;IAE5D,OAAO,GAAGD,QAAQ,GAAG,EAAEC,MAAMC,GAAG,CAAC,CAACJ,OAAS,CAAC,EAAE,EAAED,MAAMC,MAAM,EAAE,EAAEA,KAAKK,GAAG,EAAE,EAAEC,IAAI,CAAC,OAAO;AAC1F;AAEA;;;;CAIC,GACD,OAAO,SAASC,iBAAiB,EAACT,QAAQ,EAAEF,KAAK,EAAmB;IAIlE,MAAMY,WAAW,CAACpB,OAKK,CAAA;YACrBE,MAAMF,KAAKE,IAAI;YACfe,KAAKjB,KAAKiB,GAAG;YACbd,OAAOH,KAAKG,KAAK,IAAIH,KAAKE,IAAI;YAC9BE,MAAMJ,KAAKI,IAAI;QACjB,CAAA;IACA,MAAMiB,cAAc,AAACb,CAAAA,SAAS,EAAE,AAAD,EAAGQ,GAAG,CAAC,CAACT,OAASa,SAASb;IACzD,MAAMe,iBAAiB,AAACZ,CAAAA,YAAY,EAAE,AAAD,EAAGM,GAAG,CAAC,CAACP,UAAYW,SAASX;IAElE,MAAMc,QAAkB,EAAE;IAC1B,IAAIF,YAAYG,MAAM,GAAG,GAAGD,MAAMjB,IAAI,CAACO,qBAAqB,SAASQ;IACrE,IAAIC,eAAeE,MAAM,GAAG,GAAGD,MAAMjB,IAAI,CAACO,qBAAqB,YAAYS;IAC3E,OAAO;QAAC7B,SAAS;eAAI4B;eAAgBC;SAAe;QAAEC;IAAK;AAC7D"}
+{"version":3,"sources":["../../../src/actions/deploy/buildExposes.ts"],"sourcesContent":["import {interfaceModuleId} from '../../contract.js'\nimport {type WorkbenchExposes} from '../../resolveWorkbenchApp.js'\nimport {type BrettInterface} from '../../services/applications.js'\n\ninterface BuildExposesContext {\n  appName: string\n  appTitle: string\n  /** Whether the build exposes the app view (`./App`) — apps with an `entry`, and every studio. */\n  exposesAppView: boolean\n  version: string\n}\n\n/**\n * The interface records deploy sends: the app view (only when `exposesAppView`),\n * every view, and every service.\n * @internal\n */\nexport function buildExposes(\n  exposes: WorkbenchExposes,\n  {appName, appTitle, exposesAppView, version}: BuildExposesContext,\n): BrettInterface[] {\n  const records: BrettInterface[] = []\n  if (exposesAppView) {\n    records.push({\n      metadata: null,\n      moduleId: interfaceModuleId('app', appName),\n      name: appName,\n      title: appTitle,\n      type: 'app',\n      version,\n    })\n  }\n  for (const view of exposes.views ?? []) {\n    records.push({\n      metadata: null,\n      moduleId: interfaceModuleId('panel', view.name),\n      name: view.name,\n      title: view.title ?? view.name,\n      type: 'panel',\n      version,\n    })\n  }\n  for (const service of exposes.services ?? []) {\n    records.push({\n      metadata: null,\n      moduleId: interfaceModuleId('worker', service.name),\n      name: service.name,\n      title: service.title ?? service.name,\n      type: 'worker',\n      version,\n    })\n  }\n  return records\n}\n\n/** A view or service as the deploy report and `--json` output surface it. */\nexport interface DeployedExpose {\n  name: string\n  src: string\n  title: string\n  type: string\n}\n\nconst label = (item: {name: string; title: string}) =>\n  item.title === item.name ? item.name : `${item.title} (${item.name})`\n\n/**\n * One `Title (name): src` report line per declared entry point.\n * @internal\n */\nexport function summarizeExposeGroup(\n  heading: string,\n  items: readonly {name: string; src: string; title: string}[],\n): string {\n  return `${heading}:\\n${items.map((item) => `  ${label(item)}: ${item.src}`).join('\\n')}`\n}\n\n/**\n * The deploy summary of an app's exposes: the structured records (for `--json`)\n * and one report line per non-empty group (for the human report).\n * @internal\n */\nexport function summarizeExposes({services, views}: WorkbenchExposes): {\n  exposes: DeployedExpose[]\n  lines: string[]\n} {\n  const toExpose = (decl: {\n    name: string\n    src: string\n    title?: string\n    type: string\n  }): DeployedExpose => ({\n    name: decl.name,\n    src: decl.src,\n    title: decl.title ?? decl.name,\n    type: decl.type,\n  })\n  const viewExposes = (views ?? []).map((view) => toExpose(view))\n  const serviceExposes = (services ?? []).map((service) => toExpose(service))\n\n  const lines: string[] = []\n  if (viewExposes.length > 0) lines.push(summarizeExposeGroup('Views', viewExposes))\n  if (serviceExposes.length > 0) lines.push(summarizeExposeGroup('Services', serviceExposes))\n  return {exposes: [...viewExposes, ...serviceExposes], lines}\n}\n"],"names":["interfaceModuleId","buildExposes","exposes","appName","appTitle","exposesAppView","version","records","push","metadata","moduleId","name","title","type","view","views","service","services","label","item","summarizeExposeGroup","heading","items","map","src","join","summarizeExposes","toExpose","decl","viewExposes","serviceExposes","lines","length"],"mappings":"AAAA,SAAQA,iBAAiB,QAAO,oBAAmB;AAYnD;;;;CAIC,GACD,OAAO,SAASC,aACdC,OAAyB,EACzB,EAACC,OAAO,EAAEC,QAAQ,EAAEC,cAAc,EAAEC,OAAO,EAAsB;IAEjE,MAAMC,UAA4B,EAAE;IACpC,IAAIF,gBAAgB;QAClBE,QAAQC,IAAI,CAAC;YACXC,UAAU;YACVC,UAAUV,kBAAkB,OAAOG;YACnCQ,MAAMR;YACNS,OAAOR;YACPS,MAAM;YACNP;QACF;IACF;IACA,KAAK,MAAMQ,QAAQZ,QAAQa,KAAK,IAAI,EAAE,CAAE;QACtCR,QAAQC,IAAI,CAAC;YACXC,UAAU;YACVC,UAAUV,kBAAkB,SAASc,KAAKH,IAAI;YAC9CA,MAAMG,KAAKH,IAAI;YACfC,OAAOE,KAAKF,KAAK,IAAIE,KAAKH,IAAI;YAC9BE,MAAM;YACNP;QACF;IACF;IACA,KAAK,MAAMU,WAAWd,QAAQe,QAAQ,IAAI,EAAE,CAAE;QAC5CV,QAAQC,IAAI,CAAC;YACXC,UAAU;YACVC,UAAUV,kBAAkB,UAAUgB,QAAQL,IAAI;YAClDA,MAAMK,QAAQL,IAAI;YAClBC,OAAOI,QAAQJ,KAAK,IAAII,QAAQL,IAAI;YACpCE,MAAM;YACNP;QACF;IACF;IACA,OAAOC;AACT;AAUA,MAAMW,QAAQ,CAACC,OACbA,KAAKP,KAAK,KAAKO,KAAKR,IAAI,GAAGQ,KAAKR,IAAI,GAAG,GAAGQ,KAAKP,KAAK,CAAC,EAAE,EAAEO,KAAKR,IAAI,CAAC,CAAC,CAAC;AAEvE;;;CAGC,GACD,OAAO,SAASS,qBACdC,OAAe,EACfC,KAA4D;IAE5D,OAAO,GAAGD,QAAQ,GAAG,EAAEC,MAAMC,GAAG,CAAC,CAACJ,OAAS,CAAC,EAAE,EAAED,MAAMC,MAAM,EAAE,EAAEA,KAAKK,GAAG,EAAE,EAAEC,IAAI,CAAC,OAAO;AAC1F;AAEA;;;;CAIC,GACD,OAAO,SAASC,iBAAiB,EAACT,QAAQ,EAAEF,KAAK,EAAmB;IAIlE,MAAMY,WAAW,CAACC,OAKK,CAAA;YACrBjB,MAAMiB,KAAKjB,IAAI;YACfa,KAAKI,KAAKJ,GAAG;YACbZ,OAAOgB,KAAKhB,KAAK,IAAIgB,KAAKjB,IAAI;YAC9BE,MAAMe,KAAKf,IAAI;QACjB,CAAA;IACA,MAAMgB,cAAc,AAACd,CAAAA,SAAS,EAAE,AAAD,EAAGQ,GAAG,CAAC,CAACT,OAASa,SAASb;IACzD,MAAMgB,iBAAiB,AAACb,CAAAA,YAAY,EAAE,AAAD,EAAGM,GAAG,CAAC,CAACP,UAAYW,SAASX;IAElE,MAAMe,QAAkB,EAAE;IAC1B,IAAIF,YAAYG,MAAM,GAAG,GAAGD,MAAMvB,IAAI,CAACY,qBAAqB,SAASS;IACrE,IAAIC,eAAeE,MAAM,GAAG,GAAGD,MAAMvB,IAAI,CAACY,qBAAqB,YAAYU;IAC3E,OAAO;QAAC5B,SAAS;eAAI2B;eAAgBC;SAAe;QAAEC;IAAK;AAC7D"}

package/dist/actions/deploy/checkBuiltOutput.js

@@ -1,5 +1,15 @@
 import { stat } from 'node:fs/promises';
 import { join } from 'node:path';
+/**
+ * A genuinely-missing-build error, named so callers can offer the "run sanity
+ * build" hint (the `preview` command keys off this name, matching how the studio
+ * path keys off a missing `index.html`). Only the missing cases get it — real
+ * I/O failures keep their own name so they surface as themselves.
+ */ function buildNotFound(message) {
+    const error = new Error(message);
+    error.name = 'BUILD_NOT_FOUND';
+    return error;
+}
 /**
  * Throws unless `sourceDir` is a directory holding a federation build.
  * A workbench build always emits a module-federation remote, and may
@@ -13,13 +23,17 @@ import { join } from 'node:path';
             throw new Error(`"${sourceDir}" is not a directory`);
         }
     } catch (err) {
-        throw err.code === 'ENOENT' ? new Error(`Directory "${sourceDir}" does not exist`) : err;
+        if (err.code === 'ENOENT') throw buildNotFound(`Directory "${sourceDir}" does not exist`);
+        throw err;
     }
     const manifestPath = join(sourceDir, 'mf-manifest.json');
     try {
         await stat(manifestPath);
     } catch (err) {
-        throw err.code === 'ENOENT' ? new Error(`"${manifestPath}" does not exist. ` + 'The deploy directory must contain a federation build created with "sanity build".') : err;
+        if (err.code === 'ENOENT') {
+            throw buildNotFound(`"${manifestPath}" does not exist. ` + 'The deploy directory must contain a federation build created with "sanity build".');
+        }
+        throw err;
     }
 }
 

package/dist/actions/deploy/checkBuiltOutput.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/actions/deploy/checkBuiltOutput.ts"],"sourcesContent":["import {stat} from 'node:fs/promises'\nimport {join} from 'node:path'\n\n/**\n * Throws unless `sourceDir` is a directory holding a federation build.\n * A workbench build always emits a module-federation remote, and may\n * additionally emit a standalone `index.html` SPA (workbench remotes). Either\n * way `mf-manifest.json` is the reliable marker that `sanity build` produced a\n * federation build, so that — not `index.html` — is what we check for.\n */\nexport async function checkBuiltOutput(sourceDir: string): Promise<void> {\n  try {\n    const stats = await stat(sourceDir)\n    if (!stats.isDirectory()) {\n      throw new Error(`\"${sourceDir}\" is not a directory`)\n    }\n  } catch (err) {\n    throw err.code === 'ENOENT' ? new Error(`Directory \"${sourceDir}\" does not exist`) : err\n  }\n\n  const manifestPath = join(sourceDir, 'mf-manifest.json')\n  try {\n    await stat(manifestPath)\n  } catch (err) {\n    throw err.code === 'ENOENT'\n      ? new Error(\n          `\"${manifestPath}\" does not exist. ` +\n            'The deploy directory must contain a federation build created with \"sanity build\".',\n        )\n      : err\n  }\n}\n"],"names":["stat","join","checkBuiltOutput","sourceDir","stats","isDirectory","Error","err","code","manifestPath"],"mappings":"AAAA,SAAQA,IAAI,QAAO,mBAAkB;AACrC,SAAQC,IAAI,QAAO,YAAW;AAE9B;;;;;;CAMC,GACD,OAAO,eAAeC,iBAAiBC,SAAiB;IACtD,IAAI;QACF,MAAMC,QAAQ,MAAMJ,KAAKG;QACzB,IAAI,CAACC,MAAMC,WAAW,IAAI;YACxB,MAAM,IAAIC,MAAM,CAAC,CAAC,EAAEH,UAAU,oBAAoB,CAAC;QACrD;IACF,EAAE,OAAOI,KAAK;QACZ,MAAMA,IAAIC,IAAI,KAAK,WAAW,IAAIF,MAAM,CAAC,WAAW,EAAEH,UAAU,gBAAgB,CAAC,IAAII;IACvF;IAEA,MAAME,eAAeR,KAAKE,WAAW;IACrC,IAAI;QACF,MAAMH,KAAKS;IACb,EAAE,OAAOF,KAAK;QACZ,MAAMA,IAAIC,IAAI,KAAK,WACf,IAAIF,MACF,CAAC,CAAC,EAAEG,aAAa,kBAAkB,CAAC,GAClC,uFAEJF;IACN;AACF"}
+{"version":3,"sources":["../../../src/actions/deploy/checkBuiltOutput.ts"],"sourcesContent":["import {stat} from 'node:fs/promises'\nimport {join} from 'node:path'\n\n/**\n * A genuinely-missing-build error, named so callers can offer the \"run sanity\n * build\" hint (the `preview` command keys off this name, matching how the studio\n * path keys off a missing `index.html`). Only the missing cases get it — real\n * I/O failures keep their own name so they surface as themselves.\n */\nfunction buildNotFound(message: string): Error {\n  const error = new Error(message)\n  error.name = 'BUILD_NOT_FOUND'\n  return error\n}\n\n/**\n * Throws unless `sourceDir` is a directory holding a federation build.\n * A workbench build always emits a module-federation remote, and may\n * additionally emit a standalone `index.html` SPA (workbench remotes). Either\n * way `mf-manifest.json` is the reliable marker that `sanity build` produced a\n * federation build, so that — not `index.html` — is what we check for.\n */\nexport async function checkBuiltOutput(sourceDir: string): Promise<void> {\n  try {\n    const stats = await stat(sourceDir)\n    if (!stats.isDirectory()) {\n      throw new Error(`\"${sourceDir}\" is not a directory`)\n    }\n  } catch (err) {\n    if (err.code === 'ENOENT') throw buildNotFound(`Directory \"${sourceDir}\" does not exist`)\n    throw err\n  }\n\n  const manifestPath = join(sourceDir, 'mf-manifest.json')\n  try {\n    await stat(manifestPath)\n  } catch (err) {\n    if (err.code === 'ENOENT') {\n      throw buildNotFound(\n        `\"${manifestPath}\" does not exist. ` +\n          'The deploy directory must contain a federation build created with \"sanity build\".',\n      )\n    }\n    throw err\n  }\n}\n"],"names":["stat","join","buildNotFound","message","error","Error","name","checkBuiltOutput","sourceDir","stats","isDirectory","err","code","manifestPath"],"mappings":"AAAA,SAAQA,IAAI,QAAO,mBAAkB;AACrC,SAAQC,IAAI,QAAO,YAAW;AAE9B;;;;;CAKC,GACD,SAASC,cAAcC,OAAe;IACpC,MAAMC,QAAQ,IAAIC,MAAMF;IACxBC,MAAME,IAAI,GAAG;IACb,OAAOF;AACT;AAEA;;;;;;CAMC,GACD,OAAO,eAAeG,iBAAiBC,SAAiB;IACtD,IAAI;QACF,MAAMC,QAAQ,MAAMT,KAAKQ;QACzB,IAAI,CAACC,MAAMC,WAAW,IAAI;YACxB,MAAM,IAAIL,MAAM,CAAC,CAAC,EAAEG,UAAU,oBAAoB,CAAC;QACrD;IACF,EAAE,OAAOG,KAAK;QACZ,IAAIA,IAAIC,IAAI,KAAK,UAAU,MAAMV,cAAc,CAAC,WAAW,EAAEM,UAAU,gBAAgB,CAAC;QACxF,MAAMG;IACR;IAEA,MAAME,eAAeZ,KAAKO,WAAW;IACrC,IAAI;QACF,MAAMR,KAAKa;IACb,EAAE,OAAOF,KAAK;QACZ,IAAIA,IAAIC,IAAI,KAAK,UAAU;YACzB,MAAMV,cACJ,CAAC,CAAC,EAAEW,aAAa,kBAAkB,CAAC,GAClC;QAEN;QACA,MAAMF;IACR;AACF"}

package/dist/actions/deploy/deployWorkbenchApp.js

@@ -3,14 +3,14 @@ import { createGzip } from 'node:zlib';
 import { exitCodes } from '@sanity/cli-core';
 import { spinner } from '@sanity/cli-core/ux';
 import { pack } from 'tar-fs';
-import { createApplication, createDeployment } from '../../services/applications.js';
+import { createApplication, createDeployment, updateApplication } from '../../services/applications.js';
 /**
  * Deploy a workbench coreApp through Brett: redeploy when `appId` is set,
  * otherwise create the application at `slug`. Returns the application id for the
  * shell to report.
  * @internal
  */ export async function deployCoreApp(options) {
-    const { appId, interfaces, isAutoUpdating, isSingleton, organizationId, slug, sourceDir, title, version } = options;
+    const { appId, icon, interfaces, isAutoUpdating, isSingleton, organizationId, slug, sourceDir, title, version, visibility } = options;
     const tarball = pack(dirname(sourceDir), {
         entries: [
             basename(sourceDir)
@@ -26,12 +26,19 @@ import { createApplication, createDeployment } from '../../services/applications
                 tarball,
                 version
             });
+            await updateApplication(appId, {
+                title,
+                ...icon ? {
+                    icon
+                } : {}
+            });
             spin.succeed();
             return {
                 applicationId: appId
             };
         }
         const { id } = await createApplication({
+            icon,
             interfaces,
             isSingleton,
             organizationId,
@@ -39,7 +46,8 @@ import { createApplication, createDeployment } from '../../services/applications
             tarball,
             title,
             type: 'coreApp',
-            version
+            version,
+            visibility
         });
         spin.succeed();
         return {
@@ -56,7 +64,7 @@ import { createApplication, createDeployment } from '../../services/applications
  * the shell to report; a missing `studioHost` on create is a usage error.
  * @internal
  */ export async function deployStudio(options) {
-    const { appId, interfaces, isAutoUpdating, organizationId, output, projectId, sourceDir, studioHost, title, version, workspaces } = options;
+    const { appId, icon, interfaces, isAutoUpdating, organizationId, output, projectId, sourceDir, studioHost, title, version, workspaces } = options;
     const tarball = pack(dirname(sourceDir), {
         entries: [
             basename(sourceDir)
@@ -73,6 +81,12 @@ import { createApplication, createDeployment } from '../../services/applications
                 version,
                 workspaces
             });
+            await updateApplication(appId, {
+                title,
+                ...icon ? {
+                    icon
+                } : {}
+            });
             spin.succeed();
             return {
                 applicationId: appId
@@ -85,6 +99,7 @@ import { createApplication, createDeployment } from '../../services/applications
             });
         }
         const application = await createApplication({
+            icon,
             interfaces,
             organizationId,
             projectId,

package/dist/actions/deploy/deployWorkbenchApp.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/actions/deploy/deployWorkbenchApp.ts"],"sourcesContent":["import {basename, dirname} from 'node:path'\nimport {createGzip} from 'node:zlib'\n\nimport {exitCodes, type Output} from '@sanity/cli-core'\nimport {spinner} from '@sanity/cli-core/ux'\nimport {pack} from 'tar-fs'\n\nimport {\n  type BrettInterface,\n  type BrettWorkspace,\n  createApplication,\n  createDeployment,\n} from '../../services/applications.js'\n\n/**\n * Deploy a workbench coreApp through Brett: redeploy when `appId` is set,\n * otherwise create the application at `slug`. Returns the application id for the\n * shell to report.\n * @internal\n */\nexport async function deployCoreApp(options: {\n  appId: string | undefined\n  interfaces: readonly BrettInterface[]\n  isAutoUpdating: boolean\n  isSingleton?: boolean\n  organizationId: string\n  slug: string\n  sourceDir: string\n  title: string\n  version: string\n}): Promise<{applicationId: string}> {\n  const {\n    appId,\n    interfaces,\n    isAutoUpdating,\n    isSingleton,\n    organizationId,\n    slug,\n    sourceDir,\n    title,\n    version,\n  } = options\n  const tarball = pack(dirname(sourceDir), {entries: [basename(sourceDir)]}).pipe(createGzip())\n\n  const spin = spinner('Deploying...').start()\n  try {\n    if (appId) {\n      await createDeployment({applicationId: appId, interfaces, isAutoUpdating, tarball, version})\n      spin.succeed()\n      return {applicationId: appId}\n    }\n\n    const {id} = await createApplication({\n      interfaces,\n      isSingleton,\n      organizationId,\n      slug,\n      tarball,\n      title,\n      type: 'coreApp',\n      version,\n    })\n    spin.succeed()\n    return {applicationId: id}\n  } catch (error) {\n    spin.clear()\n    throw error\n  }\n}\n\n/**\n * Deploy a workbench studio through Brett: redeploy when `appId` is set,\n * otherwise create the studio at `studioHost`. Returns the application id for\n * the shell to report; a missing `studioHost` on create is a usage error.\n * @internal\n */\nexport async function deployStudio(options: {\n  appId: string | undefined\n  interfaces: readonly BrettInterface[]\n  isAutoUpdating: boolean\n  organizationId: string\n  output: Output\n  projectId: string | undefined\n  sourceDir: string\n  studioHost: string | undefined\n  title: string\n  version: string\n  workspaces: readonly BrettWorkspace[]\n}): Promise<{applicationId: string}> {\n  const {\n    appId,\n    interfaces,\n    isAutoUpdating,\n    organizationId,\n    output,\n    projectId,\n    sourceDir,\n    studioHost,\n    title,\n    version,\n    workspaces,\n  } = options\n  const tarball = pack(dirname(sourceDir), {entries: [basename(sourceDir)]}).pipe(createGzip())\n\n  const spin = spinner('Deploying to sanity.studio').start()\n  try {\n    if (appId) {\n      await createDeployment({\n        applicationId: appId,\n        interfaces,\n        isAutoUpdating,\n        tarball,\n        version,\n        workspaces,\n      })\n      spin.succeed()\n      return {applicationId: appId}\n    }\n\n    if (!studioHost) {\n      spin.fail()\n      return output.error(\n        'No studio hostname configured. Set `studioHost` in sanity.cli.ts to create a studio.',\n        {exit: exitCodes.USAGE_ERROR},\n      )\n    }\n\n    const application = await createApplication({\n      interfaces,\n      organizationId,\n      projectId,\n      slug: studioHost,\n      tarball,\n      title,\n      type: 'studio',\n      version,\n      workspaces,\n    })\n    spin.succeed()\n    return {applicationId: application.id}\n  } catch (error) {\n    spin.fail()\n    throw error\n  }\n}\n"],"names":["basename","dirname","createGzip","exitCodes","spinner","pack","createApplication","createDeployment","deployCoreApp","options","appId","interfaces","isAutoUpdating","isSingleton","organizationId","slug","sourceDir","title","version","tarball","entries","pipe","spin","start","applicationId","succeed","id","type","error","clear","deployStudio","output","projectId","studioHost","workspaces","fail","exit","USAGE_ERROR","application"],"mappings":"AAAA,SAAQA,QAAQ,EAAEC,OAAO,QAAO,YAAW;AAC3C,SAAQC,UAAU,QAAO,YAAW;AAEpC,SAAQC,SAAS,QAAoB,mBAAkB;AACvD,SAAQC,OAAO,QAAO,sBAAqB;AAC3C,SAAQC,IAAI,QAAO,SAAQ;AAE3B,SAGEC,iBAAiB,EACjBC,gBAAgB,QACX,iCAAgC;AAEvC;;;;;CAKC,GACD,OAAO,eAAeC,cAAcC,OAUnC;IACC,MAAM,EACJC,KAAK,EACLC,UAAU,EACVC,cAAc,EACdC,WAAW,EACXC,cAAc,EACdC,IAAI,EACJC,SAAS,EACTC,KAAK,EACLC,OAAO,EACR,GAAGT;IACJ,MAAMU,UAAUd,KAAKJ,QAAQe,YAAY;QAACI,SAAS;YAACpB,SAASgB;SAAW;IAAA,GAAGK,IAAI,CAACnB;IAEhF,MAAMoB,OAAOlB,QAAQ,gBAAgBmB,KAAK;IAC1C,IAAI;QACF,IAAIb,OAAO;YACT,MAAMH,iBAAiB;gBAACiB,eAAed;gBAAOC;gBAAYC;gBAAgBO;gBAASD;YAAO;YAC1FI,KAAKG,OAAO;YACZ,OAAO;gBAACD,eAAed;YAAK;QAC9B;QAEA,MAAM,EAACgB,EAAE,EAAC,GAAG,MAAMpB,kBAAkB;YACnCK;YACAE;YACAC;YACAC;YACAI;YACAF;YACAU,MAAM;YACNT;QACF;QACAI,KAAKG,OAAO;QACZ,OAAO;YAACD,eAAeE;QAAE;IAC3B,EAAE,OAAOE,OAAO;QACdN,KAAKO,KAAK;QACV,MAAMD;IACR;AACF;AAEA;;;;;CAKC,GACD,OAAO,eAAeE,aAAarB,OAYlC;IACC,MAAM,EACJC,KAAK,EACLC,UAAU,EACVC,cAAc,EACdE,cAAc,EACdiB,MAAM,EACNC,SAAS,EACThB,SAAS,EACTiB,UAAU,EACVhB,KAAK,EACLC,OAAO,EACPgB,UAAU,EACX,GAAGzB;IACJ,MAAMU,UAAUd,KAAKJ,QAAQe,YAAY;QAACI,SAAS;YAACpB,SAASgB;SAAW;IAAA,GAAGK,IAAI,CAACnB;IAEhF,MAAMoB,OAAOlB,QAAQ,8BAA8BmB,KAAK;IACxD,IAAI;QACF,IAAIb,OAAO;YACT,MAAMH,iBAAiB;gBACrBiB,eAAed;gBACfC;gBACAC;gBACAO;gBACAD;gBACAgB;YACF;YACAZ,KAAKG,OAAO;YACZ,OAAO;gBAACD,eAAed;YAAK;QAC9B;QAEA,IAAI,CAACuB,YAAY;YACfX,KAAKa,IAAI;YACT,OAAOJ,OAAOH,KAAK,CACjB,wFACA;gBAACQ,MAAMjC,UAAUkC,WAAW;YAAA;QAEhC;QAEA,MAAMC,cAAc,MAAMhC,kBAAkB;YAC1CK;YACAG;YACAkB;YACAjB,MAAMkB;YACNd;YACAF;YACAU,MAAM;YACNT;YACAgB;QACF;QACAZ,KAAKG,OAAO;QACZ,OAAO;YAACD,eAAec,YAAYZ,EAAE;QAAA;IACvC,EAAE,OAAOE,OAAO;QACdN,KAAKa,IAAI;QACT,MAAMP;IACR;AACF"}
+{"version":3,"sources":["../../../src/actions/deploy/deployWorkbenchApp.ts"],"sourcesContent":["import {basename, dirname} from 'node:path'\nimport {createGzip} from 'node:zlib'\n\nimport {type AppVisibility, exitCodes, type Output} from '@sanity/cli-core'\nimport {spinner} from '@sanity/cli-core/ux'\nimport {pack} from 'tar-fs'\n\nimport {\n  type BrettInterface,\n  type BrettWorkspace,\n  createApplication,\n  createDeployment,\n  updateApplication,\n} from '../../services/applications.js'\n\n/**\n * Deploy a workbench coreApp through Brett: redeploy when `appId` is set,\n * otherwise create the application at `slug`. Returns the application id for the\n * shell to report.\n * @internal\n */\nexport async function deployCoreApp(options: {\n  appId: string | undefined\n  icon?: string\n  interfaces: readonly BrettInterface[]\n  isAutoUpdating: boolean\n  isSingleton?: boolean\n  organizationId: string\n  slug: string\n  sourceDir: string\n  title: string\n  version: string\n  visibility?: AppVisibility\n}): Promise<{applicationId: string}> {\n  const {\n    appId,\n    icon,\n    interfaces,\n    isAutoUpdating,\n    isSingleton,\n    organizationId,\n    slug,\n    sourceDir,\n    title,\n    version,\n    visibility,\n  } = options\n  const tarball = pack(dirname(sourceDir), {entries: [basename(sourceDir)]}).pipe(createGzip())\n\n  const spin = spinner('Deploying...').start()\n  try {\n    if (appId) {\n      await createDeployment({applicationId: appId, interfaces, isAutoUpdating, tarball, version})\n      await updateApplication(appId, {title, ...(icon ? {icon} : {})})\n      spin.succeed()\n      return {applicationId: appId}\n    }\n\n    const {id} = await createApplication({\n      icon,\n      interfaces,\n      isSingleton,\n      organizationId,\n      slug,\n      tarball,\n      title,\n      type: 'coreApp',\n      version,\n      visibility,\n    })\n    spin.succeed()\n    return {applicationId: id}\n  } catch (error) {\n    spin.clear()\n    throw error\n  }\n}\n\n/**\n * Deploy a workbench studio through Brett: redeploy when `appId` is set,\n * otherwise create the studio at `studioHost`. Returns the application id for\n * the shell to report; a missing `studioHost` on create is a usage error.\n * @internal\n */\nexport async function deployStudio(options: {\n  appId: string | undefined\n  icon?: string\n  interfaces: readonly BrettInterface[]\n  isAutoUpdating: boolean\n  organizationId: string\n  output: Output\n  projectId: string | undefined\n  sourceDir: string\n  studioHost: string | undefined\n  title: string\n  version: string\n  workspaces: readonly BrettWorkspace[]\n}): Promise<{applicationId: string}> {\n  const {\n    appId,\n    icon,\n    interfaces,\n    isAutoUpdating,\n    organizationId,\n    output,\n    projectId,\n    sourceDir,\n    studioHost,\n    title,\n    version,\n    workspaces,\n  } = options\n  const tarball = pack(dirname(sourceDir), {entries: [basename(sourceDir)]}).pipe(createGzip())\n\n  const spin = spinner('Deploying to sanity.studio').start()\n  try {\n    if (appId) {\n      await createDeployment({\n        applicationId: appId,\n        interfaces,\n        isAutoUpdating,\n        tarball,\n        version,\n        workspaces,\n      })\n      await updateApplication(appId, {title, ...(icon ? {icon} : {})})\n      spin.succeed()\n      return {applicationId: appId}\n    }\n\n    if (!studioHost) {\n      spin.fail()\n      return output.error(\n        'No studio hostname configured. Set `studioHost` in sanity.cli.ts to create a studio.',\n        {exit: exitCodes.USAGE_ERROR},\n      )\n    }\n\n    const application = await createApplication({\n      icon,\n      interfaces,\n      organizationId,\n      projectId,\n      slug: studioHost,\n      tarball,\n      title,\n      type: 'studio',\n      version,\n      workspaces,\n    })\n    spin.succeed()\n    return {applicationId: application.id}\n  } catch (error) {\n    spin.fail()\n    throw error\n  }\n}\n"],"names":["basename","dirname","createGzip","exitCodes","spinner","pack","createApplication","createDeployment","updateApplication","deployCoreApp","options","appId","icon","interfaces","isAutoUpdating","isSingleton","organizationId","slug","sourceDir","title","version","visibility","tarball","entries","pipe","spin","start","applicationId","succeed","id","type","error","clear","deployStudio","output","projectId","studioHost","workspaces","fail","exit","USAGE_ERROR","application"],"mappings":"AAAA,SAAQA,QAAQ,EAAEC,OAAO,QAAO,YAAW;AAC3C,SAAQC,UAAU,QAAO,YAAW;AAEpC,SAA4BC,SAAS,QAAoB,mBAAkB;AAC3E,SAAQC,OAAO,QAAO,sBAAqB;AAC3C,SAAQC,IAAI,QAAO,SAAQ;AAE3B,SAGEC,iBAAiB,EACjBC,gBAAgB,EAChBC,iBAAiB,QACZ,iCAAgC;AAEvC;;;;;CAKC,GACD,OAAO,eAAeC,cAAcC,OAYnC;IACC,MAAM,EACJC,KAAK,EACLC,IAAI,EACJC,UAAU,EACVC,cAAc,EACdC,WAAW,EACXC,cAAc,EACdC,IAAI,EACJC,SAAS,EACTC,KAAK,EACLC,OAAO,EACPC,UAAU,EACX,GAAGX;IACJ,MAAMY,UAAUjB,KAAKJ,QAAQiB,YAAY;QAACK,SAAS;YAACvB,SAASkB;SAAW;IAAA,GAAGM,IAAI,CAACtB;IAEhF,MAAMuB,OAAOrB,QAAQ,gBAAgBsB,KAAK;IAC1C,IAAI;QACF,IAAIf,OAAO;YACT,MAAMJ,iBAAiB;gBAACoB,eAAehB;gBAAOE;gBAAYC;gBAAgBQ;gBAASF;YAAO;YAC1F,MAAMZ,kBAAkBG,OAAO;gBAACQ;gBAAO,GAAIP,OAAO;oBAACA;gBAAI,IAAI,CAAC,CAAC;YAAC;YAC9Da,KAAKG,OAAO;YACZ,OAAO;gBAACD,eAAehB;YAAK;QAC9B;QAEA,MAAM,EAACkB,EAAE,EAAC,GAAG,MAAMvB,kBAAkB;YACnCM;YACAC;YACAE;YACAC;YACAC;YACAK;YACAH;YACAW,MAAM;YACNV;YACAC;QACF;QACAI,KAAKG,OAAO;QACZ,OAAO;YAACD,eAAeE;QAAE;IAC3B,EAAE,OAAOE,OAAO;QACdN,KAAKO,KAAK;QACV,MAAMD;IACR;AACF;AAEA;;;;;CAKC,GACD,OAAO,eAAeE,aAAavB,OAalC;IACC,MAAM,EACJC,KAAK,EACLC,IAAI,EACJC,UAAU,EACVC,cAAc,EACdE,cAAc,EACdkB,MAAM,EACNC,SAAS,EACTjB,SAAS,EACTkB,UAAU,EACVjB,KAAK,EACLC,OAAO,EACPiB,UAAU,EACX,GAAG3B;IACJ,MAAMY,UAAUjB,KAAKJ,QAAQiB,YAAY;QAACK,SAAS;YAACvB,SAASkB;SAAW;IAAA,GAAGM,IAAI,CAACtB;IAEhF,MAAMuB,OAAOrB,QAAQ,8BAA8BsB,KAAK;IACxD,IAAI;QACF,IAAIf,OAAO;YACT,MAAMJ,iBAAiB;gBACrBoB,eAAehB;gBACfE;gBACAC;gBACAQ;gBACAF;gBACAiB;YACF;YACA,MAAM7B,kBAAkBG,OAAO;gBAACQ;gBAAO,GAAIP,OAAO;oBAACA;gBAAI,IAAI,CAAC,CAAC;YAAC;YAC9Da,KAAKG,OAAO;YACZ,OAAO;gBAACD,eAAehB;YAAK;QAC9B;QAEA,IAAI,CAACyB,YAAY;YACfX,KAAKa,IAAI;YACT,OAAOJ,OAAOH,KAAK,CACjB,wFACA;gBAACQ,MAAMpC,UAAUqC,WAAW;YAAA;QAEhC;QAEA,MAAMC,cAAc,MAAMnC,kBAAkB;YAC1CM;YACAC;YACAG;YACAmB;YACAlB,MAAMmB;YACNd;YACAH;YACAW,MAAM;YACNV;YACAiB;QACF;QACAZ,KAAKG,OAAO;QACZ,OAAO;YAACD,eAAec,YAAYZ,EAAE;QAAA;IACvC,EAAE,OAAOE,OAAO;QACdN,KAAKa,IAAI;QACT,MAAMP;IACR;AACF"}

package/dist/actions/dev/deriveInterfaces.js

@@ -1,37 +1,53 @@
 import { hash } from 'node:crypto';
-import { MEDIA_LIBRARY_CONFIG_CONTRACT_VERSION, SERVICE_CONTRACT_VERSION, VIEW_CONTRACT_VERSION } from '../../contract.js';
+import { interfaceModuleId, MEDIA_LIBRARY_CONFIG_CONTRACT_VERSION, SERVICE_CONTRACT_VERSION, VIEW_CONTRACT_VERSION } from '../../contract.js';
 import { isWorkbenchApp, readConfig } from '../../defineApp.js';
 /**
- * Map a workbench app's declarations to the interface records forwarded on its
- * registry entry: `views` → panels, `services` → workers, `entry` → the
- * navigable `app` view. `src` is the raw source, not a resolved URL. `undefined`
- * for a non-branded app; a studio that declares `entry` is rejected (studio app
- * views are not implemented yet). The config is not an interface — see
- * {@link deriveConfigs}. `version` is the module's contract version; the app
- * view has no versioned contract, so it carries none.
+ * Map a workbench app's declarations to its registry interface records:
+ * `views` → panels, `services` → workers, `entry` → the `app` view. Each mirrors
+ * a deployed record so the workbench loads a local interface like a deployed one.
+ * `undefined` for a non-branded app; a studio that declares `entry` is rejected
+ * (studio app views aren't implemented yet).
  */ export function deriveInterfaces(app, options) {
     if (!isWorkbenchApp(app)) return undefined;
     if (!options.isApp && app.entry !== undefined) {
         throw new Error('App views for studios are not implemented yet');
     }
-    const toInterface = ({ name, src, title, type }, version)=>({
-            name,
-            src,
-            title: title ?? name,
-            type,
-            version
-        });
+    const interfaceId = (type, name)=>`${app.name}-${type}-${name}`;
+    const views = (app.views ?? []).map((view)=>({
+            id: interfaceId('panel', view.name),
+            metadata: null,
+            moduleId: interfaceModuleId('panel', view.name),
+            name: view.name,
+            src: view.src,
+            title: view.title ?? view.name,
+            type: 'panel',
+            version: String(VIEW_CONTRACT_VERSION)
+        }));
+    const services = (app.services ?? []).map((service)=>({
+            id: interfaceId('worker', service.name),
+            metadata: null,
+            moduleId: interfaceModuleId('worker', service.name),
+            name: service.name,
+            src: service.src,
+            title: service.title ?? service.name,
+            type: 'worker',
+            version: String(SERVICE_CONTRACT_VERSION)
+        }));
+    const appView = app.entry === undefined ? [] : [
+        {
+            id: interfaceId('app', app.name),
+            metadata: null,
+            moduleId: interfaceModuleId('app', app.name),
+            name: app.name,
+            src: app.entry,
+            title: app.title,
+            type: 'app'
+        }
+    ];
     return [
-        ...(app.views ?? []).map((view)=>toInterface(view, VIEW_CONTRACT_VERSION)),
-        ...(app.services ?? []).map((service)=>toInterface(service, SERVICE_CONTRACT_VERSION)),
-        ...app.entry === undefined ? [] : [
-            {
-                name: app.name,
-                src: app.entry,
-                title: app.title,
-                type: 'app'
-            }
-        ]
+        ...views,
+        ...services,
+        ...appView
     ];
 }
 /**

package/dist/actions/dev/deriveInterfaces.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/actions/dev/deriveInterfaces.ts"],"sourcesContent":["import {hash} from 'node:crypto'\n\nimport {type CliConfig} from '@sanity/cli-core'\n\nimport {\n  MEDIA_LIBRARY_CONFIG_CONTRACT_VERSION,\n  SERVICE_CONTRACT_VERSION,\n  VIEW_CONTRACT_VERSION,\n} from '../../contract.js'\nimport {isWorkbenchApp, readConfig} from '../../defineApp.js'\nimport {type DevServerManifest} from './registry.js'\n\n/** One forwarded interface record on the dev-server registry entry. */\nexport type DevServerInterface = NonNullable<DevServerManifest['interfaces']>[number]\n\n/** One forwarded config on the dev-server registry entry. */\nexport type DevServerConfig = NonNullable<DevServerManifest['configs']>[number]\n\n/**\n * Map a workbench app's declarations to the interface records forwarded on its\n * registry entry: `views` → panels, `services` → workers, `entry` → the\n * navigable `app` view. `src` is the raw source, not a resolved URL. `undefined`\n * for a non-branded app; a studio that declares `entry` is rejected (studio app\n * views are not implemented yet). The config is not an interface — see\n * {@link deriveConfigs}. `version` is the module's contract version; the app\n * view has no versioned contract, so it carries none.\n */\nexport function deriveInterfaces(\n  app: CliConfig['app'],\n  options: {isApp: boolean},\n): DevServerInterface[] | undefined {\n  if (!isWorkbenchApp(app)) return undefined\n\n  if (!options.isApp && app.entry !== undefined) {\n    throw new Error('App views for studios are not implemented yet')\n  }\n\n  const toInterface = (\n    {name, src, title, type}: {name: string; src: string; title?: string; type: string},\n    version: number,\n  ): DevServerInterface => ({name, src, title: title ?? name, type, version})\n\n  return [\n    ...(app.views ?? []).map((view) => toInterface(view, VIEW_CONTRACT_VERSION)),\n    ...(app.services ?? []).map((service) => toInterface(service, SERVICE_CONTRACT_VERSION)),\n    ...(app.entry === undefined\n      ? []\n      : [{name: app.name, src: app.entry, title: app.title, type: 'app' as const}]),\n  ]\n}\n\n/**\n * The named source files a config's generated module is built from, dispatched\n * per app type — the projection the exposes-set id keys on, so the generic HMR\n * tracker owns none of the per-type shape. Throws on an app type it can't\n * handle, so a new config family has to register its shape here.\n */\nexport function deriveConfigEntries(config: DevServerConfig): {name: string; src: string}[] {\n  switch (config.appType) {\n    case 'media-library': {\n      return config.fields.map((field) => ({name: field.name, src: field.src}))\n    }\n    default: {\n      throw new Error(`Cannot derive entries for unknown config appType: ${config.appType}`)\n    }\n  }\n}\n\n/**\n * The fields' schema *values* can't serialize — the workbench loads them from\n * the federation module. `src` stays on so the exposes-set id keys on it and a\n * repoint rebuilds. `appType` routes the config to the singleton (no app id to\n * key on). `id` is a content hash of the entry — it fills the\n * installation-config id slot deployed apps get from the applications API,\n * and the workbench keys change detection on it. `version` is the config\n * contract version the generated module exports, known before the module runs.\n */\nexport function deriveConfigs(app: CliConfig['app']): DevServerConfig[] {\n  if (!isWorkbenchApp(app)) return []\n  const config = readConfig(app)\n  if (!config) return []\n  const entry = {\n    appType: config.appType,\n    fields: config.fields.map((field) => ({\n      name: field.name,\n      public: field.public,\n      src: field.src,\n      title: field.title,\n    })),\n    moduleName: app.name,\n    version: MEDIA_LIBRARY_CONFIG_CONTRACT_VERSION,\n  }\n  return [{...entry, id: hash('sha1', JSON.stringify(entry))}]\n}\n"],"names":["hash","MEDIA_LIBRARY_CONFIG_CONTRACT_VERSION","SERVICE_CONTRACT_VERSION","VIEW_CONTRACT_VERSION","isWorkbenchApp","readConfig","deriveInterfaces","app","options","undefined","isApp","entry","Error","toInterface","name","src","title","type","version","views","map","view","services","service","deriveConfigEntries","config","appType","fields","field","deriveConfigs","public","moduleName","id","JSON","stringify"],"mappings":"AAAA,SAAQA,IAAI,QAAO,cAAa;AAIhC,SACEC,qCAAqC,EACrCC,wBAAwB,EACxBC,qBAAqB,QAChB,oBAAmB;AAC1B,SAAQC,cAAc,EAAEC,UAAU,QAAO,qBAAoB;AAS7D;;;;;;;;CAQC,GACD,OAAO,SAASC,iBACdC,GAAqB,EACrBC,OAAyB;IAEzB,IAAI,CAACJ,eAAeG,MAAM,OAAOE;IAEjC,IAAI,CAACD,QAAQE,KAAK,IAAIH,IAAII,KAAK,KAAKF,WAAW;QAC7C,MAAM,IAAIG,MAAM;IAClB;IAEA,MAAMC,cAAc,CAClB,EAACC,IAAI,EAAEC,GAAG,EAAEC,KAAK,EAAEC,IAAI,EAA4D,EACnFC,UACwB,CAAA;YAACJ;YAAMC;YAAKC,OAAOA,SAASF;YAAMG;YAAMC;QAAO,CAAA;IAEzE,OAAO;WACF,AAACX,CAAAA,IAAIY,KAAK,IAAI,EAAE,AAAD,EAAGC,GAAG,CAAC,CAACC,OAASR,YAAYQ,MAAMlB;WAClD,AAACI,CAAAA,IAAIe,QAAQ,IAAI,EAAE,AAAD,EAAGF,GAAG,CAAC,CAACG,UAAYV,YAAYU,SAASrB;WAC1DK,IAAII,KAAK,KAAKF,YACd,EAAE,GACF;YAAC;gBAACK,MAAMP,IAAIO,IAAI;gBAAEC,KAAKR,IAAII,KAAK;gBAAEK,OAAOT,IAAIS,KAAK;gBAAEC,MAAM;YAAc;SAAE;KAC/E;AACH;AAEA;;;;;CAKC,GACD,OAAO,SAASO,oBAAoBC,MAAuB;IACzD,OAAQA,OAAOC,OAAO;QACpB,KAAK;YAAiB;gBACpB,OAAOD,OAAOE,MAAM,CAACP,GAAG,CAAC,CAACQ,QAAW,CAAA;wBAACd,MAAMc,MAAMd,IAAI;wBAAEC,KAAKa,MAAMb,GAAG;oBAAA,CAAA;YACxE;QACA;YAAS;gBACP,MAAM,IAAIH,MAAM,CAAC,kDAAkD,EAAEa,OAAOC,OAAO,EAAE;YACvF;IACF;AACF;AAEA;;;;;;;;CAQC,GACD,OAAO,SAASG,cAActB,GAAqB;IACjD,IAAI,CAACH,eAAeG,MAAM,OAAO,EAAE;IACnC,MAAMkB,SAASpB,WAAWE;IAC1B,IAAI,CAACkB,QAAQ,OAAO,EAAE;IACtB,MAAMd,QAAQ;QACZe,SAASD,OAAOC,OAAO;QACvBC,QAAQF,OAAOE,MAAM,CAACP,GAAG,CAAC,CAACQ,QAAW,CAAA;gBACpCd,MAAMc,MAAMd,IAAI;gBAChBgB,QAAQF,MAAME,MAAM;gBACpBf,KAAKa,MAAMb,GAAG;gBACdC,OAAOY,MAAMZ,KAAK;YACpB,CAAA;QACAe,YAAYxB,IAAIO,IAAI;QACpBI,SAASjB;IACX;IACA,OAAO;QAAC;YAAC,GAAGU,KAAK;YAAEqB,IAAIhC,KAAK,QAAQiC,KAAKC,SAAS,CAACvB;QAAO;KAAE;AAC9D"}
+{"version":3,"sources":["../../../src/actions/dev/deriveInterfaces.ts"],"sourcesContent":["import {hash} from 'node:crypto'\n\nimport {type CliConfig} from '@sanity/cli-core'\n\nimport {\n  interfaceModuleId,\n  MEDIA_LIBRARY_CONFIG_CONTRACT_VERSION,\n  SERVICE_CONTRACT_VERSION,\n  VIEW_CONTRACT_VERSION,\n} from '../../contract.js'\nimport {isWorkbenchApp, readConfig} from '../../defineApp.js'\nimport {type DevServerManifest} from './registry.js'\n\n/** One forwarded interface record on the dev-server registry entry. */\nexport type DevServerInterface = NonNullable<DevServerManifest['interfaces']>[number]\n\n/** One forwarded config on the dev-server registry entry. */\nexport type DevServerConfig = NonNullable<DevServerManifest['configs']>[number]\n\n/**\n * Map a workbench app's declarations to its registry interface records:\n * `views` → panels, `services` → workers, `entry` → the `app` view. Each mirrors\n * a deployed record so the workbench loads a local interface like a deployed one.\n * `undefined` for a non-branded app; a studio that declares `entry` is rejected\n * (studio app views aren't implemented yet).\n */\nexport function deriveInterfaces(\n  app: CliConfig['app'],\n  options: {isApp: boolean},\n): DevServerInterface[] | undefined {\n  if (!isWorkbenchApp(app)) return undefined\n\n  if (!options.isApp && app.entry !== undefined) {\n    throw new Error('App views for studios are not implemented yet')\n  }\n\n  const interfaceId = (type: string, name: string): string => `${app.name}-${type}-${name}`\n\n  const views = (app.views ?? []).map(\n    (view): DevServerInterface => ({\n      id: interfaceId('panel', view.name),\n      metadata: null,\n      moduleId: interfaceModuleId('panel', view.name),\n      name: view.name,\n      src: view.src,\n      title: view.title ?? view.name,\n      type: 'panel',\n      version: String(VIEW_CONTRACT_VERSION),\n    }),\n  )\n\n  const services = (app.services ?? []).map(\n    (service): DevServerInterface => ({\n      id: interfaceId('worker', service.name),\n      metadata: null,\n      moduleId: interfaceModuleId('worker', service.name),\n      name: service.name,\n      src: service.src,\n      title: service.title ?? service.name,\n      type: 'worker',\n      version: String(SERVICE_CONTRACT_VERSION),\n    }),\n  )\n\n  const appView: DevServerInterface[] =\n    app.entry === undefined\n      ? []\n      : [\n          {\n            id: interfaceId('app', app.name),\n            metadata: null,\n            moduleId: interfaceModuleId('app', app.name),\n            name: app.name,\n            src: app.entry,\n            title: app.title,\n            type: 'app',\n          },\n        ]\n\n  return [...views, ...services, ...appView]\n}\n\n/**\n * The named source files a config's generated module is built from, dispatched\n * per app type — the projection the exposes-set id keys on, so the generic HMR\n * tracker owns none of the per-type shape. Throws on an app type it can't\n * handle, so a new config family has to register its shape here.\n */\nexport function deriveConfigEntries(config: DevServerConfig): {name: string; src: string}[] {\n  switch (config.appType) {\n    case 'media-library': {\n      return config.fields.map((field) => ({name: field.name, src: field.src}))\n    }\n    default: {\n      throw new Error(`Cannot derive entries for unknown config appType: ${config.appType}`)\n    }\n  }\n}\n\n/**\n * The fields' schema *values* can't serialize — the workbench loads them from\n * the federation module. `src` stays on so the exposes-set id keys on it and a\n * repoint rebuilds. `appType` routes the config to the singleton (no app id to\n * key on). `id` is a content hash of the entry — it fills the\n * installation-config id slot deployed apps get from the applications API,\n * and the workbench keys change detection on it. `version` is the config\n * contract version the generated module exports, known before the module runs.\n */\nexport function deriveConfigs(app: CliConfig['app']): DevServerConfig[] {\n  if (!isWorkbenchApp(app)) return []\n  const config = readConfig(app)\n  if (!config) return []\n  const entry = {\n    appType: config.appType,\n    fields: config.fields.map((field) => ({\n      name: field.name,\n      public: field.public,\n      src: field.src,\n      title: field.title,\n    })),\n    moduleName: app.name,\n    version: MEDIA_LIBRARY_CONFIG_CONTRACT_VERSION,\n  }\n  return [{...entry, id: hash('sha1', JSON.stringify(entry))}]\n}\n"],"names":["hash","interfaceModuleId","MEDIA_LIBRARY_CONFIG_CONTRACT_VERSION","SERVICE_CONTRACT_VERSION","VIEW_CONTRACT_VERSION","isWorkbenchApp","readConfig","deriveInterfaces","app","options","undefined","isApp","entry","Error","interfaceId","type","name","views","map","view","id","metadata","moduleId","src","title","version","String","services","service","appView","deriveConfigEntries","config","appType","fields","field","deriveConfigs","public","moduleName","JSON","stringify"],"mappings":"AAAA,SAAQA,IAAI,QAAO,cAAa;AAIhC,SACEC,iBAAiB,EACjBC,qCAAqC,EACrCC,wBAAwB,EACxBC,qBAAqB,QAChB,oBAAmB;AAC1B,SAAQC,cAAc,EAAEC,UAAU,QAAO,qBAAoB;AAS7D;;;;;;CAMC,GACD,OAAO,SAASC,iBACdC,GAAqB,EACrBC,OAAyB;IAEzB,IAAI,CAACJ,eAAeG,MAAM,OAAOE;IAEjC,IAAI,CAACD,QAAQE,KAAK,IAAIH,IAAII,KAAK,KAAKF,WAAW;QAC7C,MAAM,IAAIG,MAAM;IAClB;IAEA,MAAMC,cAAc,CAACC,MAAcC,OAAyB,GAAGR,IAAIQ,IAAI,CAAC,CAAC,EAAED,KAAK,CAAC,EAAEC,MAAM;IAEzF,MAAMC,QAAQ,AAACT,CAAAA,IAAIS,KAAK,IAAI,EAAE,AAAD,EAAGC,GAAG,CACjC,CAACC,OAA8B,CAAA;YAC7BC,IAAIN,YAAY,SAASK,KAAKH,IAAI;YAClCK,UAAU;YACVC,UAAUrB,kBAAkB,SAASkB,KAAKH,IAAI;YAC9CA,MAAMG,KAAKH,IAAI;YACfO,KAAKJ,KAAKI,GAAG;YACbC,OAAOL,KAAKK,KAAK,IAAIL,KAAKH,IAAI;YAC9BD,MAAM;YACNU,SAASC,OAAOtB;QAClB,CAAA;IAGF,MAAMuB,WAAW,AAACnB,CAAAA,IAAImB,QAAQ,IAAI,EAAE,AAAD,EAAGT,GAAG,CACvC,CAACU,UAAiC,CAAA;YAChCR,IAAIN,YAAY,UAAUc,QAAQZ,IAAI;YACtCK,UAAU;YACVC,UAAUrB,kBAAkB,UAAU2B,QAAQZ,IAAI;YAClDA,MAAMY,QAAQZ,IAAI;YAClBO,KAAKK,QAAQL,GAAG;YAChBC,OAAOI,QAAQJ,KAAK,IAAII,QAAQZ,IAAI;YACpCD,MAAM;YACNU,SAASC,OAAOvB;QAClB,CAAA;IAGF,MAAM0B,UACJrB,IAAII,KAAK,KAAKF,YACV,EAAE,GACF;QACE;YACEU,IAAIN,YAAY,OAAON,IAAIQ,IAAI;YAC/BK,UAAU;YACVC,UAAUrB,kBAAkB,OAAOO,IAAIQ,IAAI;YAC3CA,MAAMR,IAAIQ,IAAI;YACdO,KAAKf,IAAII,KAAK;YACdY,OAAOhB,IAAIgB,KAAK;YAChBT,MAAM;QACR;KACD;IAEP,OAAO;WAAIE;WAAUU;WAAaE;KAAQ;AAC5C;AAEA;;;;;CAKC,GACD,OAAO,SAASC,oBAAoBC,MAAuB;IACzD,OAAQA,OAAOC,OAAO;QACpB,KAAK;YAAiB;gBACpB,OAAOD,OAAOE,MAAM,CAACf,GAAG,CAAC,CAACgB,QAAW,CAAA;wBAAClB,MAAMkB,MAAMlB,IAAI;wBAAEO,KAAKW,MAAMX,GAAG;oBAAA,CAAA;YACxE;QACA;YAAS;gBACP,MAAM,IAAIV,MAAM,CAAC,kDAAkD,EAAEkB,OAAOC,OAAO,EAAE;YACvF;IACF;AACF;AAEA;;;;;;;;CAQC,GACD,OAAO,SAASG,cAAc3B,GAAqB;IACjD,IAAI,CAACH,eAAeG,MAAM,OAAO,EAAE;IACnC,MAAMuB,SAASzB,WAAWE;IAC1B,IAAI,CAACuB,QAAQ,OAAO,EAAE;IACtB,MAAMnB,QAAQ;QACZoB,SAASD,OAAOC,OAAO;QACvBC,QAAQF,OAAOE,MAAM,CAACf,GAAG,CAAC,CAACgB,QAAW,CAAA;gBACpClB,MAAMkB,MAAMlB,IAAI;gBAChBoB,QAAQF,MAAME,MAAM;gBACpBb,KAAKW,MAAMX,GAAG;gBACdC,OAAOU,MAAMV,KAAK;YACpB,CAAA;QACAa,YAAY7B,IAAIQ,IAAI;QACpBS,SAASvB;IACX;IACA,OAAO;QAAC;YAAC,GAAGU,KAAK;YAAEQ,IAAIpB,KAAK,QAAQsC,KAAKC,SAAS,CAAC3B;QAAO;KAAE;AAC9D"}

package/dist/actions/dev/registry.js

@@ -2,9 +2,28 @@ import { existsSync, mkdirSync, readdirSync, readFileSync, unlinkSync, watch, wr
 import { join } from 'node:path';
 import { coreAppManifestSchema, getSanityDataDir, studioManifestSchema, subdebug } from '@sanity/cli-core';
 import { z } from 'zod/mini';
+import { AppInterfaceMetadataSchema } from '../../contract.js';
 import { canonicalizeWatchDir } from './canonicalizeWatchDir.js';
 import { getProcessStartTime, isOurProcess } from './processLiveness.js';
-const devDebug = subdebug('dev');
+/**
+ * The dev-server registry: how a running `sanity dev` / `sanity start` process
+ * advertises itself so the workbench on this machine can find and load it.
+ *
+ * Two kinds of file under `~/.sanity/dev-servers/` do the coordinating:
+ *
+ *   - `<pid>.json` — one per running app/studio server, holding where it's served
+ *     plus its inlined manifest and interfaces. The workbench reads these to
+ *     discover and render local apps. Written by `registerDevServer`, watched by
+ *     `watchRegistry`.
+ *   - `workbench.lock` — a single machine-wide lock, so only one workbench shell
+ *     runs at a time and later `dev`s register into it instead of starting their
+ *     own. Managed by `acquireWorkbenchLock` / `readWorkbenchLock`.
+ *
+ * Both files belong to the process that created them and must not outlive it.
+ * Three things keep that true: an explicit `release()` on clean shutdown, an
+ * `exit` backstop for abrupt exits (`unlinkOnProcessExit`), and a dead-pid prune
+ * on read (`isOurProcess`) that clears whatever a crashed process left behind.
+ */ const devDebug = subdebug('dev');
 /** Bump when the manifest/lock shape changes in a breaking way. */ const REGISTRY_VERSION = 1;
 /**
  * The current process's start time as reported by the OS, for the `startedAt`
@@ -14,6 +33,34 @@ const devDebug = subdebug('dev');
  */ function ownStartedAt() {
     return (getProcessStartTime(process.pid) ?? new Date()).toISOString();
 }
+const interfaceBaseFields = {
+    /** CLI-minted for a local interface; a deployed one gets its id from Brett. */ id: z.string(),
+    moduleId: z.string(),
+    name: z.string(),
+    /** Raw source vite serves; a deployed interface carries only the `moduleId`. */ src: z.string(),
+    title: z.string(),
+    version: z.optional(z.string())
+};
+/**
+ * A forwarded interface, discriminated on `type`. Kept outside the manifest so
+ * the workbench renders local panels and runs workers without a deploy.
+ */ const devServerInterfaceSchema = z.discriminatedUnion('type', [
+    z.object({
+        ...interfaceBaseFields,
+        metadata: z.nullable(AppInterfaceMetadataSchema),
+        type: z.literal('app')
+    }),
+    z.object({
+        ...interfaceBaseFields,
+        metadata: z.null(),
+        type: z.literal('panel')
+    }),
+    z.object({
+        ...interfaceBaseFields,
+        metadata: z.null(),
+        type: z.literal('worker')
+    })
+]);
 const devServerManifestSchema = z.object({
     /**
    * Field schema *values* load from the federation module; each field's `src`
@@ -40,24 +87,7 @@ const devServerManifestSchema = z.object({
     }))),
     host: z.string(),
     id: z.optional(z.string()),
-    /**
-   * Interfaces the app exposes, mapped from the declared `views` (dock panels,
-   * `type: "panel"`) and `services` (background workers,
-   * `type: "worker"`). A service is just an interface, so both live
-   * in this one list. Carried separately from the manifest — interfaces live in
-   * the application service, not the manifest — so the workbench can render
-   * local panels and run local workers without a deploy. `src` is the
-   * declared source file; `title` defaults to `name`. Lenient by design; the
-   * workbench is the authority on the interface shape.
-   */ interfaces: z.optional(z.array(z.object({
-        name: z.string(),
-        src: z.string(),
-        title: z.string(),
-        type: z.string(),
-        // Contract version the interface's generated module exports; the app
-        // view has no versioned contract and carries none.
-        version: z.optional(z.number())
-    }))),
+    interfaces: z.optional(z.array(devServerInterfaceSchema)),
     /**
    * Inlined manifest — either a {@link StudioManifest} or {@link CoreAppManifest},
    * validated against the shared cli-core schemas. The registry stores and
@@ -88,6 +118,39 @@ const devServerManifestSchema = z.object({
  */ function getRegistryDir() {
     return join(getSanityDataDir(), 'dev-servers');
 }
+// One shared `exit` listener drives every registered cleanup, so N locks/entries
+// don't each add a listener and trip Node's MaxListeners warning.
+const exitCleanups = new Set();
+let exitListenerInstalled = false;
+function runExitCleanups() {
+    for (const cleanup of exitCleanups)cleanup();
+}
+/** Exercise the exit backstop in tests without terminating the process; not part
+ * of the package's public surface. */ export const runRegistryExitCleanupForTesting = runExitCleanups;
+/**
+ * Delete a registry file synchronously on process exit, as a backstop for abrupt
+ * termination. Vite installs its own SIGTERM handler that calls `process.exit()`,
+ * which can outrun the async server teardown and leave the lock or registry entry
+ * behind — a stray dev-server that lingers until the dead-pid prune clears it. The
+ * `exit` event only runs synchronous work, hence `unlinkSync`. `ownedByUs` guards
+ * the shared lock so a successor that reacquired it isn't wiped. Returns a
+ * detacher to call after a clean release.
+ */ function unlinkOnProcessExit(filePath, ownedByUs) {
+    const cleanup = ()=>{
+        if (!ownedByUs()) return;
+        try {
+            unlinkSync(filePath);
+        } catch  {
+        // The file may already have been removed during shutdown.
+        }
+    };
+    exitCleanups.add(cleanup);
+    if (!exitListenerInstalled) {
+        exitListenerInstalled = true;
+        process.once('exit', runExitCleanups);
+    }
+    return ()=>exitCleanups.delete(cleanup);
+}
 /**
  * Write a manifest file for the current process and return a handle with a
  * `release` function that removes it plus an `update` function for patching
@@ -110,9 +173,12 @@ const devServerManifestSchema = z.object({
     // manifest extraction) landing after `release()` has deleted the file —
     // without this, the update would re-create the registry entry and leak.
     let released = false;
+    // The file is pid-named, so it's always ours to remove on exit.
+    const detachExitCleanup = unlinkOnProcessExit(filePath, ()=>!released);
     return {
         release () {
             released = true;
+            detachExitCleanup();
             try {
                 unlinkSync(filePath);
             } catch  {
@@ -273,8 +339,22 @@ function pruneWorkbenchLock(lockPath) {
             flag: 'wx'
         });
         devDebug('Workbench lock acquired');
+        let released = false;
+        // Only wipe the lock on exit if it's still ours — a successor that reacquired
+        // it after our own release must not be clobbered.
+        const detachExitCleanup = unlinkOnProcessExit(lockPath, ()=>{
+            if (released) return false;
+            try {
+                const disk = parseLockContents(readFileSync(lockPath, 'utf8'));
+                return disk?.pid === process.pid && disk.startedAt === startedAt;
+            } catch  {
+                return false;
+            }
+        });
         return {
             release () {
+                released = true;
+                detachExitCleanup();
                 try {
                     unlinkSync(lockPath);
                 } catch  {