@jxsuite/protocol 5.0.0 → 6.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jxsuite/protocol",
-  "version": "5.0.0",
+  "version": "6.0.0",
   "description": "The Studio Backend Protocol — wire types and the canonical route table every Jx Studio backend implements",
   "license": "MIT",
   "repository": {
@@ -27,6 +27,6 @@
     "test:coverage": "bun test --isolate --coverage"
   },
   "dependencies": {
-    "@jxsuite/schema": "^4.1.0"
+    "@jxsuite/schema": "^5.0.0"
   }
 }

package/src/routes.ts

@@ -335,13 +335,21 @@ export const STUDIO_ROUTES = {
 
   // ─── Packages ─────────────────────────────────────────────────────────────
   packages: route("GET", "/__studio/packages", "List dependencies (PackageInfo[])"),
-  packagesAdd: route("POST", "/__studio/packages/add", "Add a dependency"),
-  packagesRemove: route("POST", "/__studio/packages/remove", "Remove a dependency"),
+  packagesAdd: route(
+    "POST",
+    "/__studio/packages/add",
+    "Add a registry dependency, writing package.json and package-lock.json together",
+  ),
+  packagesRemove: route(
+    "POST",
+    "/__studio/packages/remove",
+    "Remove a dependency, writing package.json and package-lock.json together",
+  ),
   packagesInstall: route(
     "POST",
     "/__studio/packages/install",
-    "Run the package manager install",
-    "Install/reinstall affordances are hidden; manifest-only edits still work.",
+    "Install the declared dependencies (npm's installer, writing package-lock.json)",
+    "Install/reinstall affordances are hidden; add, remove and version updates still work where the backend serves them (a cloud session updates the lockfile without installing).",
   ),
   packagesNeedsInstall: route(
     "GET",
@@ -358,7 +366,7 @@ export const STUDIO_ROUTES = {
   packagesSetVersions: route(
     "POST",
     "/__studio/packages/set-versions",
-    "Rewrite dependency ranges and install",
+    "Rewrite dependency ranges and install (lockfile-only where nothing installs)",
     "Bulk version updates are hidden.",
   ),
 

package/src/types.ts

@@ -328,7 +328,7 @@ export interface ExtensionSectionInfo {
 
 /** One extension a backend can offer a project, whether or not the project enables it. */
 export interface ExtensionCatalogEntry {
-  /** Package name: the identity, and the `bun add` argument. */
+  /** Package name: the identity, and the argument an add passes the installer. */
   name: string;
   /**
    * The string that goes in `project.json` `extensions[]`. Usually `name`, but a linked or
@@ -350,12 +350,6 @@ export interface ExtensionCatalogEntry {
   formats?: string[];
   /** Other catalogue members it depends on — auth needs connector. */
   requires?: string[];
-  /**
-   * THIS host resolves the package without a project install, so enabling it is a config write
-   * alone. Probed per host, never declared: what a desktop build stages and what a Worker bundles
-   * are different facts, and neither is knowable from the package list.
-   */
-  bundled?: boolean;
   /**
    * The PROJECT resolves it.
    *
@@ -590,7 +584,7 @@ export interface PackageVersionInfo {
   dev?: boolean;
 }
 
-/** Result of a package mutation that runs `bun install` (install / set-versions). */
+/** Result of a package mutation that runs an install (install / set-versions). */
 export interface PackageOpResult {
   ok: boolean;
   /** Combined stdout/stderr from the bun invocation, surfaced to the user on failure. */