@lotics/cli 0.156.3 → 0.156.5

package/dist/src/cli.js

@@ -26822,12 +26822,12 @@ var require_tokens = __commonJS({
       });
     }
     exports2.assignCategoriesMapProp = assignCategoriesMapProp;
-    function singleAssignCategoriesToksMap(path12, nextNode) {
-      utils_1.forEach(path12, function(pathNode) {
+    function singleAssignCategoriesToksMap(path13, nextNode) {
+      utils_1.forEach(path13, function(pathNode) {
         nextNode.categoryMatchesMap[pathNode.tokenTypeIdx] = true;
       });
       utils_1.forEach(nextNode.CATEGORIES, function(nextCategory) {
-        var newPath = path12.concat(nextNode);
+        var newPath = path13.concat(nextNode);
         if (!utils_1.contains(newPath, nextCategory)) {
           singleAssignCategoriesToksMap(newPath, nextCategory);
         }
@@ -28590,10 +28590,10 @@ var require_interpreter = __commonJS({
       /** @class */
       (function(_super) {
         __extends(AbstractNextPossibleTokensWalker2, _super);
-        function AbstractNextPossibleTokensWalker2(topProd, path12) {
+        function AbstractNextPossibleTokensWalker2(topProd, path13) {
           var _this = _super.call(this) || this;
           _this.topProd = topProd;
-          _this.path = path12;
+          _this.path = path13;
           _this.possibleTokTypes = [];
           _this.nextProductionName = "";
           _this.nextProductionOccurrence = 0;
@@ -28647,9 +28647,9 @@ var require_interpreter = __commonJS({
       /** @class */
       (function(_super) {
         __extends(NextAfterTokenWalker2, _super);
-        function NextAfterTokenWalker2(topProd, path12) {
-          var _this = _super.call(this, topProd, path12) || this;
-          _this.path = path12;
+        function NextAfterTokenWalker2(topProd, path13) {
+          var _this = _super.call(this, topProd, path13) || this;
+          _this.path = path13;
           _this.nextTerminalName = "";
           _this.nextTerminalOccurrence = 0;
           _this.nextTerminalName = _this.path.lastTok.name;
@@ -29346,10 +29346,10 @@ var require_lookahead = __commonJS({
       }
       return result;
     }
-    function pathToHashKeys(path12) {
+    function pathToHashKeys(path13) {
       var keys3 = [""];
-      for (var i2 = 0; i2 < path12.length; i2++) {
-        var tokType = path12[i2];
+      for (var i2 = 0; i2 < path13.length; i2++) {
+        var tokType = path13[i2];
         var longerKeys = [];
         for (var j = 0; j < keys3.length; j++) {
           var currShorterKey = keys3[j];
@@ -29661,9 +29661,9 @@ var require_checks = __commonJS({
       return errors2;
     }
     exports2.validateRuleIsOverridden = validateRuleIsOverridden;
-    function validateNoLeftRecursion(topRule, currRule, errMsgProvider, path12) {
-      if (path12 === void 0) {
-        path12 = [];
+    function validateNoLeftRecursion(topRule, currRule, errMsgProvider, path13) {
+      if (path13 === void 0) {
+        path13 = [];
       }
       var errors2 = [];
       var nextNonTerminals = getFirstNoneTerminal(currRule.definition);
@@ -29676,15 +29676,15 @@ var require_checks = __commonJS({
           errors2.push({
             message: errMsgProvider.buildLeftRecursionError({
               topLevelRule: topRule,
-              leftRecursionPath: path12
+              leftRecursionPath: path13
             }),
             type: parser_1.ParserDefinitionErrorType.LEFT_RECURSION,
             ruleName
           });
         }
-        var validNextSteps = utils2.difference(nextNonTerminals, path12.concat([topRule]));
+        var validNextSteps = utils2.difference(nextNonTerminals, path13.concat([topRule]));
         var errorsFromNextSteps = utils2.map(validNextSteps, function(currRefRule) {
-          var newPath = utils2.cloneArr(path12);
+          var newPath = utils2.cloneArr(path13);
           newPath.push(currRefRule);
           return validateNoLeftRecursion(topRule, currRefRule, errMsgProvider, newPath);
         });
@@ -37293,8 +37293,8 @@ var require_utils4 = __commonJS({
       var result = transform2[inputType][outputType](input);
       return result;
     };
-    exports2.resolve = function(path12) {
-      var parts = path12.split("/");
+    exports2.resolve = function(path13) {
+      var parts = path13.split("/");
       var result = [];
       for (var index = 0; index < parts.length; index++) {
         var part = parts[index];
@@ -43147,18 +43147,18 @@ var require_object = __commonJS({
       var object2 = new ZipObject(name2, zipObjectContent, o);
       this.files[name2] = object2;
     };
-    var parentFolder = function(path12) {
-      if (path12.slice(-1) === "/") {
-        path12 = path12.substring(0, path12.length - 1);
+    var parentFolder = function(path13) {
+      if (path13.slice(-1) === "/") {
+        path13 = path13.substring(0, path13.length - 1);
       }
-      var lastSlash = path12.lastIndexOf("/");
-      return lastSlash > 0 ? path12.substring(0, lastSlash) : "";
+      var lastSlash = path13.lastIndexOf("/");
+      return lastSlash > 0 ? path13.substring(0, lastSlash) : "";
     };
-    var forceTrailingSlash = function(path12) {
-      if (path12.slice(-1) !== "/") {
-        path12 += "/";
+    var forceTrailingSlash = function(path13) {
+      if (path13.slice(-1) !== "/") {
+        path13 += "/";
       }
-      return path12;
+      return path13;
     };
     var folderAdd = function(name2, createFolders) {
       createFolders = typeof createFolders !== "undefined" ? createFolders : defaults2.createFolders;
@@ -44162,7 +44162,7 @@ import dns from "node:dns";
 import net2 from "node:net";
 import fs13 from "node:fs";
 import os4 from "node:os";
-import path11 from "node:path";
+import path12 from "node:path";
 import readline from "node:readline";
 
 // ../shared/src/transport_error.ts
@@ -44356,8 +44356,8 @@ var LoticsClient = class {
     }
     return headers;
   }
-  async request(method, path12, body) {
-    const url2 = `${this.baseUrl}${path12}`;
+  async request(method, path13, body) {
+    const url2 = `${this.baseUrl}${path13}`;
     const headers = this.buildHeaders();
     const init = { method, headers };
     if (body !== void 0) {
@@ -46206,7 +46206,7 @@ async function reportCommand(client, options) {
 
 // src/app_commands.ts
 import fs8 from "node:fs";
-import path9 from "node:path";
+import path10 from "node:path";
 import { spawn as spawn2 } from "node:child_process";
 import { createHash as createHash3 } from "node:crypto";
 import { tmpdir } from "node:os";
@@ -46964,6 +46964,8 @@ function escapeHtml(s) {
 // src/dev/server.ts
 import http from "node:http";
 import net from "node:net";
+import { existsSync } from "node:fs";
+import path8 from "node:path";
 import { spawn } from "node:child_process";
 
 // src/child_env.ts
@@ -47535,6 +47537,7 @@ function createFileRelay(wrapperOrigin, now = Date.now) {
 // src/dev/server.ts
 var DEFAULT_PORT = 5174;
 var DEFAULT_VITE_PORT = 5173;
+var STOP_DEADLINE_MS = 2e3;
 function serializeRpcResult(result) {
   return JSON.stringify(result ?? null);
 }
@@ -47549,9 +47552,15 @@ async function startDevServer(args) {
     vite_url: viteUrl,
     api_url: args.api_url
   });
+  const viteEntry = path8.join(args.projectDir, "node_modules", "vite", "bin", "vite.js");
+  if (!existsSync(viteEntry)) {
+    throw new Error(
+      `Vite is not installed in ${args.projectDir} \u2014 run \`npm install\` there first.`
+    );
+  }
   const viteChild = spawn(
-    "npx",
-    ["vite", "--port", String(vitePort), "--strictPort"],
+    process.execPath,
+    [viteEntry, "--port", String(vitePort), "--strictPort"],
     {
       cwd: args.projectDir,
       stdio: [process.stdin.isTTY ? "inherit" : "ignore", "inherit", "inherit"],
@@ -47819,7 +47828,14 @@ async function startDevServer(args) {
     if (!viteChild.killed) {
       viteChild.kill("SIGINT");
     }
-    await new Promise((resolve2) => server.close(() => resolve2()));
+    await new Promise((resolve2) => {
+      const done = setTimeout(resolve2, STOP_DEADLINE_MS);
+      server.close(() => {
+        clearTimeout(done);
+        resolve2();
+      });
+      server.closeAllConnections();
+    });
     stoppingResolve?.();
   }
   const ready = new Promise((resolve2) => {
@@ -48519,7 +48535,7 @@ export type AppRoles = typeof ROLE;
 
 // src/app_workflow_check.ts
 import fs7 from "node:fs";
-import path8 from "node:path";
+import path9 from "node:path";
 import { createRequire } from "node:module";
 
 // ../shared/src/parse_workflow_js.ts
@@ -49291,10 +49307,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path12) {
-  if (!path12)
+function getElementAtPath(obj, path13) {
+  if (!path13)
     return obj;
-  return path12.reduce((acc, key) => acc?.[key], obj);
+  return path13.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys3 = Object.keys(promisesObj);
@@ -49703,11 +49719,11 @@ function explicitlyAborted(x2, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path12, issues) {
+function prefixIssues(path13, issues) {
   return issues.map((iss) => {
     var _a4;
     (_a4 = iss).path ?? (_a4.path = []);
-    iss.path.unshift(path12);
+    iss.path.unshift(path13);
     return iss;
   });
 }
@@ -49854,16 +49870,16 @@ function flattenError(error52, mapper = (issue2) => issue2.message) {
 }
 function formatError(error52, mapper = (issue2) => issue2.message) {
   const fieldErrors = { _errors: [] };
-  const processError = (error53, path12 = []) => {
+  const processError = (error53, path13 = []) => {
     for (const issue2 of error53.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path12, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path13, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path12, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path13, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path12, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path13, ...issue2.path]);
       } else {
-        const fullpath = [...path12, ...issue2.path];
+        const fullpath = [...path13, ...issue2.path];
         if (fullpath.length === 0) {
           fieldErrors._errors.push(mapper(issue2));
         } else {
@@ -49890,17 +49906,17 @@ function formatError(error52, mapper = (issue2) => issue2.message) {
 }
 function treeifyError(error52, mapper = (issue2) => issue2.message) {
   const result = { errors: [] };
-  const processError = (error53, path12 = []) => {
+  const processError = (error53, path13 = []) => {
     var _a4, _b2;
     for (const issue2 of error53.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path12, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path13, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path12, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path13, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path12, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path13, ...issue2.path]);
       } else {
-        const fullpath = [...path12, ...issue2.path];
+        const fullpath = [...path13, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -49932,8 +49948,8 @@ function treeifyError(error52, mapper = (issue2) => issue2.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path12 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path12) {
+  const path13 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path13) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -62625,13 +62641,13 @@ function resolveRef(ref2, ctx) {
   if (!ref2.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path12 = ref2.slice(1).split("/").filter(Boolean);
-  if (path12.length === 0) {
+  const path13 = ref2.slice(1).split("/").filter(Boolean);
+  if (path13.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path12[0] === defsKey) {
-    const key = path12[1];
+  if (path13[0] === defsKey) {
+    const key = path13[1];
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref2}`);
     }
@@ -67341,9 +67357,9 @@ __export(expression_object_exports, {
   pick: () => pick3,
   values: () => values2
 });
-function getNestedValue(obj, path12) {
+function getNestedValue(obj, path13) {
   if (obj == null) return void 0;
-  const parts = path12.split(".");
+  const parts = path13.split(".");
   let value2 = obj;
   for (const part of parts) {
     if (value2 == null) return void 0;
@@ -67382,11 +67398,11 @@ function entries(obj) {
   }
   return Object.entries(obj);
 }
-function get(obj, path12, defaultValue) {
-  if (typeof path12 !== "string") {
+function get(obj, path13, defaultValue) {
+  if (typeof path13 !== "string") {
     throw new Error("get: path must be a string");
   }
-  const value2 = getNestedValue(obj, path12);
+  const value2 = getNestedValue(obj, path13);
   return value2 !== void 0 ? value2 : defaultValue;
 }
 function pick3(obj, fields) {
@@ -69269,17 +69285,17 @@ function readFromChanges(chain2) {
     if (first3.kind === "bracket-number" || first3.kind === "bracket-expr") {
       fail(first3.node, "changes is keyed by field name, not numeric index.");
     }
-    const path12 = [{ at: "key", key: first3.key }];
+    const path13 = [{ at: "key", key: first3.key }];
     for (const seg of segments.slice(1)) {
       if (seg.kind === "bracket-number") {
-        path12.push({ at: "index", index: seg.index });
+        path13.push({ at: "index", index: seg.index });
       } else if (seg.kind === "bracket-expr") {
-        path12.push({ at: "index", index: seg.expr });
+        path13.push({ at: "index", index: seg.expr });
       } else {
-        path12.push({ at: "key", key: seg.key });
+        path13.push({ at: "key", key: seg.key });
       }
     }
-    return { kind: "read", source: { from: "trigger_changes" }, path: path12 };
+    return { kind: "read", source: { from: "trigger_changes" }, path: path13 };
   });
 }
 var TRIGGER_RECORD_VIEWS = /* @__PURE__ */ new Map([
@@ -69297,17 +69313,17 @@ function readFromTrigger(chain2) {
     return view === "trigger_changes" ? readFromChanges(lowered) : readFromRecord(view, lowered);
   }
   return wrapOptionalGuards(chain2, (segments) => {
-    const path12 = [];
+    const path13 = [];
     for (const seg of segments) {
       if (seg.kind === "bracket-number") {
-        path12.push({ at: "index", index: seg.index });
+        path13.push({ at: "index", index: seg.index });
       } else if (seg.kind === "bracket-expr") {
-        path12.push({ at: "index", index: seg.expr });
+        path13.push({ at: "index", index: seg.expr });
       } else {
-        path12.push({ at: "key", key: seg.key });
+        path13.push({ at: "key", key: seg.key });
       }
     }
-    return { kind: "read", source: { from: "trigger" }, path: path12 };
+    return { kind: "read", source: { from: "trigger" }, path: path13 };
   });
 }
 function readFromRuntime(chain2) {
@@ -69329,17 +69345,17 @@ function readFromRuntime(chain2) {
     const parked = PARKED_RUNTIME_KEYS.get(key);
     if (parked) fail(first3.node, parked, parkedRuntimeKeyConstruct(key));
     const source = { from: "runtime", key };
-    const path12 = [];
+    const path13 = [];
     for (const seg of segments.slice(1)) {
       if (seg.kind === "bracket-number") {
-        path12.push({ at: "index", index: seg.index });
+        path13.push({ at: "index", index: seg.index });
       } else if (seg.kind === "bracket-expr") {
-        path12.push({ at: "index", index: seg.expr });
+        path13.push({ at: "index", index: seg.expr });
       } else {
-        path12.push({ at: "key", key: seg.key });
+        path13.push({ at: "key", key: seg.key });
       }
     }
-    return { kind: "read", source, path: path12 };
+    return { kind: "read", source, path: path13 };
   });
 }
 function readFromForeachItem(chain2) {
@@ -69375,17 +69391,17 @@ function readFromLexical(name2, chain2) {
 }
 function readFromStepOutput(stepId, chain2) {
   return wrapOptionalGuards(chain2, (segments) => {
-    const path12 = [];
+    const path13 = [];
     for (const seg of segments) {
       if (seg.kind === "bracket-number") {
-        path12.push({ at: "index", index: seg.index });
+        path13.push({ at: "index", index: seg.index });
       } else if (seg.kind === "bracket-expr") {
-        path12.push({ at: "index", index: seg.expr });
+        path13.push({ at: "index", index: seg.expr });
       } else {
-        path12.push({ at: "key", key: seg.key });
+        path13.push({ at: "key", key: seg.key });
       }
     }
-    return { kind: "read", source: { from: "step_output", step_id: stepId }, path: path12 };
+    return { kind: "read", source: { from: "step_output", step_id: stepId }, path: path13 };
   });
 }
 function classifyRecordPath(segs) {
@@ -71054,7 +71070,7 @@ function subsetIssues(bodySource, offset) {
   ];
 }
 async function loadProjectTypescript(projectDir) {
-  const requireFromProject = createRequire(path8.join(projectDir, "package.json"));
+  const requireFromProject = createRequire(path9.join(projectDir, "package.json"));
   let resolved;
   try {
     resolved = requireFromProject.resolve("typescript");
@@ -71067,9 +71083,9 @@ async function loadProjectTypescript(projectDir) {
   return mod2.default ?? mod2;
 }
 function pathToImportUrl(p) {
-  const resolved = path8.resolve(p);
+  const resolved = path9.resolve(p);
   const prefixed = resolved.startsWith("/") ? resolved : `/${resolved}`;
-  return `file://${prefixed.split(path8.sep).join("/")}`;
+  return `file://${prefixed.split(path9.sep).join("/")}`;
 }
 function checkOneWorkflowBody(tsApi, input) {
   const wrapped = fs7.readFileSync(input.bodyPath, "utf-8");
@@ -71119,7 +71135,7 @@ function checkOneWorkflowBody(tsApi, input) {
 }
 function createCheckedSourceHost(tsApi, options, bodyPath, bodyText) {
   const base = tsApi.createCompilerHost(options, false);
-  const key = (fileName) => base.getCanonicalFileName(path8.resolve(fileName).replace(/\\/g, "/"));
+  const key = (fileName) => base.getCanonicalFileName(path9.resolve(fileName).replace(/\\/g, "/"));
   const bodyKey = key(bodyPath);
   return {
     ...base,
@@ -72318,7 +72334,7 @@ function syncedEntry(entry) {
 function readSynced(projectDir) {
   try {
     const pkg2 = JSON.parse(
-      fs8.readFileSync(path9.join(projectDir, "package.json"), "utf-8")
+      fs8.readFileSync(path10.join(projectDir, "package.json"), "utf-8")
     );
     const raw = pkg2.lotics?.synced ?? {};
     return {
@@ -72339,16 +72355,16 @@ function normalizeSyncedMap(map3) {
   );
 }
 function writeSynced(projectDir, kind, alias, entry) {
-  const pkgPath2 = path9.join(projectDir, "package.json");
+  const pkgPath2 = path10.join(projectDir, "package.json");
   const pkg2 = JSON.parse(fs8.readFileSync(pkgPath2, "utf-8"));
   if (!pkg2.lotics) return;
   pkg2.lotics.synced ??= {};
   pkg2.lotics.synced[kind] = { ...pkg2.lotics.synced[kind], [alias]: entry };
   fs8.writeFileSync(pkgPath2, JSON.stringify(pkg2, null, 2) + "\n");
 }
-var WORKFLOWS_DIR = path9.join("src", "workflows");
-var WORKFLOW_GLOBALS_DIR = path9.join(".lotics", "workflows");
-var AGENTS_DIR = path9.join("src", "agents");
+var WORKFLOWS_DIR = path10.join("src", "workflows");
+var WORKFLOW_GLOBALS_DIR = path10.join(".lotics", "workflows");
+var AGENTS_DIR = path10.join("src", "agents");
 var WORKFLOW_TSCONFIG_EXCLUDES = ["src/workflows", ".lotics/workflows"];
 var LOTICS_INCLUDE_GLOB = ".lotics/**/*";
 var STALE_LOTICS_INCLUDES = /* @__PURE__ */ new Set([".lotics", "./.lotics", ".lotics/"]);
@@ -72359,7 +72375,7 @@ function isMissingWorkflowBodyError(error52) {
   return /has no step source|cannot be rendered|unsupported step/i.test(error52);
 }
 function workflowFileHeader(alias) {
-  const refPath = path9.join("..", "..", WORKFLOW_GLOBALS_DIR, `${alias}.globals.d.ts`).split(path9.sep).join("/");
+  const refPath = path10.join("..", "..", WORKFLOW_GLOBALS_DIR, `${alias}.globals.d.ts`).split(path10.sep).join("/");
   return (
     // The scaffold ships oxlint, whose `triple-slash-reference` rule flags the
     // line below — so every pulled body arrived with a warning its author could
@@ -72382,27 +72398,27 @@ export {};
   );
 }
 function workflowFilePath(projectDir, alias) {
-  return path9.join(projectDir, WORKFLOWS_DIR, `${alias}.ts`);
+  return path10.join(projectDir, WORKFLOWS_DIR, `${alias}.ts`);
 }
 var GLOBALS_SUFFIX = ".globals.d.ts";
 function workflowGlobalsPath(projectDir, alias) {
-  return path9.join(projectDir, WORKFLOW_GLOBALS_DIR, `${alias}${GLOBALS_SUFFIX}`);
+  return path10.join(projectDir, WORKFLOW_GLOBALS_DIR, `${alias}${GLOBALS_SUFFIX}`);
 }
 function pruneOrphanWorkflowGlobals(projectDir, declared) {
-  const dir = path9.join(projectDir, WORKFLOW_GLOBALS_DIR);
+  const dir = path10.join(projectDir, WORKFLOW_GLOBALS_DIR);
   if (!fs8.existsSync(dir)) return [];
   const removed = [];
   for (const entry of fs8.readdirSync(dir)) {
     if (!entry.endsWith(GLOBALS_SUFFIX)) continue;
     const alias = entry.slice(0, -GLOBALS_SUFFIX.length);
     if (declared.has(alias)) continue;
-    fs8.unlinkSync(path9.join(dir, entry));
+    fs8.unlinkSync(path10.join(dir, entry));
     removed.push(alias);
   }
   return removed.sort();
 }
 function orphanWorkflowBodies(projectDir, declared) {
-  const dir = path9.join(projectDir, WORKFLOWS_DIR);
+  const dir = path10.join(projectDir, WORKFLOWS_DIR);
   if (!fs8.existsSync(dir)) return [];
   return fs8.readdirSync(dir).filter((e) => e.endsWith(".ts") && !e.endsWith(".d.ts") && !e.endsWith(".test.ts")).map((e) => e.slice(0, -".ts".length)).filter((alias) => !declared.has(alias)).sort();
 }
@@ -72440,7 +72456,7 @@ function staleWorkflowGlobals(projectDir, workflows) {
   return out;
 }
 function writeWorkflowGlobals(projectDir, alias, dts, declaration) {
-  const dir = path9.join(projectDir, WORKFLOW_GLOBALS_DIR);
+  const dir = path10.join(projectDir, WORKFLOW_GLOBALS_DIR);
   fs8.mkdirSync(dir, { recursive: true });
   const file2 = workflowGlobalsPath(projectDir, alias);
   const stamp = `${GLOBALS_STAMP_PREFIX}${workflowDeclarationStamp(declaration)}`;
@@ -72453,7 +72469,7 @@ function normalizeWorkflowBody(source) {
   return source.replace(/\s+$/, "");
 }
 function writeWorkflowFile(projectDir, alias, source, envelope2 = { prefix: WORKFLOW_ENVELOPE_PREFIX, suffix: WORKFLOW_ENVELOPE_SUFFIX }) {
-  const dir = path9.join(projectDir, WORKFLOWS_DIR);
+  const dir = path10.join(projectDir, WORKFLOWS_DIR);
   fs8.mkdirSync(dir, { recursive: true });
   const file2 = workflowFilePath(projectDir, alias);
   const body = normalizeWorkflowBody(source);
@@ -72463,14 +72479,14 @@ ${envelope2.prefix}${body}${envelope2.suffix}
   return file2;
 }
 function agentFilePath2(projectDir, alias) {
-  return path9.join(projectDir, ...agentFilePath(alias).split("/"));
+  return path10.join(projectDir, ...agentFilePath(alias).split("/"));
 }
 var CLI_AGENT_NOTES = [
   "Pulled from the LIVE app row; edit here, then: lotics app agent set <alias>",
   "The typed fields (inputs/outputs/tool_names/model_tier) live in package.json#lotics.agents"
 ];
 function writeAgentFile(projectDir, alias, instructions) {
-  fs8.mkdirSync(path9.join(projectDir, AGENTS_DIR), { recursive: true });
+  fs8.mkdirSync(path10.join(projectDir, AGENTS_DIR), { recursive: true });
   const file2 = agentFilePath2(projectDir, alias);
   fs8.writeFileSync(
     file2,
@@ -72569,7 +72585,7 @@ async function writeWorkflowFiles(client, projectDir, app_id, appName, workflows
   return written;
 }
 function writeWorkflowDescription(projectDir, alias, description) {
-  const pkgPath2 = path9.join(projectDir, "package.json");
+  const pkgPath2 = path10.join(projectDir, "package.json");
   const pkg2 = JSON.parse(fs8.readFileSync(pkgPath2, "utf-8"));
   const declaration = pkg2.lotics?.workflows?.[alias];
   if (!declaration) return;
@@ -72624,7 +72640,7 @@ function runNpm(args, cwd) {
 }
 function readAppWorkspaceId(projectDir) {
   try {
-    const pkgPath2 = path9.join(projectDir, "package.json");
+    const pkgPath2 = path10.join(projectDir, "package.json");
     if (!fs8.existsSync(pkgPath2)) return null;
     const pkg2 = JSON.parse(fs8.readFileSync(pkgPath2, "utf-8"));
     return pkg2.lotics?.workspace_id ?? null;
@@ -72633,7 +72649,7 @@ function readAppWorkspaceId(projectDir) {
   }
 }
 function readAppMeta(projectDir) {
-  const pkgPath2 = path9.join(projectDir, "package.json");
+  const pkgPath2 = path10.join(projectDir, "package.json");
   if (!fs8.existsSync(pkgPath2)) {
     throw new Error(`No package.json found at ${projectDir}. Run 'lotics app create' first.`);
   }
@@ -72656,7 +72672,7 @@ function readAppMeta(projectDir) {
   };
 }
 function writeAppMeta(projectDir, meta3) {
-  const pkgPath2 = path9.join(projectDir, "package.json");
+  const pkgPath2 = path10.join(projectDir, "package.json");
   const pkg2 = JSON.parse(fs8.readFileSync(pkgPath2, "utf-8"));
   const existing = pkg2.lotics && typeof pkg2.lotics === "object" ? pkg2.lotics : {};
   const supplied = new Set(
@@ -72670,7 +72686,7 @@ function writeAppMeta(projectDir, meta3) {
   fs8.writeFileSync(pkgPath2, JSON.stringify(pkg2, null, 2) + "\n");
 }
 function writeWorkflowOutputs(projectDir, alias, outputs) {
-  const pkgPath2 = path9.join(projectDir, "package.json");
+  const pkgPath2 = path10.join(projectDir, "package.json");
   const pkg2 = JSON.parse(fs8.readFileSync(pkgPath2, "utf-8"));
   const declaration = pkg2.lotics?.workflows?.[alias];
   if (!declaration) {
@@ -72695,7 +72711,7 @@ function workflowBodyDrift(projectDir, workflows, synced = {}) {
   return drifted;
 }
 function ensureAppTsconfig(projectDir) {
-  const tsconfigPath = path9.join(projectDir, "tsconfig.json");
+  const tsconfigPath = path10.join(projectDir, "tsconfig.json");
   if (!fs8.existsSync(tsconfigPath)) {
     console.error(
       `\u26A0 No tsconfig.json at ${projectDir} \u2014 could not ensure "include" has "${LOTICS_INCLUDE_GLOB}" (a bare .lotics loads none of the generated types) or "exclude" has ${WORKFLOW_TSCONFIG_EXCLUDES.join(", ")}.`
@@ -72747,15 +72763,15 @@ function writeDevLinkTsconfig(projectDir) {
   if (uiSrc) {
     paths["@lotics/ui/*"] = [`${uiSrc}/*`];
     for (const peer of readKitPeerNames(projectDir)) {
-      const typesDir = path9.join(projectDir, "node_modules", typesPackageFor(peer));
-      const runtimeDir = path9.join(projectDir, "node_modules", peer);
+      const typesDir = path10.join(projectDir, "node_modules", typesPackageFor(peer));
+      const runtimeDir = path10.join(projectDir, "node_modules", peer);
       const target = fs8.existsSync(typesDir) ? `../node_modules/${typesPackageFor(peer)}` : fs8.existsSync(runtimeDir) ? `../node_modules/${peer}` : null;
       if (!target) continue;
       paths[peer] = [target];
       paths[`${peer}/*`] = [`${target}/*`];
     }
   }
-  const file2 = path9.join(projectDir, ".lotics", "tsconfig.link.json");
+  const file2 = path10.join(projectDir, ".lotics", "tsconfig.link.json");
   const header = uiSrc ? `// GENERATED by \`lotics app codegen\` \u2014 do not edit.
 // LOTICS_UI_SRC is set, so @lotics/ui resolves to your working copy for tsc,
 // vitest, eslint and your editor \u2014 the same copy Vite is bundling. The peer
@@ -72772,8 +72788,8 @@ function writeDevLinkTsconfig(projectDir) {
 }
 function writeKitTypeAugmentation(projectDir) {
   const uiSrc = process.env.LOTICS_UI_SRC;
-  const source = uiSrc ? path9.join(uiSrc, "react_native.d.ts") : path9.join(projectDir, "node_modules", "@lotics", "ui", "src", "react_native.d.ts");
-  const target = path9.join(projectDir, ".lotics", "react_native.d.ts");
+  const source = uiSrc ? path10.join(uiSrc, "react_native.d.ts") : path10.join(projectDir, "node_modules", "@lotics", "ui", "src", "react_native.d.ts");
+  const target = path10.join(projectDir, ".lotics", "react_native.d.ts");
   if (!fs8.existsSync(source)) {
     if (fs8.existsSync(target)) fs8.rmSync(target);
     return;
@@ -72790,7 +72806,7 @@ function typesPackageFor(peer) {
   return peer.startsWith("@") ? `@types/${peer.slice(1).replace("/", "__")}` : `@types/${peer}`;
 }
 function readKitPeerNames(projectDir) {
-  const kitPkg = path9.join(projectDir, "node_modules", "@lotics", "ui", "package.json");
+  const kitPkg = path10.join(projectDir, "node_modules", "@lotics", "ui", "package.json");
   if (!fs8.existsSync(kitPkg)) return [];
   const parsed = JSON.parse(fs8.readFileSync(kitPkg, "utf-8"));
   const peers = parsed.peerDependencies;
@@ -72801,12 +72817,12 @@ function writeAppDtsKitLinks(projectDir) {
   writeKitTypeAugmentation(projectDir);
 }
 function writeAppDts(projectDir, manifest) {
-  const dotLotics = path9.join(projectDir, ".lotics");
+  const dotLotics = path10.join(projectDir, ".lotics");
   fs8.mkdirSync(dotLotics, { recursive: true });
   const written = [
-    [path9.join(dotLotics, "app_workflows.d.ts"), generateAppWorkflowsDts(manifest.workflows)],
-    [path9.join(dotLotics, "app_queries.d.ts"), generateAppQueriesDts(manifest.queries)],
-    [path9.join(dotLotics, "app_agents.d.ts"), generateAppAgentsDts(manifest.agents)]
+    [path10.join(dotLotics, "app_workflows.d.ts"), generateAppWorkflowsDts(manifest.workflows)],
+    [path10.join(dotLotics, "app_queries.d.ts"), generateAppQueriesDts(manifest.queries)],
+    [path10.join(dotLotics, "app_agents.d.ts"), generateAppAgentsDts(manifest.agents)]
   ];
   for (const [file2, content] of written) fs8.writeFileSync(file2, content);
   writeAppDtsKitLinks(projectDir);
@@ -72815,7 +72831,7 @@ function writeAppDts(projectDir, manifest) {
   return written.map(([file2]) => file2);
 }
 function readCodegenTablesAllowlist(projectDir) {
-  const pkg2 = JSON.parse(fs8.readFileSync(path9.join(projectDir, "package.json"), "utf-8"));
+  const pkg2 = JSON.parse(fs8.readFileSync(path10.join(projectDir, "package.json"), "utf-8"));
   const tables = pkg2.lotics?.codegen?.tables;
   return Array.isArray(tables) ? tables.filter((t) => typeof t === "string") : [];
 }
@@ -72828,16 +72844,16 @@ function resolveCodegenTableIds(projectDir, queries) {
   return [...ids];
 }
 function writeAppFields(projectDir, tables) {
-  const dotLotics = path9.join(projectDir, ".lotics");
+  const dotLotics = path10.join(projectDir, ".lotics");
   fs8.mkdirSync(dotLotics, { recursive: true });
-  const file2 = path9.join(dotLotics, "app_fields.ts");
+  const file2 = path10.join(dotLotics, "app_fields.ts");
   fs8.writeFileSync(file2, generateAppFields(tables));
   return file2;
 }
 function writeBindingAppFields(projectDir, binding) {
-  const dotLotics = path9.join(projectDir, ".lotics");
+  const dotLotics = path10.join(projectDir, ".lotics");
   fs8.mkdirSync(dotLotics, { recursive: true });
-  const file2 = path9.join(dotLotics, "app_fields.ts");
+  const file2 = path10.join(dotLotics, "app_fields.ts");
   fs8.writeFileSync(file2, generatePackageAppFields(binding));
   return file2;
 }
@@ -72879,7 +72895,7 @@ async function writeGeneratedAppFields(client, projectDir, app, queries) {
 }
 function warnAppFieldsUnwritten(projectDir, err2) {
   const reason = err2 instanceof Error ? err2.message : String(err2);
-  if (fs8.existsSync(path9.join(projectDir, ".lotics", "app_fields.ts"))) {
+  if (fs8.existsSync(path10.join(projectDir, ".lotics", "app_fields.ts"))) {
     console.error(`\u26A0 Could not regenerate .lotics/app_fields.ts (${reason}). Kept the existing file.`);
     return;
   }
@@ -72890,7 +72906,7 @@ function warnAppFieldsUnwritten(projectDir, err2) {
 function warnAboutDevLink(projectDir, command) {
   const uiSrc = process.env.LOTICS_UI_SRC;
   if (!uiSrc) return;
-  const viteConfigPath = path9.join(projectDir, "vite.config.ts");
+  const viteConfigPath = path10.join(projectDir, "vite.config.ts");
   const config2 = fs8.existsSync(viteConfigPath) ? fs8.readFileSync(viteConfigPath, "utf-8") : "";
   const linked = config2.includes("loticsResolve") || config2.includes("LOTICS_UI_SRC");
   if (!linked) {
@@ -72909,7 +72925,7 @@ function warnAboutDevLink(projectDir, command) {
   }
 }
 function ensureAppVitestSetup(projectDir) {
-  const setupPath = path9.join(projectDir, VITEST_SETUP_FILENAME);
+  const setupPath = path10.join(projectDir, VITEST_SETUP_FILENAME);
   if (!fs8.existsSync(setupPath)) {
     fs8.writeFileSync(setupPath, VITEST_SETUP_CONTENT);
     console.error(`Wrote ${VITEST_SETUP_FILENAME} (stubs getAppBinding so \`npm test\` collects).`);
@@ -72919,7 +72935,7 @@ function ensureAppVitestSetup(projectDir) {
 ${VITEST_SETUP_CONTENT}`
     );
   }
-  const viteConfigPath = path9.join(projectDir, "vite.config.ts");
+  const viteConfigPath = path10.join(projectDir, "vite.config.ts");
   if (!fs8.existsSync(viteConfigPath)) return;
   const viteConfig = fs8.readFileSync(viteConfigPath, "utf-8");
   if (/setupFiles\s*:/.test(viteConfig) && viteConfig.includes(VITEST_SETUP_FILENAME)) return;
@@ -72929,7 +72945,7 @@ ${VITEST_SETUP_CONTENT}`
   );
 }
 async function appCodegen(args) {
-  const projectDir = path9.resolve(args.projectDir ?? process.cwd());
+  const projectDir = path10.resolve(args.projectDir ?? process.cwd());
   const meta3 = readAppMeta(projectDir);
   const dtsPaths = writeAppDts(projectDir, {
     workflows: meta3.workflows,
@@ -72943,7 +72959,7 @@ async function appCodegen(args) {
   }
   for (const alias of orphanWorkflowBodies(projectDir, declared)) {
     console.error(
-      `\u26A0 ${path9.join(WORKFLOWS_DIR, `${alias}.ts`)} is not declared in package.json#lotics.workflows \u2014 'workflow check' and 'workflow set' both skip it. Declare the alias or delete the file.`
+      `\u26A0 ${path10.join(WORKFLOWS_DIR, `${alias}.ts`)} is not declared in package.json#lotics.workflows \u2014 'workflow check' and 'workflow set' both skip it. Declare the alias or delete the file.`
     );
   }
   if (!args.client) {
@@ -73002,7 +73018,7 @@ async function refreshWorkflowTypes(client, projectDir, app_id, alias, declarati
   return true;
 }
 function readPriorStamp(projectDir) {
-  const pkgPath2 = path9.join(projectDir, "package.json");
+  const pkgPath2 = path10.join(projectDir, "package.json");
   if (!fs8.existsSync(pkgPath2)) return null;
   let pkg2;
   try {
@@ -73071,8 +73087,8 @@ function appDirName(name2) {
 }
 async function materializeScaffold(targetPath, files) {
   for (const file2 of files) {
-    const fullPath = path9.join(targetPath, file2.path);
-    fs8.mkdirSync(path9.dirname(fullPath), { recursive: true });
+    const fullPath = path10.join(targetPath, file2.path);
+    fs8.mkdirSync(path10.dirname(fullPath), { recursive: true });
     fs8.writeFileSync(fullPath, file2.content);
   }
   console.error(`Scaffolded ${files.length} files into ${targetPath}`);
@@ -73082,7 +73098,7 @@ async function materializeScaffold(targetPath, files) {
   writeAppDtsKitLinks(targetPath);
 }
 async function appCreate(client, args) {
-  const targetPath = path9.resolve(args.targetPath ?? appDirName(args.name));
+  const targetPath = path10.resolve(args.targetPath ?? appDirName(args.name));
   if (fs8.existsSync(targetPath)) {
     const entries2 = fs8.readdirSync(targetPath);
     if (entries2.length > 0) {
@@ -73111,7 +73127,7 @@ async function appCreate(client, args) {
   });
   console.error(`
 Ready. Next steps:`);
-  console.error(`  cd ${path9.relative(process.cwd(), targetPath) || "."}`);
+  console.error(`  cd ${path10.relative(process.cwd(), targetPath) || "."}`);
   console.error(`  lotics docs                # the contracts, at the versions installed here`);
   console.error(`  # edit src/App.tsx, then:`);
   console.error(`  lotics app check           # every pre-flight a deploy runs`);
@@ -73170,7 +73186,7 @@ async function appVersions(client, args) {
   }
 }
 function defaultPullTarget(appId, appName) {
-  const cwdPkgPath = path9.join(process.cwd(), "package.json");
+  const cwdPkgPath = path10.join(process.cwd(), "package.json");
   if (fs8.existsSync(cwdPkgPath)) {
     let pkg2 = null;
     try {
@@ -73195,21 +73211,21 @@ async function appPull(client, args) {
   if (!versionId) throw new Error(`App ${app.id} has no version to pull.`);
   const version2 = await client.getAppVersion(app.id, versionId);
   const sourceUrl = await client.getAppVersionSourceUrl(app.id, version2.id);
-  const targetPath = path9.resolve(args.targetPath ?? defaultPullTarget(app.id, app.name));
+  const targetPath = path10.resolve(args.targetPath ?? defaultPullTarget(app.id, app.name));
   fs8.mkdirSync(targetPath, { recursive: true });
   const prior = readPriorStamp(targetPath);
-  const tmpFile = path9.join(tmpdir(), `lotics-app-${app.id}-${Date.now()}.tar.gz`);
+  const tmpFile = path10.join(tmpdir(), `lotics-app-${app.id}-${Date.now()}.tar.gz`);
   console.error(`Downloading source archive...`);
   await downloadToFile(sourceUrl, tmpFile);
   const keptLocal = [];
-  const stagingDir = fs8.mkdtempSync(path9.join(tmpdir(), `lotics-pull-${app.id}-`));
+  const stagingDir = fs8.mkdtempSync(path10.join(tmpdir(), `lotics-pull-${app.id}-`));
   try {
     await runTar(["-xzf", tmpFile, "-C", stagingDir], stagingDir);
     console.error(`Extracting to ${targetPath}...`);
     keptLocal.push(
       ...copyTree(stagingDir, targetPath, {
         overwrite: args.force === true,
-        skip: [WORKFLOWS_DIR, AGENTS_DIR].map((d) => d.split(path9.sep).join("/"))
+        skip: [WORKFLOWS_DIR, AGENTS_DIR].map((d) => d.split(path10.sep).join("/"))
       })
     );
   } finally {
@@ -73287,20 +73303,20 @@ async function appPull(client, args) {
   });
   console.error(`
 Ready. Next steps:`);
-  console.error(`  cd ${path9.relative(process.cwd(), targetPath) || "."}`);
+  console.error(`  cd ${path10.relative(process.cwd(), targetPath) || "."}`);
   console.error(`  lotics docs                # the contracts, at the versions installed here`);
   console.error(`  # edit src/App.tsx, then:`);
   console.error(`  lotics app deploy`);
 }
 function readAppSourceText(projectDir) {
-  const srcDir = path9.join(projectDir, "src");
+  const srcDir = path10.join(projectDir, "src");
   if (!fs8.existsSync(srcDir)) return "";
   const parts = [];
   const walk2 = (dir) => {
     for (const entry of fs8.readdirSync(dir, { withFileTypes: true })) {
-      const full = path9.join(dir, entry.name);
+      const full = path10.join(dir, entry.name);
       if (entry.isDirectory()) walk2(full);
-      else if (isAppSourcePath(path9.relative(projectDir, full))) {
+      else if (isAppSourcePath(path10.relative(projectDir, full))) {
         parts.push(fs8.readFileSync(full, "utf8"));
       }
     }
@@ -73309,7 +73325,7 @@ function readAppSourceText(projectDir) {
   return parts.join("\n");
 }
 async function appDeploy(client, args) {
-  const projectDir = path9.resolve(args.projectDir ?? process.cwd());
+  const projectDir = path10.resolve(args.projectDir ?? process.cwd());
   const meta3 = readAppMeta(projectDir);
   warnAboutDevLink(projectDir, "deploy");
   const liveApp = await client.getApp(meta3.app_id);
@@ -73344,14 +73360,14 @@ async function appDeploy(client, args) {
   }
   console.error("Building...");
   await runNpm(["run", "build"], projectDir);
-  const distDir = path9.join(projectDir, "dist");
+  const distDir = path10.join(projectDir, "dist");
   if (!fs8.existsSync(distDir)) {
     throw new Error(
       `Build did not produce a dist/ directory in ${projectDir}. Check that 'npm run build' is configured correctly (Vite/etc. defaults to dist/).`
     );
   }
-  const tmpSource = path9.join(tmpdir(), `lotics-source-${Date.now()}.tar.gz`);
-  const tmpDist = path9.join(tmpdir(), `lotics-dist-${Date.now()}.tar.gz`);
+  const tmpSource = path10.join(tmpdir(), `lotics-source-${Date.now()}.tar.gz`);
+  const tmpDist = path10.join(tmpdir(), `lotics-dist-${Date.now()}.tar.gz`);
   try {
     console.error("Packaging source...");
     await runTar(
@@ -73524,7 +73540,7 @@ function reportKnowledgeWarnings(warnings) {
   );
 }
 async function upgradeCommand(client, args) {
-  const projectDir = path9.resolve(args.projectDir ?? process.cwd());
+  const projectDir = path10.resolve(args.projectDir ?? process.cwd());
   const meta3 = readAppMeta(projectDir);
   const plan = await client.previewPackageUpgrade(meta3.app_id, {});
   if (plan.from_version === plan.to_version) {
@@ -73568,7 +73584,7 @@ async function upgradeCommand(client, args) {
   );
 }
 async function appCheck(client, args = {}) {
-  const projectDir = path9.resolve(args.projectDir ?? process.cwd());
+  const projectDir = path10.resolve(args.projectDir ?? process.cwd());
   const meta3 = readAppMeta(projectDir);
   const app = await client.getApp(meta3.app_id);
   assertProjectIsCurrent(meta3, app);
@@ -73794,10 +73810,10 @@ function derivedDeployMessage(pending) {
 function copyTree(from, to, opts, relative = "") {
   const kept = [];
   for (const entry of fs8.readdirSync(from, { withFileTypes: true })) {
-    const src = path9.join(from, entry.name);
-    const dest = path9.join(to, entry.name);
-    const rel = path9.join(relative, entry.name);
-    if (opts.skip?.includes(rel.split(path9.sep).join("/"))) continue;
+    const src = path10.join(from, entry.name);
+    const dest = path10.join(to, entry.name);
+    const rel = path10.join(relative, entry.name);
+    if (opts.skip?.includes(rel.split(path10.sep).join("/"))) continue;
     if (entry.isDirectory()) {
       fs8.mkdirSync(dest, { recursive: true });
       kept.push(...copyTree(src, dest, opts, rel));
@@ -73934,7 +73950,7 @@ function defineBlockKeys(config2) {
 }
 var REALTIME_SDK_FLOOR = "0.80.0";
 function installedAppSdkVersion(projectDir) {
-  const manifest = path9.join(projectDir, "node_modules", "@lotics", "app-sdk", "package.json");
+  const manifest = path10.join(projectDir, "node_modules", "@lotics", "app-sdk", "package.json");
   if (!fs8.existsSync(manifest)) return null;
   const version2 = JSON.parse(fs8.readFileSync(manifest, "utf-8")).version;
   return typeof version2 === "string" ? version2 : null;
@@ -73961,9 +73977,9 @@ function warnIfProjectFootguns(projectDir, sourceText) {
       ].join("\n")
     );
   }
-  const configName = VITE_CONFIG_NAMES.find((name2) => fs8.existsSync(path9.join(projectDir, name2)));
+  const configName = VITE_CONFIG_NAMES.find((name2) => fs8.existsSync(path10.join(projectDir, name2)));
   if (configName !== void 0) {
-    const config2 = fs8.readFileSync(path9.join(projectDir, configName), "utf-8");
+    const config2 = fs8.readFileSync(path10.join(projectDir, configName), "utf-8");
     const defined = defineBlockKeys(config2);
     const missing = ["global", "__DEV__"].filter((name2) => !defined.has(name2));
     if (missing.length > 0) {
@@ -74059,7 +74075,7 @@ function warnIfUnboundAliases(app, called) {
   console.error(lines.join("\n"));
 }
 async function appDev(client, args) {
-  const projectDir = path9.resolve(args.projectDir ?? process.cwd());
+  const projectDir = path10.resolve(args.projectDir ?? process.cwd());
   const meta3 = readAppMeta(projectDir);
   warnAboutDevLink(projectDir, "dev");
   writeAppDts(projectDir, { workflows: meta3.workflows, queries: meta3.queries, agents: meta3.agents });
@@ -74193,7 +74209,7 @@ async function appAgentSet(client, args) {
     }
     if (!hasDeclaration) {
       console.error(
-        `No instructions at ${path9.relative(projectDir, file2)}, and nothing declared in package.json#lotics.agents.${args.alias} to push instead.
+        `No instructions at ${path10.relative(projectDir, file2)}, and nothing declared in package.json#lotics.agents.${args.alias} to push instead.
   Run 'lotics app pull ${meta3.app_id}' to write ${AGENTS_DIR}/${args.alias}.md, then edit it.`
       );
       process.exit(1);
@@ -74202,7 +74218,7 @@ async function appAgentSet(client, args) {
   const instructions = hasProse ? stripAgentHeader(fs8.readFileSync(file2, "utf-8")) : void 0;
   if (instructions === "") {
     console.error(
-      `${path9.relative(projectDir, file2)} is empty after stripping the header \u2014 refusing to push an empty prompt.`
+      `${path10.relative(projectDir, file2)} is empty after stripping the header \u2014 refusing to push an empty prompt.`
     );
     process.exit(1);
   }
@@ -74269,7 +74285,7 @@ async function appWorkflowSet(client, args) {
   const file2 = workflowFilePath(projectDir, args.alias);
   if (!fs8.existsSync(file2)) {
     console.error(
-      `No workflow body at ${path9.relative(projectDir, file2)}.
+      `No workflow body at ${path10.relative(projectDir, file2)}.
   If "${args.alias}" is already bound:  lotics app pull ${meta3.app_id}   (writes the body)
   If it is a NEW alias you declared:    create that file yourself, then re-run this.`
     );
@@ -74278,7 +74294,7 @@ async function appWorkflowSet(client, args) {
   noteScope({ alias: args.alias });
   const source = stripWorkflowHeader(fs8.readFileSync(file2, "utf-8"));
   if (source.trim() === "") {
-    console.error(`Workflow body ${path9.relative(projectDir, file2)} is empty after stripping the header.`);
+    console.error(`Workflow body ${path10.relative(projectDir, file2)} is empty after stripping the header.`);
     process.exit(1);
   }
   const res = await client.setAppWorkflow(meta3.app_id, args.alias, {
@@ -74413,13 +74429,13 @@ async function appWorkflowCheck(args) {
     const globalsPath = workflowGlobalsPath(projectDir, alias);
     if (!fs8.existsSync(bodyPath)) {
       console.error(
-        `\u26A0 Skipped "${alias}" \u2014 no body at ${path9.relative(projectDir, bodyPath)}. Run 'lotics app workflow pull' to write it.`
+        `\u26A0 Skipped "${alias}" \u2014 no body at ${path10.relative(projectDir, bodyPath)}. Run 'lotics app workflow pull' to write it.`
       );
       continue;
     }
     if (!fs8.existsSync(globalsPath)) {
       console.error(
-        `Cannot check "${alias}" \u2014 missing types at ${path9.relative(projectDir, globalsPath)}. Run 'lotics app codegen' to fetch them (it refreshes types WITHOUT touching your body; a pull would overwrite it).`
+        `Cannot check "${alias}" \u2014 missing types at ${path10.relative(projectDir, globalsPath)}. Run 'lotics app codegen' to fetch them (it refreshes types WITHOUT touching your body; a pull would overwrite it).`
       );
       process.exit(1);
     }
@@ -74455,7 +74471,7 @@ async function appWorkflowCheck(args) {
 function printWorkflowCheckResults(projectDir, results) {
   let totalErrors = 0;
   for (const r of results) {
-    const rel = path9.relative(projectDir, r.bodyPath);
+    const rel = path10.relative(projectDir, r.bodyPath);
     if (r.issues.length === 0) {
       console.error(`\u2713 ${r.alias} (${rel}) \u2014 clean`);
       continue;
@@ -74727,7 +74743,7 @@ import fs10 from "node:fs";
 
 // src/file_command_io.ts
 import fs9 from "node:fs";
-import path10 from "node:path";
+import path11 from "node:path";
 var CliError = class extends Error {
   constructor(message2) {
     super(message2);
@@ -74748,8 +74764,8 @@ function rejectExtraArgs(rest2, arity, usage) {
   fail2(`${usage} takes ${arity} argument${arity === 1 ? "" : "s"} after <file>, got ${rest2.length}. Unused: ${rest2.slice(arity).join(" ")}`);
 }
 function writeFileAtomic(filePath, bytes) {
-  const dir = path10.dirname(path10.resolve(filePath));
-  const tmp = path10.join(dir, `.${path10.basename(filePath)}.${process.pid}.${Date.now()}.tmp`);
+  const dir = path11.dirname(path11.resolve(filePath));
+  const tmp = path11.join(dir, `.${path11.basename(filePath)}.${process.pid}.${Date.now()}.tmp`);
   fs9.writeFileSync(tmp, bytes);
   try {
     fs9.renameSync(tmp, filePath);
@@ -77552,16 +77568,16 @@ var MatcherView = class {
    * @returns {string|undefined}
    */
   getCurrentTag() {
-    const path12 = this._matcher.path;
-    return path12.length > 0 ? path12[path12.length - 1].tag : void 0;
+    const path13 = this._matcher.path;
+    return path13.length > 0 ? path13[path13.length - 1].tag : void 0;
   }
   /**
    * Get current namespace.
    * @returns {string|undefined}
    */
   getCurrentNamespace() {
-    const path12 = this._matcher.path;
-    return path12.length > 0 ? path12[path12.length - 1].namespace : void 0;
+    const path13 = this._matcher.path;
+    return path13.length > 0 ? path13[path13.length - 1].namespace : void 0;
   }
   /**
    * Get current node's attribute value.
@@ -77569,9 +77585,9 @@ var MatcherView = class {
    * @returns {*}
    */
   getAttrValue(attrName) {
-    const path12 = this._matcher.path;
-    if (path12.length === 0) return void 0;
-    return path12[path12.length - 1].values?.[attrName];
+    const path13 = this._matcher.path;
+    if (path13.length === 0) return void 0;
+    return path13[path13.length - 1].values?.[attrName];
   }
   /**
    * Check if current node has an attribute.
@@ -77579,9 +77595,9 @@ var MatcherView = class {
    * @returns {boolean}
    */
   hasAttr(attrName) {
-    const path12 = this._matcher.path;
-    if (path12.length === 0) return false;
-    const current = path12[path12.length - 1];
+    const path13 = this._matcher.path;
+    if (path13.length === 0) return false;
+    const current = path13[path13.length - 1];
     return current.values !== void 0 && attrName in current.values;
   }
   /**
@@ -77607,18 +77623,18 @@ var MatcherView = class {
    * @returns {number}
    */
   getPosition() {
-    const path12 = this._matcher.path;
-    if (path12.length === 0) return -1;
-    return path12[path12.length - 1].position ?? 0;
+    const path13 = this._matcher.path;
+    if (path13.length === 0) return -1;
+    return path13[path13.length - 1].position ?? 0;
   }
   /**
    * Get current node's repeat counter (occurrence count of this tag name).
    * @returns {number}
    */
   getCounter() {
-    const path12 = this._matcher.path;
-    if (path12.length === 0) return -1;
-    return path12[path12.length - 1].counter ?? 0;
+    const path13 = this._matcher.path;
+    if (path13.length === 0) return -1;
+    return path13[path13.length - 1].counter ?? 0;
   }
   /**
    * Get current node's sibling index (alias for getPosition).
@@ -83276,10 +83292,10 @@ function resolveRelativePath(basePath, relativePath) {
   }
   return resolved.join("/");
 }
-function findZipEntry(zipEntries, path12) {
-  if (zipEntries[path12]) return zipEntries[path12];
-  if (zipEntries[`xl/${path12}`]) return zipEntries[`xl/${path12}`];
-  const noSlash = path12.replace(/^\//, "");
+function findZipEntry(zipEntries, path13) {
+  if (zipEntries[path13]) return zipEntries[path13];
+  if (zipEntries[`xl/${path13}`]) return zipEntries[`xl/${path13}`];
+  const noSlash = path13.replace(/^\//, "");
   if (zipEntries[noSlash]) return zipEntries[noSlash];
   return void 0;
 }
@@ -84911,9 +84927,9 @@ function parseExcelFromZip(zip, options) {
   }
   return result;
 }
-function findEntry(zip, path12) {
-  if (zip[path12]) return zip[path12];
-  const lower2 = path12.toLowerCase();
+function findEntry(zip, path13) {
+  if (zip[path13]) return zip[path13];
+  const lower2 = path13.toLowerCase();
   for (const key of Object.keys(zip)) {
     if (key.toLowerCase() === lower2) return zip[key];
   }
@@ -85550,12 +85566,12 @@ function extractPivotRoundTripInfo(originalZip) {
     if (paths.length > 0) pivotTablesBySheetIndex.set(i2, paths);
   }
   const pivotXmlPaths = [];
-  for (const path12 of Object.keys(originalZip)) {
-    if (path12.startsWith("xl/pivotTables/") && path12.endsWith(".xml")) {
-      pivotXmlPaths.push(path12);
+  for (const path13 of Object.keys(originalZip)) {
+    if (path13.startsWith("xl/pivotTables/") && path13.endsWith(".xml")) {
+      pivotXmlPaths.push(path13);
     }
-    if (path12.startsWith("xl/pivotCache/") && path12.endsWith(".xml")) {
-      pivotXmlPaths.push(path12);
+    if (path13.startsWith("xl/pivotCache/") && path13.endsWith(".xml")) {
+      pivotXmlPaths.push(path13);
     }
   }
   return { cachesByWorkbook, pivotTablesBySheetIndex, pivotXmlPaths };
@@ -85563,15 +85579,15 @@ function extractPivotRoundTripInfo(originalZip) {
 function decode3(bytes) {
   return new TextDecoder().decode(bytes);
 }
-function pivotContentTypeFor(path12) {
-  if (path12.startsWith("xl/pivotTables/") && path12.endsWith(".xml")) {
-    return `<Override PartName="/${path12}" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.pivotTable+xml"/>`;
+function pivotContentTypeFor(path13) {
+  if (path13.startsWith("xl/pivotTables/") && path13.endsWith(".xml")) {
+    return `<Override PartName="/${path13}" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.pivotTable+xml"/>`;
   }
-  if (path12.includes("/pivotCacheDefinition") && path12.endsWith(".xml")) {
-    return `<Override PartName="/${path12}" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.pivotCacheDefinition+xml"/>`;
+  if (path13.includes("/pivotCacheDefinition") && path13.endsWith(".xml")) {
+    return `<Override PartName="/${path13}" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.pivotCacheDefinition+xml"/>`;
   }
-  if (path12.includes("/pivotCacheRecords") && path12.endsWith(".xml")) {
-    return `<Override PartName="/${path12}" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.pivotCacheRecords+xml"/>`;
+  if (path13.includes("/pivotCacheRecords") && path13.endsWith(".xml")) {
+    return `<Override PartName="/${path13}" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.pivotCacheRecords+xml"/>`;
   }
   return void 0;
 }
@@ -85644,16 +85660,16 @@ function exportWorkbook(workbook, originalZip) {
       regeneratedPaths.add(`xl/worksheets/sheet${i2 + 1}.xml`);
       regeneratedPaths.add(`xl/worksheets/_rels/sheet${i2 + 1}.xml.rels`);
     }
-    for (const path12 of Object.keys(originalZip)) {
-      if (path12.startsWith("xl/drawings/") || path12.startsWith("xl/charts/") || path12.startsWith("xl/tables/") || path12.startsWith("xl/media/")) {
-        regeneratedPaths.add(path12);
+    for (const path13 of Object.keys(originalZip)) {
+      if (path13.startsWith("xl/drawings/") || path13.startsWith("xl/charts/") || path13.startsWith("xl/tables/") || path13.startsWith("xl/media/")) {
+        regeneratedPaths.add(path13);
       }
     }
-    for (const [path12, data2] of Object.entries(originalZip)) {
-      if (regeneratedPaths.has(path12)) continue;
-      const ext = path12.slice(path12.lastIndexOf(".") + 1).toLowerCase();
+    for (const [path13, data2] of Object.entries(originalZip)) {
+      if (regeneratedPaths.has(path13)) continue;
+      const ext = path13.slice(path13.lastIndexOf(".") + 1).toLowerCase();
       if (!DECLARED_EXTENSIONS.includes(ext)) continue;
-      entries2[path12] = data2;
+      entries2[path13] = data2;
     }
   }
   const sharedStrings = buildSharedStrings(workbook);
@@ -85669,8 +85685,8 @@ function exportWorkbook(workbook, originalZip) {
     buildWorkbookRels(workbook, pivotInfo)
   );
   const extraContentTypes = [];
-  for (const path12 of pivotInfo.pivotXmlPaths) {
-    const ct = pivotContentTypeFor(path12);
+  for (const path13 of pivotInfo.pivotXmlPaths) {
+    const ct = pivotContentTypeFor(path13);
     if (ct) extraContentTypes.push(ct);
   }
   let globalChartIndex = 1;
@@ -94856,14 +94872,14 @@ var DependencyGraph = class {
       stack.push({ cell: p, path: [cell, p] });
     }
     while (stack.length > 0) {
-      const { cell: current, path: path12 } = stack.pop();
-      if (current === cell || originCoarse.has(current)) return path12;
+      const { cell: current, path: path13 } = stack.pop();
+      if (current === cell || originCoarse.has(current)) return path13;
       if (visited.has(current)) continue;
       visited.add(current);
       const nextPrec = this.precedents.get(current);
       if (!nextPrec) continue;
       for (const p of nextPrec) {
-        stack.push({ cell: p, path: [...path12, p] });
+        stack.push({ cell: p, path: [...path13, p] });
       }
     }
     return null;
@@ -101702,8 +101718,8 @@ async function docModelToDocx(model) {
 // ../ooxml/src/opc.ts
 var import_jszip = __toESM(require_lib4(), 1);
 function dropFolderEntries(zip) {
-  for (const [path12, entry] of Object.entries(zip.files)) {
-    if (entry.dir) delete zip.files[path12];
+  for (const [path13, entry] of Object.entries(zip.files)) {
+    if (entry.dir) delete zip.files[path13];
   }
 }
 
@@ -101958,11 +101974,11 @@ async function parseDocx(buffer) {
   const zip = await import_jszip3.default.loadAsync(buffer);
   const parts = /* @__PURE__ */ new Map();
   const filePromises = [];
-  zip.forEach((path12, file2) => {
+  zip.forEach((path13, file2) => {
     if (file2.dir) return;
     filePromises.push(
       file2.async("uint8array").then((bytes) => {
-        parts.set(path12, bytes);
+        parts.set(path13, bytes);
       })
     );
   });
@@ -102194,9 +102210,9 @@ var DEFAULT_PARTS = [
   ["word/theme/theme1.xml", () => encoder.encode(THEME_XML)]
 ];
 function fillDefaultParts(parts) {
-  for (const [path12, makeBytes] of DEFAULT_PARTS) {
-    if (!parts.has(path12)) {
-      parts.set(path12, makeBytes());
+  for (const [path13, makeBytes] of DEFAULT_PARTS) {
+    if (!parts.has(path13)) {
+      parts.set(path13, makeBytes());
     }
   }
   return parts;
@@ -102206,9 +102222,9 @@ function fillDefaultParts(parts) {
 async function serializeDocx(doc) {
   const zip = new import_jszip4.default();
   const parts = fillDefaultParts(new Map(doc.parts));
-  for (const [path12, bytes] of parts) {
-    if (path12 === "word/document.xml") continue;
-    zip.file(path12, bytes);
+  for (const [path13, bytes] of parts) {
+    if (path13 === "word/document.xml") continue;
+    zip.file(path13, bytes);
   }
   const documentXml = serializeDocumentXml(doc);
   zip.file("word/document.xml", documentXml);
@@ -102999,7 +103015,7 @@ async function runKnowledgeCommand(client, subcommand, toolArgs, flags, restArgs
 // src/preview.ts
 import { spawn as spawn3 } from "node:child_process";
 import { createServer } from "node:http";
-import { readFileSync as readFileSync2, writeFileSync, existsSync, mkdtempSync, rmSync, readdirSync } from "node:fs";
+import { readFileSync as readFileSync2, writeFileSync, existsSync as existsSync2, mkdtempSync, rmSync, readdirSync } from "node:fs";
 import { tmpdir as tmpdir2 } from "node:os";
 import { join as join2, dirname, resolve, extname, basename } from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
@@ -103011,16 +103027,16 @@ function fail3(msg) {
 }
 function findChrome() {
   const env = process.env.LOTICS_CHROME || process.env.CHROME_PATH;
-  if (env && existsSync(env)) return env;
+  if (env && existsSync2(env)) return env;
   const home = process.env.HOME || "";
   const pwDir = process.platform === "darwin" ? `${home}/Library/Caches/ms-playwright` : `${home}/.cache/ms-playwright`;
-  if (existsSync(pwDir)) {
+  if (existsSync2(pwDir)) {
     const rel = process.platform === "darwin" ? ["chrome-mac/Chromium.app/Contents/MacOS/Chromium"] : ["chrome-linux/chrome", "chrome-linux/headless_shell"];
     const revs = readdirSync(pwDir).filter((n) => n.startsWith("chromium-") || n.startsWith("chromium_headless_shell-")).sort().reverse();
     for (const rev2 of revs) {
       for (const r of rel) {
         const bin = join2(pwDir, rev2, r);
-        if (existsSync(bin)) return bin;
+        if (existsSync2(bin)) return bin;
       }
     }
   }
@@ -103032,7 +103048,7 @@ function findChrome() {
     "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
     "/Applications/Chromium.app/Contents/MacOS/Chromium"
   ];
-  return systemPaths.find((p) => existsSync(p)) ?? null;
+  return systemPaths.find((p) => existsSync2(p)) ?? null;
 }
 async function cdpConnect(wsUrl) {
   const ws = new WebSocket(wsUrl);
@@ -103070,7 +103086,7 @@ function defaultPreviewOutputPath(filename, cwd) {
 async function runPreviewCommand(filePath, flags) {
   if (!filePath) fail3("Usage: lotics preview <file.docx|.xlsx | fil_id> [-o <file.png>]");
   const abs2 = resolve(filePath);
-  if (!existsSync(abs2)) fail3(`File not found: ${abs2}`);
+  if (!existsSync2(abs2)) fail3(`File not found: ${abs2}`);
   const ext = extname(abs2).toLowerCase();
   const type = ext === ".docx" ? "docx" : ext === ".xlsx" || ext === ".xls" || ext === ".csv" ? "xlsx" : null;
   if (!type) fail3(`Unsupported file type "${ext}" \u2014 preview supports .docx and .xlsx/.csv. (PDFs open directly \u2014 no preview needed.)`);
@@ -103078,7 +103094,7 @@ async function runPreviewCommand(filePath, flags) {
     fail3("lotics preview needs Node 22+ (it drives Chrome over CDP via the built-in WebSocket). Upgrade Node and retry.");
   }
   const bundlePath = join2(HERE, "..", "render_page.js");
-  if (!existsSync(bundlePath)) fail3(`Render bundle missing at ${bundlePath} \u2014 reinstall @lotics/cli (build step failed).`);
+  if (!existsSync2(bundlePath)) fail3(`Render bundle missing at ${bundlePath} \u2014 reinstall @lotics/cli (build step failed).`);
   const chrome = findChrome();
   if (!chrome) {
     fail3(
@@ -103131,7 +103147,7 @@ async function runPreviewCommand(filePath, flags) {
     let cdpPort = 0;
     const portFile = join2(udd, "DevToolsActivePort");
     for (let i2 = 0; i2 < 100 && !cdpPort; i2++) {
-      if (existsSync(portFile)) {
+      if (existsSync2(portFile)) {
         const p = parseInt(readFileSync2(portFile, "utf8").split("\n")[0], 10);
         if (p) cdpPort = p;
       }
@@ -103339,8 +103355,8 @@ function prompt(question) {
     });
   });
 }
-async function publicPost(path12, body) {
-  const response = await fetch(`${API_BASE_URL}${path12}`, {
+async function publicPost(path13, body) {
+  const response = await fetch(`${API_BASE_URL}${path13}`, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
     body: JSON.stringify(body)
@@ -103508,13 +103524,13 @@ async function resolveWorkspace(client, ctx) {
 function resolveUploadPaths(rawPaths) {
   const result = [];
   for (const p of rawPaths) {
-    const resolved = path11.resolve(p);
+    const resolved = path12.resolve(p);
     const stat = fs13.statSync(resolved);
     if (stat.isDirectory()) {
       const entries2 = fs13.readdirSync(resolved, { withFileTypes: true });
       for (const entry of entries2) {
         if (entry.isFile()) {
-          result.push(path11.join(resolved, entry.name));
+          result.push(path12.join(resolved, entry.name));
         }
       }
     } else {
@@ -103720,7 +103736,7 @@ async function main() {
   if (command === "preview") {
     if (subcommand && isStoredFileId(subcommand)) {
       const { client: client2 } = requireClient(flags);
-      const tmpDir = fs13.mkdtempSync(path11.join(os4.tmpdir(), "lotics-preview-"));
+      const tmpDir = fs13.mkdtempSync(path12.join(os4.tmpdir(), "lotics-preview-"));
       try {
         const { path: localPath, filename } = await client2.downloadFileById(subcommand, tmpDir);
         const output = flags.output ?? defaultPreviewOutputPath(filename, process.cwd());