@lotics/cli 0.96.6 → 0.98.0

package/README.md

@@ -92,11 +92,14 @@ Every command names its target before it acts — `lotics → <org> / <workspace
 
 ```
 --api-key flag  >  LOTICS_API_KEY env  >  LOTICS_ORG env (name|id)
-  >  local .lotics/config.json  >  global active profile
+  >  local .lotics/config.json  >  app manifest workspace → its saved profile
+  >  global active profile
 ```
 
 `LOTICS_WORKSPACE` (or `--workspace <id>` / `-w`) overrides the workspace at any level. For ephemeral or CI use, set `LOTICS_API_KEY` instead of saving anything.
 
+In an app project, `lotics app *` commands derive the credential from the directory when nothing explicit chose one: the manifest names the app's workspace, and when exactly one saved profile owns that workspace, that profile is used — the machine-wide default (which another shell can move between two of your commands) is never consulted. An explicit flag, env var, or directory pin still wins, and an org whose profile remembers a different workspace simply falls through to the announced default, exactly as before.
+
 ## Workspaces
 
 Workspaces live inside the active org. If the org has more than one, select before running tools:

package/dist/render_page.js

@@ -52872,8 +52872,9 @@ ${e.toString()}`);
       const max2 = parseInt(col["@_max"] ?? "1", 10);
       const width = col["@_width"] ? parseFloat(col["@_width"]) : defaultColWidth;
       const hidden = col["@_hidden"] === "1" || col["@_hidden"] === "true";
+      const customWidth = col["@_customWidth"] === "1" || col["@_customWidth"] === "true";
       const outlineLevel = parseInt(col["@_outlineLevel"] ?? "0", 10);
-      columns.push({ min, max: max2, width, hidden, outlineLevel });
+      columns.push({ min, max: max2, width, hidden, customWidth, outlineLevel });
       for (let c = min; c <= max2; c++) {
         if (hidden) colHidden.add(c);
         if (outlineLevel > 0) colOutlineLevels.set(c, outlineLevel);
@@ -52883,9 +52884,11 @@ ${e.toString()}`);
   }
   function buildColumns(colDefs, colHidden, maxContentWidth, colCount, _defaultColWidth) {
     const explicitWidth = /* @__PURE__ */ new Map();
+    const pinned = /* @__PURE__ */ new Set();
     for (const def of colDefs) {
       for (let c = def.min; c <= def.max; c++) {
         explicitWidth.set(c, def.width);
+        if (def.customWidth) pinned.add(c);
       }
     }
     const columns = [];
@@ -52899,7 +52902,7 @@ ${e.toString()}`);
       } else {
         width = Math.max(8, Math.min(contentChars + 2, 40));
       }
-      columns.push({ index: c, width, hidden });
+      columns.push({ index: c, width, hidden, ...pinned.has(c) ? { customWidth: true } : {} });
     }
     return columns;
   }
@@ -52943,6 +52946,7 @@ ${e.toString()}`);
       rowCount++;
       if (rowCount > maxRows) continue;
       const height = rowEl["@_ht"] ? parseFloat(rowEl["@_ht"]) : defaultRowHeight;
+      const customHeight = rowEl["@_customHeight"] === "1" || rowEl["@_customHeight"] === "true";
       const cellArr = rowEl["c"];
       const cells = [];
       if (cellArr) {
@@ -52964,7 +52968,8 @@ ${e.toString()}`);
         index: rowIndex,
         height,
         cells,
-        hidden: rowHidden
+        hidden: rowHidden,
+        ...customHeight ? { customHeight: true } : {}
       });
     }
     return {
@@ -54378,7 +54383,7 @@ ${e.toString()}`);
       sheet.freeze = { row: ps.freezePane.frozenRows, col: ps.freezePane.frozenCols };
     }
     for (const col of ps.columns) {
-      if (col.width !== ps.defaultColWidth) {
+      if (col.customWidth || col.width !== ps.defaultColWidth) {
         sheet.colWidths.set(col.index, col.width);
       }
       if (col.hidden) {
@@ -54391,7 +54396,7 @@ ${e.toString()}`);
       return `${startRef}:${endRef}`;
     });
     for (const row of ps.rows) {
-      if (row.height !== ps.defaultRowHeight) {
+      if (row.customHeight || row.height !== ps.defaultRowHeight) {
         sheet.rowHeights.set(row.index, row.height);
       }
       if (row.hidden) {

package/dist/src/cli.js

@@ -44165,9 +44165,7 @@ import os2 from "node:os";
 import path7 from "node:path";
 import readline from "node:readline";
 
-// src/client.ts
-import fs from "node:fs";
-import path from "node:path";
+// ../shared/src/transport_error.ts
 function gatewayErrorMessage(status) {
   if (status === 524) {
     return "The request took too long to finish (gateway timeout). It may still be running \u2014 check back in a moment, or try again.";
@@ -44181,6 +44179,10 @@ function transportErrorMessage(status, parsed) {
   const jsonMessage = parsed && typeof parsed.message === "string" ? parsed.message : null;
   return parsed === null || status >= 500 || jsonMessage === null ? gatewayErrorMessage(status) : jsonMessage;
 }
+
+// src/client.ts
+import fs from "node:fs";
+import path from "node:path";
 function findAvailableFilename(dir, filename, reserved) {
   const isTaken = (name) => {
     const full = path.join(dir, name);
@@ -45107,7 +45109,7 @@ function resolveProfileByNameOrId(profiles, nameOrId) {
   }
   return null;
 }
-function resolveContext(flags) {
+function resolveContext(flags, appWorkspaceId) {
   const envKey = process.env.LOTICS_API_KEY;
   const envOrg = process.env.LOTICS_ORG;
   const envWorkspace = process.env.LOTICS_WORKSPACE;
@@ -45157,6 +45159,19 @@ function resolveContext(flags) {
       `This directory's .lotics/config.json uses the old self-contained format (inline key), which is no longer supported. Re-pin with "lotics auth api-key <key> --local" (or "lotics org use <name|id> --local").`
     );
   }
+  if (appWorkspaceId && !wsOverride) {
+    const matches = Object.entries(profiles).filter(([, p]) => p.workspace_id === appWorkspaceId);
+    if (matches.length === 1) {
+      const [orgId, profile] = matches[0];
+      return {
+        apiKey: profile.api_key,
+        orgId,
+        orgName: profile.org_name,
+        workspaceId: appWorkspaceId,
+        source: "app_manifest_profile"
+      };
+    }
+  }
   if (global2?.active_org) {
     const profile = profiles[global2.active_org];
     if (!profile) {
@@ -64402,7 +64417,8 @@ var aggregateOperationSchema = external_exports.enum([
   "checked",
   "unchecked",
   "percent_checked",
-  "percent_unchecked"
+  "percent_unchecked",
+  "string_agg"
 ]);
 var OPERATION_FIELD_TYPES = {
   empty: ["text", "number", "date", "select", "select_member", "select_record_link", "files", "formula", "rollup"],
@@ -64517,12 +64533,21 @@ var queryProjectionColumnSchema = zod_default.union([
   zod_default.string().describe("Passthrough shorthand: a source field key. Output = the key, type = the field's type."),
   queryProjectionColumnObjectSchema
 ]);
+var STRING_AGG_MAX_VALUES = 100;
+var STRING_AGG_DEFAULT_MAX_VALUES = 20;
 var queryAggregateColumnSchema = zod_default.object({
   output: zod_default.string().describe("Output column name"),
   type: queryColumnTypeSchema.describe("Output column type"),
   operation: aggregateOperationSchema,
   input_column: zod_default.string().optional().describe(
     "Input column to aggregate. Required for non-count operations; ignored for count."
+  ),
+  separator: zod_default.string().max(8).optional().describe('string_agg only. Joins the values. Defaults to ", ".'),
+  distinct: zod_default.boolean().optional().describe(
+    "string_agg only. Collapses repeats \u2014 a group of containers sized 40HC/40HC/20DC aggregates to '20DC, 40HC'. Defaults to true, which is almost always what a summary column wants."
+  ),
+  max_values: zod_default.number().int().min(1).max(STRING_AGG_MAX_VALUES).optional().describe(
+    `string_agg only. Caps how many values are emitted so an unbounded child set cannot produce a giant cell. Defaults to ${STRING_AGG_DEFAULT_MAX_VALUES}. Pair with a \`unique\` aggregate to render an accurate '+N more'.`
   )
 });
 var rankingWindowFunctionSchema = (fn) => zod_default.object({ output: zod_default.string().describe("Output column name"), fn: zod_default.literal(fn) }).strict();
@@ -64879,6 +64904,12 @@ var appAgentDeclarationSchema = zod_default.object({
   knowledge_doc_ids: zod_default.array(zod_default.string().min(1)).optional().describe(
     "Knowledge docs the agent may read, validated at declare time against the app owner's `use` access. Small docs are inlined into the agent's system prompt each run; a doc too large to inline requires the code tools (code_exec) in tool_names and is read by staging it into a code run. Omit for an agent that needs no knowledge."
   ),
+  query_aliases: zod_default.array(zod_default.string().min(1)).optional().describe(
+    "Named queries from this app's manifest the agent may run via `run_app_query`, validated at declare time against the app's own queries. This is the agent's ENTIRE read surface over workspace data \u2014 a template fixes the tables, filters, and projection, so it bounds rows and columns, not just tables. Omit for an agent that reads no records."
+  ),
+  workflow_aliases: zod_default.array(zod_default.string().min(1)).optional().describe(
+    "Workflows from this app's manifest the agent may invoke via `run_app_workflow`, validated at declare time against the app's own workflows. This is the agent's ENTIRE write surface \u2014 the same declared mutation path the app's UI uses, so table hooks and side-effect harvesting apply. Omit for a read-only agent."
+  ),
   model_id: zod_default.string().min(1).optional().describe(
     "Chat model id the agent runs on, validated against ACCEPTED_CHAT_MODEL_IDS. Omit to follow the platform default chat model, resolved at run time \u2014 the preferred choice: the agent tracks model generations with no per-app rewrite. Pin only a deliberate, tested choice."
   ),
@@ -79139,8 +79170,9 @@ function parseCols(worksheet, defaultColWidth) {
     const max3 = parseInt(col["@_max"] ?? "1", 10);
     const width = col["@_width"] ? parseFloat(col["@_width"]) : defaultColWidth;
     const hidden = col["@_hidden"] === "1" || col["@_hidden"] === "true";
+    const customWidth = col["@_customWidth"] === "1" || col["@_customWidth"] === "true";
     const outlineLevel = parseInt(col["@_outlineLevel"] ?? "0", 10);
-    columns.push({ min: min2, max: max3, width, hidden, outlineLevel });
+    columns.push({ min: min2, max: max3, width, hidden, customWidth, outlineLevel });
     for (let c = min2; c <= max3; c++) {
       if (hidden) colHidden.add(c);
       if (outlineLevel > 0) colOutlineLevels.set(c, outlineLevel);
@@ -79150,9 +79182,11 @@ function parseCols(worksheet, defaultColWidth) {
 }
 function buildColumns(colDefs, colHidden, maxContentWidth, colCount, _defaultColWidth) {
   const explicitWidth = /* @__PURE__ */ new Map();
+  const pinned = /* @__PURE__ */ new Set();
   for (const def of colDefs) {
     for (let c = def.min; c <= def.max; c++) {
       explicitWidth.set(c, def.width);
+      if (def.customWidth) pinned.add(c);
     }
   }
   const columns = [];
@@ -79166,7 +79200,7 @@ function buildColumns(colDefs, colHidden, maxContentWidth, colCount, _defaultCol
     } else {
       width = Math.max(8, Math.min(contentChars + 2, 40));
     }
-    columns.push({ index: c, width, hidden });
+    columns.push({ index: c, width, hidden, ...pinned.has(c) ? { customWidth: true } : {} });
   }
   return columns;
 }
@@ -79210,6 +79244,7 @@ function parseSheetData(worksheet, styles, sharedStrings, hyperlinkMap, defaultR
     rowCount++;
     if (rowCount > maxRows) continue;
     const height = rowEl["@_ht"] ? parseFloat(rowEl["@_ht"]) : defaultRowHeight;
+    const customHeight = rowEl["@_customHeight"] === "1" || rowEl["@_customHeight"] === "true";
     const cellArr = rowEl["c"];
     const cells = [];
     if (cellArr) {
@@ -79231,7 +79266,8 @@ function parseSheetData(worksheet, styles, sharedStrings, hyperlinkMap, defaultR
       index: rowIndex,
       height,
       cells,
-      hidden: rowHidden
+      hidden: rowHidden,
+      ...customHeight ? { customHeight: true } : {}
     });
   }
   return {
@@ -83767,7 +83803,7 @@ function loadSheetFromParsed(ps, styles) {
     sheet.freeze = { row: ps.freezePane.frozenRows, col: ps.freezePane.frozenCols };
   }
   for (const col of ps.columns) {
-    if (col.width !== ps.defaultColWidth) {
+    if (col.customWidth || col.width !== ps.defaultColWidth) {
       sheet.colWidths.set(col.index, col.width);
     }
     if (col.hidden) {
@@ -83780,7 +83816,7 @@ function loadSheetFromParsed(ps, styles) {
     return `${startRef}:${endRef}`;
   });
   for (const row of ps.rows) {
-    if (row.height !== ps.defaultRowHeight) {
+    if (row.customHeight || row.height !== ps.defaultRowHeight) {
       sheet.rowHeights.set(row.index, row.height);
     }
     if (row.hidden) {
@@ -84668,6 +84704,103 @@ function clampInertCells(sheet) {
   for (const ref of pruned.keys()) sheet.cells.delete(ref);
   return pruned;
 }
+function axisStores(sheet, axis) {
+  return axis === "row" ? {
+    sizes: sheet.rowHeights,
+    outline: sheet.rowOutlineLevels,
+    hidden: sheet.hiddenRows,
+    breaks: sheet.rowPageBreaks,
+    setBreaks: (next) => {
+      sheet.rowPageBreaks = next;
+    }
+  } : {
+    sizes: sheet.colWidths,
+    outline: sheet.colOutlineLevels,
+    hidden: sheet.hiddenCols,
+    breaks: sheet.colPageBreaks,
+    setBreaks: (next) => {
+      sheet.colPageBreaks = next;
+    }
+  };
+}
+function shiftedIndex(i2, at2, delta) {
+  if (i2 < at2) return i2;
+  if (delta < 0 && i2 < at2 - delta) return null;
+  return i2 + delta;
+}
+function shiftKeys(map3, at2, delta) {
+  const affected = [...map3.entries()].filter(([i2]) => i2 >= at2);
+  for (const [i2] of affected) map3.delete(i2);
+  for (const [i2, value] of affected) {
+    const next = shiftedIndex(i2, at2, delta);
+    if (next !== null) map3.set(next, value);
+  }
+}
+function shiftMembers(set2, at2, delta) {
+  const affected = [...set2].filter((i2) => i2 >= at2);
+  for (const i2 of affected) set2.delete(i2);
+  for (const i2 of affected) {
+    const next = shiftedIndex(i2, at2, delta);
+    if (next !== null) set2.add(next);
+  }
+}
+function shiftBreaks(breaks, at2, delta) {
+  const moved = breaks.map((i2) => shiftedIndex(i2, at2, delta)).filter((i2) => i2 !== null);
+  return [...new Set(moved)].sort((a, b) => a - b);
+}
+function remapHyperlinks(sheet, landing) {
+  const next = /* @__PURE__ */ new Map();
+  for (const [ref, url2] of sheet.hyperlinks) {
+    const rc = refToRowColSafe(ref);
+    if (!rc) {
+      next.set(ref, url2);
+      continue;
+    }
+    const to = landing(rc.row, rc.col);
+    if (to) next.set(rowColToRef(to.row, to.col), url2);
+  }
+  sheet.hyperlinks = next;
+}
+function axisLanding(axis, at2, delta) {
+  return (row, col) => {
+    const next = shiftedIndex(axis === "row" ? row : col, at2, delta);
+    if (next === null) return null;
+    return axis === "row" ? { row: next, col } : { row, col: next };
+  };
+}
+function shiftAxisMetadata(sheet, axis, at2, delta) {
+  const stores = axisStores(sheet, axis);
+  shiftKeys(stores.sizes, at2, delta);
+  shiftKeys(stores.outline, at2, delta);
+  shiftMembers(stores.hidden, at2, delta);
+  stores.setBreaks(shiftBreaks(stores.breaks, at2, delta));
+  remapHyperlinks(sheet, axisLanding(axis, at2, delta));
+}
+var EMPTY_BAND = { sizes: [], outline: [], hidden: [], breaks: [], hyperlinks: [] };
+function snapshotAxisBand(sheet, axis, at2, count) {
+  const stores = axisStores(sheet, axis);
+  const inBand = (i2) => i2 >= at2 && i2 < at2 + count;
+  const links = [];
+  for (const [ref, url2] of sheet.hyperlinks) {
+    const rc = refToRowColSafe(ref);
+    if (rc && inBand(axis === "row" ? rc.row : rc.col)) links.push([ref, url2]);
+  }
+  return {
+    sizes: [...stores.sizes.entries()].filter(([i2]) => inBand(i2)),
+    outline: [...stores.outline.entries()].filter(([i2]) => inBand(i2)),
+    hidden: [...stores.hidden].filter(inBand),
+    breaks: stores.breaks.filter(inBand),
+    hyperlinks: links
+  };
+}
+function restoreAxisBand(sheet, axis, band) {
+  const stores = axisStores(sheet, axis);
+  for (const [i2, value] of band.sizes) stores.sizes.set(i2, value);
+  for (const [i2, value] of band.outline) stores.outline.set(i2, value);
+  for (const i2 of band.hidden) stores.hidden.add(i2);
+  stores.setBreaks([.../* @__PURE__ */ new Set([...stores.breaks, ...band.breaks])].sort((a, b) => a - b));
+  for (const [ref, url2] of band.hyperlinks) sheet.hyperlinks.set(ref, url2);
+}
 function insertRowsCommand(workbook, sheetIndex, at2, count) {
   const sheet = workbook.sheets[sheetIndex];
   let mergeSnapshot = [];
@@ -84688,11 +84821,7 @@ function insertRowsCommand(workbook, sheetIndex, at2, count) {
         sheet.cells.delete(ref);
         sheet.cells.set(rowColToRef(row + count, col), cell);
       }
-      const heightsToShift = Array.from(sheet.rowHeights.entries()).filter(([r]) => r >= at2).sort((a, b) => b[0] - a[0]);
-      for (const [r, h] of heightsToShift) {
-        sheet.rowHeights.delete(r);
-        sheet.rowHeights.set(r + count, h);
-      }
+      shiftAxisMetadata(sheet, "row", at2, count);
       adjustAllFormulasForRowShift(sheet, at2, count);
       adjustMergedCellsForRowInsert(sheet, at2, count);
       workbook.emit({ type: "rows_inserted", sheet: sheetIndex, at: at2, count });
@@ -84714,12 +84843,7 @@ function insertRowsCommand(workbook, sheetIndex, at2, count) {
         sheet.cells.delete(ref);
         sheet.cells.set(rowColToRef(row - count, col), cell);
       }
-      const heightsToShift = Array.from(sheet.rowHeights.entries()).filter(([r]) => r >= at2 + count).sort((a, b) => a[0] - b[0]);
-      for (const [r, h] of heightsToShift) {
-        sheet.rowHeights.delete(r);
-        sheet.rowHeights.set(r - count, h);
-      }
-      for (let r = at2; r < at2 + count; r++) sheet.rowHeights.delete(r);
+      shiftAxisMetadata(sheet, "row", at2, -count);
       for (const [ref, cell] of inertSnapshot) sheet.cells.set(ref, cell);
       workbook.emit({ type: "rows_deleted", sheet: sheetIndex, at: at2, count });
     }
@@ -84736,11 +84860,13 @@ function deleteRowsCommand(workbook, sheetIndex, at2, count) {
   }
   let mergeSnapshot = [];
   let inertSnapshot = /* @__PURE__ */ new Map();
+  let bandSnapshot = EMPTY_BAND;
   return {
     description: `Delete ${count} row${count > 1 ? "s" : ""} at ${at2}`,
     execute() {
       mergeSnapshot = [...sheet.mergedCells];
       inertSnapshot = clampInertCells(sheet);
+      bandSnapshot = snapshotAxisBand(sheet, "row", at2, count);
       for (const ref of snapshot.keys()) sheet.cells.delete(ref);
       const toMove = [];
       for (const [ref] of sheet.cells) {
@@ -84753,12 +84879,15 @@ function deleteRowsCommand(workbook, sheetIndex, at2, count) {
         sheet.cells.delete(ref);
         sheet.cells.set(rowColToRef(row - count, col), cell);
       }
+      shiftAxisMetadata(sheet, "row", at2, -count);
       adjustAllFormulasForRowShift(sheet, at2, -count);
       adjustMergedCellsForRowDelete(sheet, at2, count);
       workbook.emit({ type: "rows_deleted", sheet: sheetIndex, at: at2, count });
     },
     undo() {
       sheet.mergedCells = [...mergeSnapshot];
+      shiftAxisMetadata(sheet, "row", at2, count);
+      restoreAxisBand(sheet, "row", bandSnapshot);
       const toMove = [];
       for (const [ref] of sheet.cells) {
         const rc = refToRowColSafe(ref);
@@ -84798,11 +84927,7 @@ function insertColsCommand(workbook, sheetIndex, at2, count) {
         sheet.cells.delete(ref);
         sheet.cells.set(rowColToRef(row, col + count), cell);
       }
-      const widthsToShift = Array.from(sheet.colWidths.entries()).filter(([c]) => c >= at2).sort((a, b) => b[0] - a[0]);
-      for (const [c, w] of widthsToShift) {
-        sheet.colWidths.delete(c);
-        sheet.colWidths.set(c + count, w);
-      }
+      shiftAxisMetadata(sheet, "col", at2, count);
       adjustAllFormulasForColShift(sheet, at2, count);
       adjustMergedCellsForColInsert(sheet, at2, count);
       workbook.emit({ type: "cols_inserted", sheet: sheetIndex, at: at2, count });
@@ -84824,12 +84949,7 @@ function insertColsCommand(workbook, sheetIndex, at2, count) {
         sheet.cells.delete(ref);
         sheet.cells.set(rowColToRef(row, col - count), cell);
       }
-      const widthsToShift = Array.from(sheet.colWidths.entries()).filter(([c]) => c >= at2 + count).sort((a, b) => a[0] - b[0]);
-      for (const [c, w] of widthsToShift) {
-        sheet.colWidths.delete(c);
-        sheet.colWidths.set(c - count, w);
-      }
-      for (let c = at2; c < at2 + count; c++) sheet.colWidths.delete(c);
+      shiftAxisMetadata(sheet, "col", at2, -count);
       for (const [ref, cell] of inertSnapshot) sheet.cells.set(ref, cell);
       workbook.emit({ type: "cols_deleted", sheet: sheetIndex, at: at2, count });
     }
@@ -84846,11 +84966,13 @@ function deleteColsCommand(workbook, sheetIndex, at2, count) {
   }
   let mergeSnapshot = [];
   let inertSnapshot = /* @__PURE__ */ new Map();
+  let bandSnapshot = EMPTY_BAND;
   return {
     description: `Delete ${count} column${count > 1 ? "s" : ""} at ${at2}`,
     execute() {
       mergeSnapshot = [...sheet.mergedCells];
       inertSnapshot = clampInertCells(sheet);
+      bandSnapshot = snapshotAxisBand(sheet, "col", at2, count);
       for (const ref of snapshot.keys()) sheet.cells.delete(ref);
       const toMove = [];
       for (const [ref] of sheet.cells) {
@@ -84863,12 +84985,15 @@ function deleteColsCommand(workbook, sheetIndex, at2, count) {
         sheet.cells.delete(ref);
         sheet.cells.set(rowColToRef(row, col - count), cell);
       }
+      shiftAxisMetadata(sheet, "col", at2, -count);
       adjustAllFormulasForColShift(sheet, at2, -count);
       adjustMergedCellsForColDelete(sheet, at2, count);
       workbook.emit({ type: "cols_deleted", sheet: sheetIndex, at: at2, count });
     },
     undo() {
       sheet.mergedCells = [...mergeSnapshot];
+      shiftAxisMetadata(sheet, "col", at2, count);
+      restoreAxisBand(sheet, "col", bandSnapshot);
       const toMove = [];
       for (const [ref] of sheet.cells) {
         const rc = refToRowColSafe(ref);
@@ -91773,8 +91898,8 @@ Multiple workspaces in ${info.organization_name}. Run "lotics workspace select <
     console.error(`  Saved to the "${info.organization_name}" profile in ~/.lotics`);
   }
 }
-function requireClient(flags) {
-  const ctx = resolveContext(flags);
+function requireClient(flags, appWorkspaceId) {
+  const ctx = resolveContext(flags, appWorkspaceId);
   if (!ctx) {
     console.error('Not authenticated. Run "lotics auth signup", "lotics auth api-key <key>", or set LOTICS_API_KEY.');
     process.exit(1);
@@ -91790,6 +91915,7 @@ var SOURCE_LABELS = {
   env_key: "LOTICS_API_KEY env",
   env_org: "LOTICS_ORG env",
   local_pointer: "local .lotics/config.json (pin)",
+  app_manifest_profile: "app manifest workspace \u2192 its saved profile",
   global_profile: "global active profile"
 };
 function announceTarget(ctx, workspaceId) {
@@ -91803,12 +91929,15 @@ function announceTarget(ctx, workspaceId) {
   }
   console.error(`lotics \u2192 ${org} / ${workspaceId}`);
 }
-function applyAppManifestWorkspace(ctx, command, subcommand, pathArg, flags) {
-  if (command !== "app") return;
-  if (flags.workspace || process.env.LOTICS_WORKSPACE) return;
-  if (subcommand === "create" || subcommand === "pull") return;
+function appManifestWorkspaceId(command, subcommand, pathArg, flags) {
+  if (command !== "app") return void 0;
+  if (flags.workspace || process.env.LOTICS_WORKSPACE) return void 0;
+  if (subcommand === "create" || subcommand === "pull") return void 0;
   const dir = pathArg && !pathArg.startsWith("-") ? pathArg : process.cwd();
-  const workspaceId = readAppWorkspaceId(dir);
+  return readAppWorkspaceId(dir) ?? void 0;
+}
+function applyAppManifestWorkspace(ctx, command, subcommand, pathArg, flags) {
+  const workspaceId = appManifestWorkspaceId(command, subcommand, pathArg, flags);
   if (workspaceId) ctx.workspaceId = workspaceId;
 }
 async function resolveWorkspace(client, ctx) {
@@ -92008,7 +92137,7 @@ async function main() {
   }
   if (command === "app" && subcommand === "codegen") {
     const projectDir = toolArgs;
-    const ctx2 = resolveContext(flags);
+    const ctx2 = resolveContext(flags, appManifestWorkspaceId(command, subcommand, projectDir, flags));
     if (!ctx2) {
       await appCodegen({ projectDir });
       return;
@@ -92125,7 +92254,11 @@ async function main() {
     console.error("Downloads every file on the given file field into the output dir.");
     process.exit(1);
   }
-  const { client, ctx } = requireClient(flags);
+  const appPathArg = subcommand === "dev" ? toolArgs : void 0;
+  const { client, ctx } = requireClient(
+    flags,
+    appManifestWorkspaceId(command, subcommand, appPathArg, flags)
+  );
   if (command === "workspace") {
     if (subcommand === "doctor") {
       await resolveWorkspace(client, ctx);
@@ -92239,7 +92372,7 @@ Available workspaces:`);
     if (ctx.orgName) console.error(`Org: ${ctx.orgName}`);
     return;
   }
-  applyAppManifestWorkspace(ctx, command, subcommand, subcommand === "dev" ? toolArgs : void 0, flags);
+  applyAppManifestWorkspace(ctx, command, subcommand, appPathArg, flags);
   await resolveWorkspace(client, ctx);
   if (command === "knowledge") {
     await runKnowledgeCommand(client, subcommand, toolArgs, flags);

package/dist/src/client.d.ts

@@ -1,12 +1,4 @@
 import type { ContractConfigEntry, KnowledgeUpgradeEntry, ModifiedArtifact, PackageContentBinding, UpgradeResolutions } from "./package_content_types";
-/**
- * The error message for a non-ok response. A genuine JSON error (a 4xx carrying
- * a `message`) surfaces verbatim; a non-JSON body (a gateway HTML page), any
- * 5xx, or a JSON body without a `message` falls back to a body-free,
- * status-derived message. `parsed` is the JSON.parse of the body, or `null`.
- * In parity (by value, no shared dep) with `packages/app-sdk/src/rpc.ts`.
- */
-export declare function transportErrorMessage(status: number, parsed: unknown): string;
 /** One sort key forwarded to the app query RPC (wire shape of a `TableRecordSort` entry). */
 export interface AppQuerySortKey {
     field_key: string;
@@ -89,19 +81,20 @@ export interface ToolInfo {
 }
 /**
  * A single knowledge doc with its HYDRATED body — the shape of
- * `GET /v1/knowledge_docs/{id}`. `content` is resolved server-side from the
- * doc's content file (or the parked column for a legacy row), so this is the
- * one content-read path a non-sandbox client has. `content_file_id` is the
- * concurrency token the REST PATCH echoes; the `update_knowledge` TOOL CASes
- * internally, so a CLI caller never needs to pass it.
+ * `GET /v1/knowledge_docs/{id}`, and the one content-read path a non-sandbox
+ * client has. `content_sha` is the concurrency token the REST PATCH echoes back
+ * as `expected_content_sha`; the `update_knowledge` TOOL CASes internally, so a
+ * CLI caller never needs to pass it.
  */
 export interface KnowledgeDocDetail {
     id: string;
     workspace_id: string;
     name: string;
     description: string;
+    /** Folder address; "" is root. */
+    path: string;
     content: string;
-    content_file_id: string | null;
+    content_sha: string | null;
     files: unknown[];
     created_at: string;
     updated_at: string;

package/dist/src/client.js

@@ -1,36 +1,6 @@
+import { transportErrorMessage } from "@lotics/shared/transport_error";
 import fs from "node:fs";
 import path from "node:path";
-/**
- * A user-facing message for a transport/gateway failure — derived from the HTTP
- * status, never from the response body. A 524 (edge timeout on a long run), any
- * 5xx, or a non-JSON body (an HTML error page) must NOT surface its raw body. In
- * parity (by value, no shared dep) with the published transport in
- * `packages/app-sdk/src/rpc.ts`.
- */
-function gatewayErrorMessage(status) {
-    if (status === 524) {
-        return "The request took too long to finish (gateway timeout). It may still be running — check back in a moment, or try again.";
-    }
-    if (status >= 500) {
-        return "The service is temporarily unavailable. Please try again shortly.";
-    }
-    return "The service returned an unexpected response. Please try again.";
-}
-/**
- * The error message for a non-ok response. A genuine JSON error (a 4xx carrying
- * a `message`) surfaces verbatim; a non-JSON body (a gateway HTML page), any
- * 5xx, or a JSON body without a `message` falls back to a body-free,
- * status-derived message. `parsed` is the JSON.parse of the body, or `null`.
- * In parity (by value, no shared dep) with `packages/app-sdk/src/rpc.ts`.
- */
-export function transportErrorMessage(status, parsed) {
-    const jsonMessage = parsed && typeof parsed.message === "string"
-        ? parsed.message
-        : null;
-    return parsed === null || status >= 500 || jsonMessage === null
-        ? gatewayErrorMessage(status)
-        : jsonMessage;
-}
 function findAvailableFilename(dir, filename, reserved) {
     // `reserved` tracks absolute paths claimed by in-flight downloads in the same
     // batch — required for parallel callers because the file may not be on disk

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotics/cli",
-  "version": "0.96.6",
+  "version": "0.98.0",
   "description": "Lotics SDK and CLI for AI agents",
   "type": "module",
   "bin": {