@lotics/cli 0.101.0 → 0.101.1

package/dist/render_page.js

@@ -28695,6 +28695,73 @@ ${e.toString()}`);
       offsetYEmu
     };
   }
+  var EMU_PER_PT = 12700;
+  var VML_UNIT_TO_EMU = {
+    pt: EMU_PER_PT,
+    in: EMU_PER_PT * 72,
+    cm: EMU_PER_PT * 72 / 2.54,
+    mm: EMU_PER_PT * 72 / 25.4,
+    pc: EMU_PER_PT * 12,
+    px: EMU_PER_PT * 72 / 96
+  };
+  function readVmlLength(style, property) {
+    const match = new RegExp(`(?:^|;)\\s*${property}\\s*:\\s*([0-9.]+)([a-z]*)`, "i").exec(style);
+    if (!match) return null;
+    const value = Number.parseFloat(match[1]);
+    if (!Number.isFinite(value)) return null;
+    const unit = match[2].toLowerCase();
+    const perUnit = unit === "" ? EMU_PER_PT : VML_UNIT_TO_EMU[unit];
+    if (perUnit === void 0) return null;
+    return Math.round(value * perUnit);
+  }
+  function parsePict(pictXml) {
+    if (getTagName(pictXml) !== "w:pict") return null;
+    const imagedata = findFirstByTag(pictXml, "v:imagedata");
+    if (!imagedata) return null;
+    const relationshipId = getAttr(imagedata, "r:id") ?? getAttr(imagedata, "r:embed") ?? null;
+    if (relationshipId === null) return null;
+    const shape = findFirstByTag(pictXml, "v:shape") ?? findFirstByTag(pictXml, "v:rect");
+    const style = shape ? getAttr(shape, "style") ?? "" : "";
+    return {
+      relationshipId,
+      widthEmu: readVmlLength(style, "width"),
+      heightEmu: readVmlLength(style, "height"),
+      alt: (shape ? getAttr(shape, "alt") : void 0) ?? "",
+      // VML positioning is a CSS-ish `style`, not the wp: anchor vocabulary the
+      // anchor fields describe. Reporting it as inline keeps the renderer from
+      // acting on offsets that were never read.
+      inline: true,
+      wrap: null,
+      floatSide: null,
+      behindDoc: false,
+      offsetXEmu: null,
+      offsetYEmu: null
+    };
+  }
+  function parseAlternateContent(el) {
+    if (getTagName(el) !== "mc:AlternateContent") return null;
+    const branches = getChildren(el).filter((child) => {
+      const tag = getTagName(child);
+      return tag === "mc:Choice" || tag === "mc:Fallback";
+    });
+    const ordered = [
+      ...branches.filter((b) => getTagName(b) === "mc:Choice"),
+      ...branches.filter((b) => getTagName(b) === "mc:Fallback")
+    ];
+    for (const branch of ordered) {
+      const drawing = findFirstByTag(branch, "w:drawing");
+      if (drawing) {
+        const info = parseDrawing(drawing);
+        if (info && info.relationshipId !== null) return info;
+      }
+      const pict = findFirstByTag(branch, "w:pict");
+      if (pict) {
+        const info = parsePict(pict);
+        if (info) return info;
+      }
+    }
+    return null;
+  }
   function readPosOffset(containerEl, positionTag) {
     const position = findFirstByTag(containerEl, positionTag);
     if (!position) return null;
@@ -42936,6 +43003,24 @@ ${e.toString()}`);
       }
     };
   }
+  function imageNode(info, originalXml, marks) {
+    return docxSchema.nodes.image_inline.create(
+      {
+        relationshipId: info.relationshipId,
+        widthEmu: info.widthEmu,
+        heightEmu: info.heightEmu,
+        alt: info.alt,
+        originalXml,
+        wrap: info.wrap,
+        floatSide: info.floatSide,
+        behindDoc: info.behindDoc,
+        offsetXEmu: info.offsetXEmu,
+        offsetYEmu: info.offsetYEmu
+      },
+      void 0,
+      marks
+    );
+  }
   function convertRunChild(child, marks, state) {
     if (child.kind === "text") {
       if (child.value.length === 0) return [];
@@ -42963,26 +43048,15 @@ ${e.toString()}`);
     }
     if (tag === "w:drawing") {
       const info = parseDrawing(child.xml);
-      if (info) {
-        return [
-          docxSchema.nodes.image_inline.create(
-            {
-              relationshipId: info.relationshipId,
-              widthEmu: info.widthEmu,
-              heightEmu: info.heightEmu,
-              alt: info.alt,
-              originalXml: child.xml,
-              wrap: info.wrap,
-              floatSide: info.floatSide,
-              behindDoc: info.behindDoc,
-              offsetXEmu: info.offsetXEmu,
-              offsetYEmu: info.offsetYEmu
-            },
-            void 0,
-            marks
-          )
-        ];
-      }
+      if (info) return [imageNode(info, child.xml, marks)];
+    }
+    if (tag === "mc:AlternateContent") {
+      const info = parseAlternateContent(child.xml);
+      if (info) return [imageNode(info, child.xml, marks)];
+    }
+    if (tag === "w:pict") {
+      const info = parsePict(child.xml);
+      if (info) return [imageNode(info, child.xml, marks)];
     }
     return [
       docxSchema.nodes.opaque_inline.create({ xml: child.xml }, void 0, marks)

package/dist/src/cli.js

@@ -44955,6 +44955,7 @@ var LoticsClient = class {
       formData.append("capabilities", JSON.stringify(args.capabilities));
     }
     formData.append("workflow_aliases", JSON.stringify(args.workflow_aliases ?? []));
+    formData.append("query_aliases", JSON.stringify(args.query_aliases ?? []));
     const url2 = `${this.baseUrl}/v1/apps/${encodeURIComponent(args.app_id)}/versions`;
     const response = await fetch(url2, {
       method: "POST",
@@ -64951,12 +64952,16 @@ var appWorkflowContractSchema = zod_default.object({
   inputs: zod_default.record(zod_default.string(), appWorkflowInputSchema).optional(),
   outputs: zod_default.record(zod_default.string(), appWorkflowOutputSchema).optional()
 });
+var MAX_APP_CAPABILITY_DESCRIPTION = 300;
 var appQueryDeclarationSchema = zod_default.object({
   ast: zod_default.unknown().describe(
     "Query AST template (a QueryNode). Validated server-side via parseQueryNode at deploy. May embed {{params.<name>}} tokens in filter value positions."
   ),
   params: zod_default.record(zod_default.string(), appWorkflowInputSchema).optional().describe(
     "Typed param schema. Keys are param names referenced as {{params.<name>}} in the ast; values declare type + constraints. The server validates the caller's params payload against this before interpolating. Omit for queries that take no params."
+  ),
+  description: zod_default.string().optional().describe(
+    `What this query returns, in one line \u2014 read by an agent choosing between the app's aliases. An alias is a JS identifier, which names a query without saying what it covers. Capped at ${MAX_APP_CAPABILITY_DESCRIPTION} characters.`
   )
 });
 var appAgentDeclarationSchema = zod_default.object({
@@ -70822,7 +70827,8 @@ async function appDeploy(client, args) {
         // typing artifact maintained by habit, so its keys answered this question
         // with whatever the author last remembered to write. Stop calling an
         // alias + redeploy to lift the guard before removing its binding.
-        workflow_aliases: called.workflows
+        workflow_aliases: called.workflows,
+        query_aliases: called.queries
       });
       writeAppMeta(projectDir, {
         ...meta3,
@@ -89648,37 +89654,47 @@ function extractParagraphText(el) {
   }
   return parts.join("");
 }
-function getRunsFromParagraph(el) {
-  const runs = [];
+function getParagraphTextSegments(el) {
+  const segments = [];
   for (const child of getChildren(el)) {
     if (getTagName(child) !== "w:r") continue;
-    let text = "";
-    let hasText = false;
+    let pending = [];
+    const flush = () => {
+      if (pending.length === 0) return;
+      const text = pending.map(
+        (node) => getChildren(node).reduce(
+          (acc, tn) => typeof tn["#text"] === "string" ? acc + tn["#text"] : acc,
+          ""
+        )
+      ).join("");
+      segments.push({ element: child, textNodes: pending, text });
+      pending = [];
+    };
     for (const grandchild of getChildren(child)) {
-      if (getTagName(grandchild) !== "w:t") continue;
-      hasText = true;
-      for (const tn of getChildren(grandchild)) {
-        if (typeof tn["#text"] === "string") text += tn["#text"];
+      if (getTagName(grandchild) === "w:t") {
+        pending.push(grandchild);
+        continue;
       }
+      flush();
     }
-    if (hasText) runs.push({ element: child, text });
+    flush();
   }
-  return runs;
+  return segments;
 }
-function writeRunText(runElement, newText) {
-  const children = getChildren(runElement);
-  const textNode = { "w:t": [{ "#text": newText }], ":@": { "@_xml:space": "preserve" } };
-  const indices = children.flatMap((c, i2) => getTagName(c) === "w:t" ? [i2] : []);
-  if (indices.length === 0) {
-    children.push(textNode);
-    return;
+function setSegmentText(segment, newText) {
+  const children = getChildren(segment.element);
+  const textNode = {
+    "w:t": [{ "#text": newText }],
+    ":@": { "@_xml:space": "preserve" }
+  };
+  const head = children.indexOf(segment.textNodes[0]);
+  children[head] = textNode;
+  for (let i2 = segment.textNodes.length - 1; i2 >= 1; i2--) {
+    const at2 = children.indexOf(segment.textNodes[i2]);
+    if (at2 >= 0) children.splice(at2, 1);
   }
-  children[indices[0]] = textNode;
-  for (let i2 = indices.length - 1; i2 >= 1; i2--) children.splice(indices[i2], 1);
-}
-function setRunText(run, newText) {
-  writeRunText(run.element, newText);
-  run.text = newText;
+  segment.textNodes = [textNode];
+  segment.text = newText;
 }
 function computeReplacementRanges(text, query, replacement, matchType, maxReplacements, startCount) {
   const ranges = [];
@@ -89713,39 +89729,39 @@ function computeReplacementRanges(text, query, replacement, matchType, maxReplac
   }
   return { ranges, count };
 }
-function applyRangeReplacements(runs, ranges) {
+function applyRangeReplacements(segments, ranges) {
   if (ranges.length === 0) return;
   const bounds = [];
   let offset = 0;
-  for (const run of runs) {
-    bounds.push({ run, start: offset, end: offset + run.text.length });
-    offset += run.text.length;
+  for (const segment of segments) {
+    bounds.push({ segment, start: offset, end: offset + segment.text.length });
+    offset += segment.text.length;
   }
-  const joined = runs.map((r) => r.text).join("");
+  const joined = segments.map((s) => s.text).join("");
   const sorted = [...ranges].sort((a, b) => a.start - b.start);
-  for (const { run, start: runStart, end: runEnd } of bounds) {
+  for (const { segment, start: segStart, end: segEnd } of bounds) {
     let next = "";
-    let cursor = runStart;
+    let cursor = segStart;
     for (const range2 of sorted) {
-      if (range2.end <= runStart || range2.start >= runEnd) continue;
-      const keepUntil = Math.min(range2.start, runEnd);
-      const from = Math.max(cursor, runStart);
+      if (range2.end <= segStart || range2.start >= segEnd) continue;
+      const keepUntil = Math.min(range2.start, segEnd);
+      const from = Math.max(cursor, segStart);
       if (keepUntil > from) next += joined.slice(from, keepUntil);
-      if (runStart <= range2.start && range2.start < runEnd) next += range2.replacement;
+      if (segStart <= range2.start && range2.start < segEnd) next += range2.replacement;
       cursor = Math.max(cursor, range2.end);
     }
-    const tail = Math.max(cursor, runStart);
-    if (runEnd > tail) next += joined.slice(tail, runEnd);
-    if (next !== run.text) setRunText(run, next);
+    const tail = Math.max(cursor, segStart);
+    if (segEnd > tail) next += joined.slice(tail, segEnd);
+    if (next !== segment.text) setSegmentText(segment, next);
   }
 }
 function replaceInParagraph(el, query, replacement, matchType, maxReplacements, replacementsMade) {
   if (!extractParagraphText(el)) return replacementsMade;
-  const runs = getRunsFromParagraph(el);
-  if (runs.length === 0) return replacementsMade;
-  const text = runs.length === 1 ? runs[0].text : runs.map((r) => r.text).join("");
+  const segments = getParagraphTextSegments(el);
+  if (segments.length === 0) return replacementsMade;
+  const text = segments.length === 1 ? segments[0].text : segments.map((s) => s.text).join("");
   const { ranges, count } = computeReplacementRanges(text, query, replacement, matchType, maxReplacements, replacementsMade);
-  applyRangeReplacements(runs, ranges);
+  applyRangeReplacements(segments, ranges);
   return count;
 }
 function replaceText(bodyElements, query, replacement, matchType = "contains", maxReplacements = Infinity) {

package/dist/src/client.d.ts

@@ -222,6 +222,7 @@ export declare class LoticsClient {
         queries?: Record<string, {
             ast: unknown;
             params?: Record<string, unknown>;
+            description?: string;
         }> | null;
         /**
          * Live alias → agent declaration map from `apps.agents`. Source of truth for
@@ -866,6 +867,7 @@ export declare class LoticsClient {
     setAppQuery(app_id: string, alias: string, declaration: {
         ast: unknown;
         params?: Record<string, unknown>;
+        description?: string;
     }): Promise<ToolExecuteResult>;
     /**
      * Bind (create or replace) an app agent by alias via the `set_app_agent` tool
@@ -1006,14 +1008,16 @@ export declare class LoticsClient {
         prev_version_id?: string | null;
         message?: string | null;
         /**
-         * Alias → query declaration map from `package.json#lotics.queries`. Each
-         * value is `{ ast, params? }` — a fixed query AST template and an optional
-         * typed param schema. Always sent (empty object when none declared) so the
-         * server overwrites apps.queries authoritatively.
+         * Alias → query declaration map ECHOED BACK from the live row (see
+         * `readLiveQueries`), not read from the manifest. Every key the row holds
+         * must survive the round trip — `description` included — because a server
+         * that treats a present map as authoritative writes exactly what it is
+         * sent, so a lossy echo silently strips whatever it forgot.
          */
         queries?: Record<string, {
             ast: unknown;
             params?: Record<string, unknown>;
+            description?: string;
         }>;
         /**
          * Opt-in app capabilities from `package.json#lotics.capabilities`. The CLI
@@ -1032,6 +1036,7 @@ export declare class LoticsClient {
          * (empty array when none declared).
          */
         workflow_aliases?: string[];
+        query_aliases?: string[];
     }): Promise<{
         version_id: string;
         version_number: number;

package/dist/src/client.js

@@ -723,6 +723,7 @@ export class LoticsClient {
         // server records what the served version calls — the remove_app_workflow
         // guard reads this back. These are the manifest KEYS only, never bindings.
         formData.append("workflow_aliases", JSON.stringify(args.workflow_aliases ?? []));
+        formData.append("query_aliases", JSON.stringify(args.query_aliases ?? []));
         const url = `${this.baseUrl}/v1/apps/${encodeURIComponent(args.app_id)}/versions`;
         const response = await fetch(url, {
             method: "POST",

package/package.json

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