@elevasis/sdk 1.9.0 → 1.11.0

package/dist/cli.cjs

@@ -102,8 +102,8 @@ var require_package = __commonJS({
 // ../../node_modules/.pnpm/dotenv@16.6.1/node_modules/dotenv/lib/main.js
 var require_main = __commonJS({
   "../../node_modules/.pnpm/dotenv@16.6.1/node_modules/dotenv/lib/main.js"(exports2, module2) {
-    var fs = require("fs");
-    var path2 = require("path");
+    var fs2 = require("fs");
+    var path3 = require("path");
     var os2 = require("os");
     var crypto = require("crypto");
     var packageJson = require_package();
@@ -211,7 +211,7 @@ var require_main = __commonJS({
       if (options && options.path && options.path.length > 0) {
         if (Array.isArray(options.path)) {
           for (const filepath of options.path) {
-            if (fs.existsSync(filepath)) {
+            if (fs2.existsSync(filepath)) {
               possibleVaultPath = filepath.endsWith(".vault") ? filepath : `${filepath}.vault`;
             }
           }
@@ -219,15 +219,15 @@ var require_main = __commonJS({
           possibleVaultPath = options.path.endsWith(".vault") ? options.path : `${options.path}.vault`;
         }
       } else {
-        possibleVaultPath = path2.resolve(process.cwd(), ".env.vault");
+        possibleVaultPath = path3.resolve(process.cwd(), ".env.vault");
       }
-      if (fs.existsSync(possibleVaultPath)) {
+      if (fs2.existsSync(possibleVaultPath)) {
         return possibleVaultPath;
       }
       return null;
     }
     function _resolveHome(envPath2) {
-      return envPath2[0] === "~" ? path2.join(os2.homedir(), envPath2.slice(1)) : envPath2;
+      return envPath2[0] === "~" ? path3.join(os2.homedir(), envPath2.slice(1)) : envPath2;
     }
     function _configVault(options) {
       const debug = Boolean(options && options.debug);
@@ -244,7 +244,7 @@ var require_main = __commonJS({
       return { parsed };
     }
     function configDotenv(options) {
-      const dotenvPath = path2.resolve(process.cwd(), ".env");
+      const dotenvPath = path3.resolve(process.cwd(), ".env");
       let encoding = "utf8";
       const debug = Boolean(options && options.debug);
       const quiet = options && "quiet" in options ? options.quiet : true;
@@ -268,13 +268,13 @@ var require_main = __commonJS({
       }
       let lastError;
       const parsedAll = {};
-      for (const path3 of optionPaths) {
+      for (const path4 of optionPaths) {
         try {
-          const parsed = DotenvModule.parse(fs.readFileSync(path3, { encoding }));
+          const parsed = DotenvModule.parse(fs2.readFileSync(path4, { encoding }));
           DotenvModule.populate(parsedAll, parsed, options);
         } catch (e) {
           if (debug) {
-            _debug(`Failed to load ${path3} ${e.message}`);
+            _debug(`Failed to load ${path4} ${e.message}`);
           }
           lastError = e;
         }
@@ -289,7 +289,7 @@ var require_main = __commonJS({
         const shortPaths = [];
         for (const filePath of optionPaths) {
           try {
-            const relative = path2.relative(process.cwd(), filePath);
+            const relative = path3.relative(process.cwd(), filePath);
             shortPaths.push(relative);
           } catch (e) {
             if (debug) {
@@ -1284,8 +1284,8 @@ var require_command = __commonJS({
   "../../node_modules/.pnpm/commander@11.1.0/node_modules/commander/lib/command.js"(exports2) {
     var EventEmitter = require("events").EventEmitter;
     var childProcess = require("child_process");
-    var path2 = require("path");
-    var fs = require("fs");
+    var path3 = require("path");
+    var fs2 = require("fs");
     var process8 = require("process");
     var { Argument: Argument2, humanReadableArgName } = require_argument();
     var { CommanderError: CommanderError2 } = require_error();
@@ -2108,10 +2108,10 @@ Expecting one of '${allowedValues.join("', '")}'`);
         let launchWithNode = false;
         const sourceExt = [".js", ".ts", ".tsx", ".mjs", ".cjs"];
         function findFile(baseDir, baseName) {
-          const localBin = path2.resolve(baseDir, baseName);
-          if (fs.existsSync(localBin)) return localBin;
-          if (sourceExt.includes(path2.extname(baseName))) return void 0;
-          const foundExt = sourceExt.find((ext) => fs.existsSync(`${localBin}${ext}`));
+          const localBin = path3.resolve(baseDir, baseName);
+          if (fs2.existsSync(localBin)) return localBin;
+          if (sourceExt.includes(path3.extname(baseName))) return void 0;
+          const foundExt = sourceExt.find((ext) => fs2.existsSync(`${localBin}${ext}`));
           if (foundExt) return `${localBin}${foundExt}`;
           return void 0;
         }
@@ -2122,23 +2122,23 @@ Expecting one of '${allowedValues.join("', '")}'`);
         if (this._scriptPath) {
           let resolvedScriptPath;
           try {
-            resolvedScriptPath = fs.realpathSync(this._scriptPath);
+            resolvedScriptPath = fs2.realpathSync(this._scriptPath);
           } catch (err) {
             resolvedScriptPath = this._scriptPath;
           }
-          executableDir = path2.resolve(path2.dirname(resolvedScriptPath), executableDir);
+          executableDir = path3.resolve(path3.dirname(resolvedScriptPath), executableDir);
         }
         if (executableDir) {
           let localFile = findFile(executableDir, executableFile);
           if (!localFile && !subcommand._executableFile && this._scriptPath) {
-            const legacyName = path2.basename(this._scriptPath, path2.extname(this._scriptPath));
+            const legacyName = path3.basename(this._scriptPath, path3.extname(this._scriptPath));
             if (legacyName !== this._name) {
               localFile = findFile(executableDir, `${legacyName}-${subcommand._name}`);
             }
           }
           executableFile = localFile || executableFile;
         }
-        launchWithNode = sourceExt.includes(path2.extname(executableFile));
+        launchWithNode = sourceExt.includes(path3.extname(executableFile));
         let proc;
         if (process8.platform !== "win32") {
           if (launchWithNode) {
@@ -2921,7 +2921,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @return {Command}
        */
       nameFromFilename(filename) {
-        this._name = path2.basename(filename, path2.extname(filename));
+        this._name = path3.basename(filename, path3.extname(filename));
         return this;
       }
       /**
@@ -2935,9 +2935,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [path]
        * @return {string|null|Command}
        */
-      executableDir(path3) {
-        if (path3 === void 0) return this._executableDir;
-        this._executableDir = path3;
+      executableDir(path4) {
+        if (path4 === void 0) return this._executableDir;
+        this._executableDir = path4;
         return this;
       }
       /**
@@ -8456,10 +8456,10 @@ var require_util = __commonJS({
     function cloneDef2(schema) {
       return mergeDefs2(schema._zod.def);
     }
-    function getElementAtPath2(obj, path2) {
-      if (!path2)
+    function getElementAtPath2(obj, path3) {
+      if (!path3)
         return obj;
-      return path2.reduce((acc, key) => acc?.[key], obj);
+      return path3.reduce((acc, key) => acc?.[key], obj);
     }
     function promiseAllObject2(promisesObj) {
       const keys = Object.keys(promisesObj);
@@ -8821,11 +8821,11 @@ var require_util = __commonJS({
       }
       return false;
     }
-    function prefixIssues2(path2, issues) {
+    function prefixIssues2(path3, issues) {
       return issues.map((iss) => {
         var _a;
         (_a = iss).path ?? (_a.path = []);
-        iss.path.unshift(path2);
+        iss.path.unshift(path3);
         return iss;
       });
     }
@@ -9029,7 +9029,7 @@ var require_errors2 = __commonJS({
     }
     function treeifyError2(error46, mapper = (issue2) => issue2.message) {
       const result = { errors: [] };
-      const processError = (error47, path2 = []) => {
+      const processError = (error47, path3 = []) => {
         var _a, _b;
         for (const issue2 of error47.issues) {
           if (issue2.code === "invalid_union" && issue2.errors.length) {
@@ -9039,7 +9039,7 @@ var require_errors2 = __commonJS({
           } else if (issue2.code === "invalid_element") {
             processError({ issues: issue2.issues }, issue2.path);
           } else {
-            const fullpath = [...path2, ...issue2.path];
+            const fullpath = [...path3, ...issue2.path];
             if (fullpath.length === 0) {
               result.errors.push(mapper(issue2));
               continue;
@@ -9071,8 +9071,8 @@ var require_errors2 = __commonJS({
     }
     function toDotPath2(_path) {
       const segs = [];
-      const path2 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-      for (const seg of path2) {
+      const path3 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+      for (const seg of path3) {
         if (typeof seg === "number")
           segs.push(`[${seg}]`);
         else if (typeof seg === "symbol")
@@ -24771,10 +24771,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path2) {
-  if (!path2)
+function getElementAtPath(obj, path3) {
+  if (!path3)
     return obj;
-  return path2.reduce((acc, key) => acc?.[key], obj);
+  return path3.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -25135,11 +25135,11 @@ function aborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path2, issues) {
+function prefixIssues(path3, issues) {
   return issues.map((iss) => {
     var _a;
     (_a = iss).path ?? (_a.path = []);
-    iss.path.unshift(path2);
+    iss.path.unshift(path3);
     return iss;
   });
 }
@@ -25301,7 +25301,7 @@ function formatError(error46, mapper = (issue2) => issue2.message) {
 }
 function treeifyError(error46, mapper = (issue2) => issue2.message) {
   const result = { errors: [] };
-  const processError = (error47, path2 = []) => {
+  const processError = (error47, path3 = []) => {
     var _a, _b;
     for (const issue2 of error47.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
@@ -25311,7 +25311,7 @@ function treeifyError(error46, mapper = (issue2) => issue2.message) {
       } else if (issue2.code === "invalid_element") {
         processError({ issues: issue2.issues }, issue2.path);
       } else {
-        const fullpath = [...path2, ...issue2.path];
+        const fullpath = [...path3, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -25343,8 +25343,8 @@ function treeifyError(error46, mapper = (issue2) => issue2.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path2 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path2) {
+  const path3 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path3) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -36610,126 +36610,6 @@ var DateRangeSchema = external_exports.object({
   endDate: external_exports.string().datetime()
 });
 
-// ../core/src/platform/registry/domains.ts
-var DOMAINS = {
-  // Business domains
-  INBOUND_PIPELINE: "inbound-pipeline",
-  LEAD_GEN_PIPELINE: "lead-gen-pipeline",
-  SUPPORT: "support",
-  CLIENT_SUPPORT: "client-support",
-  DELIVERY: "delivery",
-  OPERATIONS: "operations",
-  FINANCE: "finance",
-  EXECUTIVE: "executive",
-  INSTANTLY: "instantly",
-  // Technical domains
-  TESTING: "testing",
-  INTERNAL: "internal",
-  INTEGRATION: "integration",
-  UTILITY: "utility",
-  DIAGNOSTIC: "diagnostic"
-};
-var INBOUND_PIPELINE_DOMAIN = {
-  id: DOMAINS.INBOUND_PIPELINE,
-  name: "Inbound Pipeline",
-  description: "End-to-end inbound client acquisition from first reply to onboarding",
-  color: "blue"
-};
-var LEAD_GEN_PIPELINE_DOMAIN = {
-  id: DOMAINS.LEAD_GEN_PIPELINE,
-  name: "Lead Gen Pipeline",
-  description: "Lead scraping, enrichment, qualification, and personalization",
-  color: "cyan"
-};
-var SUPPORT_DOMAIN = {
-  id: DOMAINS.SUPPORT,
-  name: "Customer Support",
-  description: "Ticket triage, knowledge base, escalations",
-  color: "green"
-};
-var CLIENT_SUPPORT_DOMAIN = {
-  id: DOMAINS.CLIENT_SUPPORT,
-  name: "Client Support",
-  description: "Client change requests, bug reports, and feature requests",
-  color: "teal"
-};
-var DELIVERY_DOMAIN = {
-  id: DOMAINS.DELIVERY,
-  name: "Client Delivery",
-  description: "Project execution and milestone tracking",
-  color: "orange"
-};
-var OPERATIONS_DOMAIN = {
-  id: DOMAINS.OPERATIONS,
-  name: "Operations",
-  description: "Internal business operations and administration",
-  color: "violet"
-};
-var FINANCE_DOMAIN = {
-  id: DOMAINS.FINANCE,
-  name: "Finance",
-  description: "Billing, invoicing, and financial operations",
-  color: "pink"
-};
-var EXECUTIVE_DOMAIN = {
-  id: DOMAINS.EXECUTIVE,
-  name: "Executive Operations",
-  description: "High-level business orchestration and decision-making",
-  color: "indigo"
-};
-var TESTING_DOMAIN = {
-  id: DOMAINS.TESTING,
-  name: "Testing",
-  description: "Test resources and development workflows",
-  color: "gray"
-};
-var INTERNAL_DOMAIN = {
-  id: DOMAINS.INTERNAL,
-  name: "Internal",
-  description: "Internal platform resources",
-  color: "dark"
-};
-var INTEGRATION_DOMAIN = {
-  id: DOMAINS.INTEGRATION,
-  name: "Integration",
-  description: "External service integrations",
-  color: "teal"
-};
-var INSTANTLY_DOMAIN = {
-  id: DOMAINS.INSTANTLY,
-  name: "Instantly Toolkit",
-  description: "Instantly campaign creation, analytics, and optimization",
-  color: "lime"
-};
-var UTILITY_DOMAIN = {
-  id: DOMAINS.UTILITY,
-  name: "Utility",
-  description: "Utility workflows for maintenance and diagnostics",
-  color: "grape"
-};
-var DIAGNOSTIC_DOMAIN = {
-  id: DOMAINS.DIAGNOSTIC,
-  name: "Diagnostic",
-  description: "Diagnostic workflows for testing integrations and services",
-  color: "yellow"
-};
-var DOMAIN_MAP = {
-  [DOMAINS.INBOUND_PIPELINE]: INBOUND_PIPELINE_DOMAIN,
-  [DOMAINS.LEAD_GEN_PIPELINE]: LEAD_GEN_PIPELINE_DOMAIN,
-  [DOMAINS.SUPPORT]: SUPPORT_DOMAIN,
-  [DOMAINS.CLIENT_SUPPORT]: CLIENT_SUPPORT_DOMAIN,
-  [DOMAINS.DELIVERY]: DELIVERY_DOMAIN,
-  [DOMAINS.OPERATIONS]: OPERATIONS_DOMAIN,
-  [DOMAINS.FINANCE]: FINANCE_DOMAIN,
-  [DOMAINS.EXECUTIVE]: EXECUTIVE_DOMAIN,
-  [DOMAINS.TESTING]: TESTING_DOMAIN,
-  [DOMAINS.INTERNAL]: INTERNAL_DOMAIN,
-  [DOMAINS.INSTANTLY]: INSTANTLY_DOMAIN,
-  [DOMAINS.INTEGRATION]: INTEGRATION_DOMAIN,
-  [DOMAINS.UTILITY]: UTILITY_DOMAIN,
-  [DOMAINS.DIAGNOSTIC]: DIAGNOSTIC_DOMAIN
-};
-
 // ../core/src/platform/registry/reserved.ts
 var RESERVED_RESOURCE_IDS = /* @__PURE__ */ new Set(["command-center-assistant"]);
 var SYSTEM_RESOURCE_IDS = Array.from(RESERVED_RESOURCE_IDS);
@@ -39570,16 +39450,6 @@ function serializeAllOrganizations(registry2) {
   }
   return cache;
 }
-function deriveDomainDefinitions(resources) {
-  const domainIds = /* @__PURE__ */ new Set();
-  resources.workflows?.forEach((w) => w.config.domains?.forEach((d) => domainIds.add(d)));
-  resources.agents?.forEach((a) => a.config.domains?.forEach((d) => domainIds.add(d)));
-  resources.triggers?.forEach((t) => t.domains?.forEach((d) => domainIds.add(d)));
-  resources.integrations?.forEach((i) => i.domains?.forEach((d) => domainIds.add(d)));
-  resources.externalResources?.forEach((e) => e.domains?.forEach((d) => domainIds.add(d)));
-  resources.humanCheckpoints?.forEach((h) => h.domains?.forEach((d) => domainIds.add(d)));
-  return Array.from(domainIds).map((id) => DOMAIN_MAP[id]);
-}
 function serializeOrganization(resources) {
   const workflowDefinitions = /* @__PURE__ */ new Map();
   const workflowResources = [];
@@ -39594,7 +39464,9 @@ function serializeOrganization(resources) {
       description: workflow.config.description,
       version: workflow.config.version,
       type: "workflow",
-      status: workflow.config.status
+      status: workflow.config.status,
+      links: workflow.config.links,
+      category: workflow.config.category
     });
     commandViewWorkflows.push({
       resourceId,
@@ -39603,7 +39475,8 @@ function serializeOrganization(resources) {
       version: workflow.config.version,
       type: "workflow",
       status: workflow.config.status,
-      domains: workflow.config.domains,
+      links: workflow.config.links,
+      category: workflow.config.category,
       stepCount: Object.keys(workflow.steps).length,
       entryPoint: workflow.entryPoint
     });
@@ -39621,7 +39494,9 @@ function serializeOrganization(resources) {
       description: agent.config.description,
       version: agent.config.version,
       type: "agent",
-      status: agent.config.status
+      status: agent.config.status,
+      links: agent.config.links,
+      category: agent.config.category
     });
     commandViewAgents.push({
       resourceId,
@@ -39630,7 +39505,8 @@ function serializeOrganization(resources) {
       version: agent.config.version,
       type: "agent",
       status: agent.config.status,
-      domains: agent.config.domains,
+      links: agent.config.links,
+      category: agent.config.category,
       modelProvider: agent.modelConfig.provider,
       modelId: agent.modelConfig.model,
       toolCount: agent.tools.length,
@@ -39644,7 +39520,6 @@ function serializeOrganization(resources) {
   const integrations = resources.integrations ?? [];
   const externalResources = resources.externalResources ?? [];
   const humanCheckpoints = resources.humanCheckpoints ?? [];
-  const domainDefinitions = deriveDomainDefinitions(resources);
   return {
     version: resources.version,
     resources: {
@@ -39663,8 +39538,7 @@ function serializeOrganization(resources) {
       integrations,
       externalResources,
       humanCheckpoints,
-      edges,
-      domainDefinitions
+      edges
     },
     triggers,
     integrations,
@@ -39922,7 +39796,8 @@ var ResourceRegistry = class {
       version: def.config.version,
       type: def.config.type,
       status: def.config.status,
-      domains: def.config.domains,
+      links: def.config.links,
+      category: def.config.category,
       origin: this.remoteResources.has(`${organizationName}/${def.config.resourceId}`) ? "remote" : "local"
     })).filter((resource) => !environment || resource.status === environment);
     const agents = (orgResources.agents || []).map((def) => ({
@@ -39932,7 +39807,8 @@ var ResourceRegistry = class {
       version: def.config.version,
       type: def.config.type,
       status: def.config.status,
-      domains: def.config.domains,
+      links: def.config.links,
+      category: def.config.category,
       sessionCapable: def.config.sessionCapable ?? false,
       origin: this.remoteResources.has(`${organizationName}/${def.config.resourceId}`) ? "remote" : "local"
     })).filter((resource) => !environment || resource.status === environment);
@@ -40447,7 +40323,9 @@ function resolveProjectRelative(relOrAbsPath) {
   return (0, import_path.resolve)(getProjectRoot(), relOrAbsPath);
 }
 function findEnvFile(_startDir) {
-  const candidate = (0, import_path.join)(getProjectRoot(), ".env");
+  const projectRoot = tryFindProjectRoot(process.cwd());
+  if (projectRoot === null) return void 0;
+  const candidate = (0, import_path.join)(projectRoot, ".env");
   return (0, import_fs.existsSync)(candidate) ? candidate : void 0;
 }
 function findPackageRoot(startDir) {
@@ -40580,7 +40458,7 @@ function wrapAction(commandName, fn) {
 // package.json
 var package_default = {
   name: "@elevasis/sdk",
-  version: "1.9.0",
+  version: "1.11.0",
   description: "SDK for building Elevasis organization resources",
   type: "module",
   bin: {
@@ -40594,6 +40472,10 @@ var package_default = {
     "./worker": {
       types: "./dist/types/worker/index.d.ts",
       import: "./dist/worker/index.js"
+    },
+    "./test-utils": {
+      types: "./dist/test-utils/index.d.ts",
+      import: "./dist/test-utils/index.js"
     }
   },
   files: [
@@ -40603,6 +40485,8 @@ var package_default = {
     "dist/types/worker/index.d.ts",
     "dist/types/worker/platform.d.ts",
     "dist/types/worker/adapters/",
+    "dist/test-utils/index.js",
+    "dist/test-utils/index.d.ts",
     "dist/cli.cjs",
     "reference/"
   ],
@@ -40675,7 +40559,8 @@ function extractResourceMetadata(resource, schemaWarnings) {
     version: resource.config.version,
     status: resource.config.status,
     description: resource.config.description,
-    domains: resource.config.domains
+    links: resource.config.links,
+    category: resource.config.category
   };
   if (resource.contract.inputSchema) {
     try {
@@ -41463,7 +41348,10 @@ function registerDescribeCommand(program3) {
       if (config3.description) console.log(source_default.gray("Description:"), config3.description);
       console.log(source_default.gray("Version:"), config3.version);
       console.log(source_default.gray("Status:"), config3.status);
-      if (config3.domains?.length) console.log(source_default.gray("Domains:"), config3.domains.join(", "));
+      if (config3.category) console.log(source_default.gray("Category:"), config3.category);
+      if (config3.links?.length) {
+        console.log(source_default.gray("Links:"), config3.links.map((link) => `${link.kind} ${link.nodeId}`).join(", "));
+      }
       console.log();
       const inputSchema = contract?.inputSchema;
       const outputSchema = contract?.outputSchema;
@@ -42956,9 +42844,151 @@ ${issues}`);
   );
 }
 
-// src/cli/commands/doctor.ts
-var import_node_fs3 = require("node:fs");
+// src/cli/commands/ui/ui-switcher.ts
+var import_node_child_process = require("node:child_process");
+var import_node_fs3 = __toESM(require("node:fs"), 1);
 var import_node_path3 = __toESM(require("node:path"), 1);
+function run(command, args, cwd) {
+  (0, import_node_child_process.execFileSync)(command, args, {
+    cwd,
+    stdio: "inherit",
+    shell: process.platform === "win32"
+  });
+}
+function readJson(filePath) {
+  return JSON.parse(import_node_fs3.default.readFileSync(filePath, "utf8"));
+}
+function writeJson(filePath, value) {
+  import_node_fs3.default.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}
+`);
+}
+function requireDependencies(packageJson, filePath) {
+  if (!packageJson.dependencies) {
+    throw new Error(`${filePath} does not define dependencies`);
+  }
+  return packageJson.dependencies;
+}
+function resolveExistingDir(label, dir) {
+  const resolved = import_node_path3.default.resolve(dir);
+  if (!import_node_fs3.default.existsSync(resolved) || !import_node_fs3.default.statSync(resolved).isDirectory()) {
+    throw new Error(`${label} not found: ${resolved}`);
+  }
+  return resolved;
+}
+function findRepoRootFromProject(projectRoot) {
+  let dir = projectRoot;
+  while (true) {
+    if (import_node_fs3.default.existsSync(import_node_path3.default.join(dir, "packages", "ui", "package.json"))) return dir;
+    const parent = import_node_path3.default.dirname(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+}
+function resolveUiPackageRoot(projectRoot, explicitRoot) {
+  if (explicitRoot) return resolveExistingDir("UI package root", explicitRoot);
+  const repoRoot = findRepoRootFromProject(projectRoot);
+  if (repoRoot === null) {
+    throw new Error(
+      "Could not find packages/ui from this Elevasis project. Pass --ui-package-root <path> from a monorepo checkout."
+    );
+  }
+  return import_node_path3.default.join(repoRoot, "packages", "ui");
+}
+function removeLocalUiTarballs(templateTmpDir) {
+  if (!import_node_fs3.default.existsSync(templateTmpDir)) return;
+  for (const entry of import_node_fs3.default.readdirSync(templateTmpDir)) {
+    if (entry.startsWith("elevasis-ui-") && entry.endsWith(".tgz")) {
+      import_node_fs3.default.rmSync(import_node_path3.default.join(templateTmpDir, entry), { force: true });
+    }
+  }
+}
+function prepareUiPackageForPack(uiPackageJson) {
+  const publishConfig = uiPackageJson.publishConfig ?? {};
+  const packedPackageJson = {
+    ...uiPackageJson,
+    name: publishConfig.name ?? uiPackageJson.name
+  };
+  if (publishConfig.exports) packedPackageJson.exports = publishConfig.exports;
+  if (publishConfig.peerDependencies) packedPackageJson.peerDependencies = publishConfig.peerDependencies;
+  if (publishConfig.peerDependenciesMeta) packedPackageJson.peerDependenciesMeta = publishConfig.peerDependenciesMeta;
+  delete packedPackageJson.publishConfig;
+  return packedPackageJson;
+}
+function useLocalUi(options = {}) {
+  const projectRoot = getProjectRoot();
+  const repoRoot = findRepoRootFromProject(projectRoot);
+  const uiPackageRoot = resolveUiPackageRoot(projectRoot, options.uiPackageRoot);
+  const commandRoot = repoRoot ?? import_node_path3.default.dirname(import_node_path3.default.dirname(uiPackageRoot));
+  const templateUiPackageJsonPath = import_node_path3.default.join(projectRoot, "ui", "package.json");
+  const templateTmpDir = import_node_path3.default.join(projectRoot, "tmp");
+  const uiPackageJsonPath = import_node_path3.default.join(uiPackageRoot, "package.json");
+  const uiPackageBackupPath = import_node_path3.default.join(uiPackageRoot, "package.json.local-pack.bak");
+  if (!import_node_fs3.default.existsSync(templateUiPackageJsonPath)) {
+    throw new Error(`Template UI package.json not found: ${templateUiPackageJsonPath}`);
+  }
+  import_node_fs3.default.mkdirSync(templateTmpDir, { recursive: true });
+  removeLocalUiTarballs(templateTmpDir);
+  run("pnpm", ["--filter", "@repo/ui", "build:publish"], commandRoot);
+  try {
+    const raw = import_node_fs3.default.readFileSync(uiPackageJsonPath, "utf8");
+    import_node_fs3.default.writeFileSync(uiPackageBackupPath, raw);
+    writeJson(uiPackageJsonPath, prepareUiPackageForPack(JSON.parse(raw)));
+    run("pnpm", ["-C", uiPackageRoot, "pack", "--pack-destination", templateTmpDir], commandRoot);
+  } finally {
+    if (import_node_fs3.default.existsSync(uiPackageBackupPath)) {
+      import_node_fs3.default.copyFileSync(uiPackageBackupPath, uiPackageJsonPath);
+      import_node_fs3.default.rmSync(uiPackageBackupPath, { force: true });
+    }
+  }
+  const tarballName = import_node_fs3.default.readdirSync(templateTmpDir).find((entry) => entry.startsWith("elevasis-ui-") && entry.endsWith(".tgz"));
+  if (!tarballName) {
+    throw new Error(`Failed to create local @elevasis/ui tarball in ${templateTmpDir}`);
+  }
+  const templateUiPackageJson = readJson(templateUiPackageJsonPath);
+  requireDependencies(templateUiPackageJson, templateUiPackageJsonPath)["@elevasis/ui"] = `file:../tmp/${tarballName}`;
+  writeJson(templateUiPackageJsonPath, templateUiPackageJson);
+  run("pnpm", ["-C", projectRoot, "install"], commandRoot);
+  console.log(`${import_node_path3.default.basename(projectRoot)}/ui now uses local @elevasis/ui tarball: ${tarballName}`);
+}
+function usePublishedUi(options = {}) {
+  const projectRoot = getProjectRoot();
+  const repoRoot = findRepoRootFromProject(projectRoot);
+  const commandRoot = repoRoot ?? projectRoot;
+  const templateUiPackageJsonPath = import_node_path3.default.join(projectRoot, "ui", "package.json");
+  const templateTmpDir = import_node_path3.default.join(projectRoot, "tmp");
+  const uiPackageRoot = options.version ? void 0 : resolveUiPackageRoot(projectRoot, options.uiPackageRoot);
+  const uiVersion = options.version ?? readJson(import_node_path3.default.join(uiPackageRoot, "package.json")).version;
+  if (!uiVersion) {
+    throw new Error("Could not determine @elevasis/ui version. Pass --version <version>.");
+  }
+  if (!import_node_fs3.default.existsSync(templateUiPackageJsonPath)) {
+    throw new Error(`Template UI package.json not found: ${templateUiPackageJsonPath}`);
+  }
+  const templateUiPackageJson = readJson(templateUiPackageJsonPath);
+  requireDependencies(templateUiPackageJson, templateUiPackageJsonPath)["@elevasis/ui"] = `^${uiVersion}`;
+  writeJson(templateUiPackageJsonPath, templateUiPackageJson);
+  removeLocalUiTarballs(templateTmpDir);
+  run("pnpm", ["-C", projectRoot, "install"], commandRoot);
+  console.log(`${import_node_path3.default.basename(projectRoot)}/ui restored to published @elevasis/ui ^${uiVersion}`);
+}
+
+// src/cli/commands/ui/ui.ts
+function registerUiCommands(program3) {
+  program3.command("ui:use-local").description("Switch this Elevasis project to a local @elevasis/ui tarball").option("--ui-package-root <path>", "Path to the local packages/ui checkout").action(
+    wrapAction("ui:use-local", async (options) => {
+      useLocalUi(options);
+    })
+  );
+  program3.command("ui:use-published").description("Restore this Elevasis project to a published @elevasis/ui dependency").option("--ui-package-root <path>", "Path to the local packages/ui checkout used to infer the version").option("--version <version>", "Explicit @elevasis/ui version to restore").action(
+    wrapAction("ui:use-published", async (options) => {
+      usePublishedUi(options);
+    })
+  );
+}
+
+// src/cli/commands/doctor.ts
+var import_node_fs4 = require("node:fs");
+var import_node_path4 = __toESM(require("node:path"), 1);
 function ok(label, detail) {
   console.log(`${source_default.green("[OK]")}   ${source_default.bold(label)}: ${detail}`);
 }
@@ -42994,8 +43024,8 @@ function registerDoctorCommand(program3) {
       printSummary(failCount);
       process.exit(1);
     }
-    const envPath2 = import_node_path3.default.join(projectRoot, ".env");
-    const envExists = (0, import_node_fs3.existsSync)(envPath2);
+    const envPath2 = import_node_path4.default.join(projectRoot, ".env");
+    const envExists = (0, import_node_fs4.existsSync)(envPath2);
     if (!envExists) {
       fail(".env", `Not found at ${envPath2}. Create it from .env.example and fill in ELEVASIS_PLATFORM_KEY.`);
       if (isVerbose) verbose(`Checked: ${envPath2}`);
@@ -43084,11 +43114,15 @@ function printSummary(failCount) {
 
 // src/cli/index.ts
 var PREFLIGHT_SKIP_FLAGS = /* @__PURE__ */ new Set(["--help", "-h", "--version", "-V"]);
+var LOCAL_PROJECT_COMMANDS = /* @__PURE__ */ new Set(["ui:use-local", "ui:use-published"]);
 function shouldSkipPreflight() {
   const args = process.argv.slice(2);
   if (args.length === 0) return true;
   return args.every((a) => PREFLIGHT_SKIP_FLAGS.has(a));
 }
+function isLocalProjectCommand() {
+  return LOCAL_PROJECT_COMMANDS.has(process.argv[2] ?? "");
+}
 function runPreflight() {
   if (shouldSkipPreflight()) return;
   const projectRoot = tryFindProjectRoot(process.cwd());
@@ -43101,6 +43135,7 @@ function runPreflight() {
     );
     process.exit(1);
   }
+  if (isLocalProjectCommand()) return;
   const envPath2 = (0, import_path3.join)(projectRoot, ".env");
   if (!(0, import_fs2.existsSync)(envPath2)) {
     process.stderr.write(source_default.red(`No \`.env\` found at \`${envPath2}\`. Set \`ELEVASIS_PLATFORM_KEY\`.
@@ -43142,6 +43177,8 @@ Commands:
   elevasis-sdk project:resolve <query>              Resolve a project ID from a name or UUID
   elevasis-sdk project:work <query>                 Open a lifecycle-aware project work brief
   elevasis-sdk request:submit -f <path>             Submit a structured request report
+  elevasis-sdk ui:use-local                         Use a local @elevasis/ui tarball
+  elevasis-sdk ui:use-published                     Restore published @elevasis/ui
   elevasis-sdk rename <id> --to <newId> [--prod]     Rename resource across platform tables
   elevasis-sdk doctor [--verbose]                    Check project environment and API connectivity
 
@@ -43163,6 +43200,7 @@ registerErrorCommand(program2);
 registerRenameCommand(program2);
 registerProjectCommands(program2);
 registerRequestCommands(program2);
+registerUiCommands(program2);
 registerDoctorCommand(program2);
 program2.parse();
 // Annotate the CommonJS export names for ESM import in node: