pi-outpost 0.53.0 → 0.55.0

package/dist/pi-outpost-tools.mjs

@@ -99494,6 +99494,174 @@ var require_extend = __commonJS({
 // ../server/src/piOutpostTools.ts
 import fs21 from "node:fs/promises";
 
+// ../shared/src/structuredExchangeProfile.ts
+var STRUCTURED_EXCHANGE_PROFILE_REGISTRY_SCHEMA_V2 = "urn:structured-exchange-profile-registry:2";
+var STRUCTURED_EXCHANGE_PROFILE_REGISTRY_PATH = ".pi-outpost/structured-exchange.json";
+var STRUCTURED_EXCHANGE_CONFORMITY_REPORT_PROFILE = "urn:structured-exchange-conformity-report:1";
+var STRUCTURED_EXCHANGE_RULES_REGISTER_PROFILE = "urn:structured-exchange-rules-register:1";
+var STRUCTURED_EXCHANGE_RULE_PATTERNS_PROFILE = "urn:structured-exchange-rule-patterns:1";
+var RESERVED_PROFILE_IDENTIFIERS = /* @__PURE__ */ new Set([
+  STRUCTURED_EXCHANGE_CONFORMITY_REPORT_PROFILE,
+  STRUCTURED_EXCHANGE_RULES_REGISTER_PROFILE,
+  STRUCTURED_EXCHANGE_RULE_PATTERNS_PROFILE
+]);
+var STRUCTURED_EXCHANGE_PROFILE_CEILINGS = {
+  /** A profile's identifier, bounded like the `profile` a document names it by. */
+  id: 200,
+  label: 500,
+  description: 2e3,
+  /** Kinds per vocabulary, as a document's `kindsPerVocabulary`. */
+  kindsPerVocabulary: 64,
+  /** Attributes one kind declares, as a document's `attributesPerItem`. */
+  attributesPerKind: 50,
+  attributeName: 200,
+  /**
+   * Values one enumeration lists. Generous: a requirements tool's enumerations
+   * include long ones — components, suppliers — and a profile that cannot hold its
+   * model's is a profile nobody can finish.
+   */
+  enumerationValues: 500,
+  /** One enumeration value, as a document's `attributeString`. */
+  enumerationValue: 1e3,
+  viewpoints: 20,
+  /** Profiles one registry lists. */
+  profilesPerRegistry: 20,
+  profilePath: 500,
+  /** Bytes read from a profile file before it is parsed. */
+  profileBytes: 1048576,
+  /** Bytes read from a registry file before it is parsed. */
+  registryBytes: 65536
+};
+function profileListing(profile) {
+  const lines = [`Profile ${profile.id} \u2014 ${profile.label}`];
+  if (profile.description !== void 0) lines.push(profile.description);
+  const vocabulary = (heading3, kinds, relationships) => {
+    const declared = kinds ?? [];
+    lines.push("", `${heading3}: ${declared.length}`);
+    for (const declaration of declared) {
+      lines.push(`  ${declaration.kind}`);
+      if (declaration.description !== void 0) lines.push(`    ${declaration.description}`);
+      if (relationships) {
+        lines.push(`    source: ${declaration.from?.join(", ") ?? "any element kind"}`);
+        lines.push(`    target: ${declaration.to?.join(", ") ?? "any element kind"}`);
+      }
+      const attributes2 = declaration.attributes ?? [];
+      if (attributes2.length === 0) lines.push("    (no attributes)");
+      for (const attribute of attributes2) {
+        const traits = [
+          attribute.list === true ? `list of ${attribute.type}` : attribute.type,
+          ...attribute.type === "enumeration" ? [attribute.closed === true ? "closed" : "open"] : [],
+          attribute.required === true ? "required" : "optional"
+        ];
+        const count = attribute.type === "enumeration" ? ` \u2014 ${(attribute.values ?? []).length} values` : "";
+        lines.push(`    ${attribute.name}: ${traits.join(", ")}${count}`);
+        if (attribute.description !== void 0) lines.push(`      ${attribute.description}`);
+        for (const value of attribute.values ?? []) lines.push(`      - ${value}`);
+      }
+    }
+  };
+  vocabulary("Element kinds (graph elements and table rows)", profile.elementKinds, false);
+  vocabulary("Relationship kinds (graph relationships and table relations)", profile.relationshipKinds, true);
+  const viewpoints = profile.viewpoints ?? [];
+  lines.push("", `Viewpoints: ${viewpoints.length}`);
+  for (const viewpoint of viewpoints) {
+    lines.push(`  ${viewpoint.id} \u2014 ${viewpoint.label}: ${viewpoint.concern}`);
+    if (viewpoint.elementKinds !== void 0) lines.push(`    element kinds: ${viewpoint.elementKinds.join(", ")}`);
+    if (viewpoint.relationshipKinds !== void 0) lines.push(`    relationship kinds: ${viewpoint.relationshipKinds.join(", ")}`);
+  }
+  return `${lines.join("\n")}
+`;
+}
+function describeConditions(set) {
+  return Object.entries(set ?? {}).map(([name, values]) => `${name} \u2208 {${values.map((value) => JSON.stringify(value)).join(", ")}}`).join(" and ") || "always";
+}
+function describeLinkConditions(set) {
+  const parts = [
+    set?.from === void 0 ? void 0 : `source ${describeConditions(set.from)}`,
+    set?.to === void 0 ? void 0 : `target ${describeConditions(set.to)}`
+  ].filter((part) => part !== void 0);
+  return parts.length === 0 ? "always" : parts.join(" and ");
+}
+function rulesListing(profileId, rules) {
+  const conditions = describeConditions;
+  const ends = describeLinkConditions;
+  const lines = [`Rules for ${profileId}: ${rules.length}`];
+  for (const rule of rules) {
+    lines.push("", `  ${rule.id} \u2014 ${rule.level}${rule.source === void 0 ? "" : ` \u2014 ${rule.source}`}`, `    ${rule.statement}`);
+    if (rule.element !== void 0) {
+      lines.push(`    applies to: element ${rule.element}`, `    when: ${conditions(rule.when)}`);
+      lines.push(`    then: ${rule.then === "forbidden" ? "forbidden" : conditions(rule.then)}`);
+    } else {
+      lines.push(`    applies to: relationship ${rule.relationship}`, `    when: ${ends(rule.when)}`);
+      lines.push(`    then: ${rule.then === "forbidden" ? "forbidden" : ends(rule.then)}`);
+    }
+  }
+  return `${lines.join("\n")}
+`;
+}
+var STRUCTURED_EXCHANGE_RULES_CEILINGS = {
+  rulesPerFile: 200,
+  ruleId: 200,
+  statement: 2e3,
+  source: 500,
+  /** Conditions in one set — `when`, `then`, or one end of a link. */
+  conditionsPerSet: 20,
+  /** Values one condition allows, as `enumerationValues`. */
+  valuesPerCondition: 500,
+  /** One value, as `enumerationValue`. */
+  value: 1e3,
+  attributeName: 200,
+  kind: 100,
+  /** Rules files one registry lists. */
+  rulesFilesPerRegistry: 20,
+  /** Bytes read from a rules file before it is parsed. */
+  rulesBytes: 1048576
+};
+
+// ../server/src/projectModelTool.ts
+var PROJECT_MODEL_TOOL = "present_project_model";
+
+// ../server/src/documentTools.ts
+var PRESENTATION_TOOLS = ["pptx_layouts", "pptx_create", "pptx_update", "pptx_render"];
+var WORD_TOOLS = ["docx_styles", "docx_create", "docx_update", "docx_restyle", "docx_render"];
+var WORD_COMPARE_TOOL = "docx_compare";
+var EXTRACTORS = {
+  // `pdf_render` travels with the extractor because it is the answer to something the
+  // extractor says: a page carrying neither text nor an image tells the caller to draw
+  // it, and that advice is worthless if the tool it names was never offered.
+  pdf: ["pdf_extract", "pdf_render"],
+  // A Word document may be read, updated, or be the template a new one is written from.
+  docx: ["docx_extract", ...WORD_TOOLS],
+  // A .dotx is only ever a template.
+  dotx: WORD_TOOLS,
+  xlsx: ["xlsx_extract"],
+  // A deck may be read, or be the template a new one is built from.
+  pptx: ["pptx_extract", ...PRESENTATION_TOOLS],
+  // A .potx is only ever a template.
+  potx: PRESENTATION_TOOLS,
+  // A message is read by one tool, which also unpacks what it carries. The
+  // extractors for those attachments are published when they are *written*, not
+  // here: naming a `.msg` says nothing about what is inside it.
+  msg: ["mail_extract"],
+  eml: ["mail_extract"],
+  emlx: ["mail_extract"]
+};
+var DOCUMENT_TOOLS = [...new Set(Object.values(EXTRACTORS).flat()), WORD_COMPARE_TOOL];
+var TOOL_SEARCH_TOOL = "tool_search";
+var DEFERRED_TOOLS = [
+  ...DOCUMENT_TOOLS,
+  PROJECT_MODEL_TOOL,
+  "drawio_check",
+  "poster_check",
+  "poster_pictures",
+  "compare_timelines",
+  "write_structure_figure",
+  "write_structure_table"
+];
+function deferOnDemandTools(tools) {
+  return tools.map((tool) => DEFERRED_TOOLS.includes(tool.name) ? { ...tool, exposure: "deferred" } : tool);
+}
+
 // ../server/src/posterPictureHooks.ts
 import { readFile } from "node:fs/promises";
 import os from "node:os";
@@ -99702,6 +99870,177 @@ function registerPosterPictureHooks(pi) {
   });
 }
 
+// ../server/src/btwExtension.ts
+import { randomUUID } from "node:crypto";
+var BTW_WIDGET = "btw";
+var BTW_TITLE = "Side answer \xB7 not part of the conversation";
+var DEFAULT_BTW_BUDGET = 6e4;
+var TOOL_TEXT_LIMIT = 2e3;
+var LEFT_OUT = "[Earlier conversation left out.]";
+var SYSTEM_PROMPT = [
+  "You answer a side question about a conversation between a user and a coding agent, which may still be working.",
+  "Answer only from the conversation shown. You have no tools: you cannot read files, run commands or look anything up.",
+  "If the conversation does not show the answer, say so. Never add a reason, a fact or a detail the conversation does not state.",
+  "Earlier side questions, when given, are the user's previous questions to you, and the new question may follow up on them.",
+  "Answer briefly, in the language of the question."
+].join(" ");
+function cut(text7, limit) {
+  return text7.length <= limit ? text7 : `${text7.slice(0, limit)}\u2026 [cut]`;
+}
+function textOf(content3) {
+  if (typeof content3 === "string") return content3;
+  if (!Array.isArray(content3)) return "";
+  return content3.flatMap((block) => block?.type === "text" && typeof block.text === "string" ? [block.text] : block?.type === "image" ? ["[image]"] : []).join("\n").trim();
+}
+function sectionOf(entry) {
+  const message = entry.type === "message" ? entry.message : void 0;
+  if (!message) return void 0;
+  if (message.role === "user") {
+    const text7 = textOf(message.content);
+    return text7 ? `User: ${text7}` : void 0;
+  }
+  if (message.role === "assistant") {
+    const lines = [];
+    const text7 = textOf(message.content);
+    if (text7) lines.push(`Assistant: ${text7}`);
+    if (Array.isArray(message.content)) {
+      for (const block of message.content) {
+        if (block?.type !== "toolCall" || typeof block.name !== "string") continue;
+        lines.push(`Assistant called ${block.name} ${cut(JSON.stringify(block.arguments ?? {}), TOOL_TEXT_LIMIT)}`);
+      }
+    }
+    return lines.length > 0 ? lines.join("\n") : void 0;
+  }
+  if (message.role === "toolResult") {
+    const label = `${message.isError ? "Error from" : "Result of"} ${message.toolName ?? "tool"}`;
+    return `${label}: ${cut(textOf(message.content), TOOL_TEXT_LIMIT)}`;
+  }
+  return void 0;
+}
+function serialiseBranch(entries, budget = DEFAULT_BTW_BUDGET) {
+  let start = 0;
+  let summary;
+  const compaction = entries.findLastIndex((entry) => entry.type === "compaction");
+  if (compaction !== -1) {
+    const entry = entries[compaction];
+    summary = `Summary of the conversation before this point: ${entry.summary ?? ""}`;
+    const kept2 = entries.findIndex((candidate) => candidate.id === entry.firstKeptEntryId);
+    start = kept2 !== -1 && kept2 < compaction ? kept2 : compaction + 1;
+  }
+  const sections = entries.slice(start).flatMap((entry) => {
+    const section2 = sectionOf(entry);
+    return section2 === void 0 ? [] : [section2];
+  });
+  const separator = "\n\n";
+  const head = summary === void 0 ? [] : [cut(summary, Math.floor(budget / 2))];
+  const whole = [...head, ...sections].join(separator);
+  if (whole.length <= budget) return whole;
+  head.push(LEFT_OUT);
+  const room = budget - head.join(separator).length;
+  const kept = [];
+  let used = 0;
+  for (let i2 = sections.length - 1; i2 >= 0; i2--) {
+    const cost = separator.length + sections[i2].length;
+    if (used + cost > room) break;
+    kept.unshift(sections[i2]);
+    used += cost;
+  }
+  if (kept.length === 0 && sections.length > 0) {
+    const last = sections[sections.length - 1];
+    kept.push(last.slice(last.length - Math.max(0, room - separator.length)));
+  }
+  return [...head, ...kept].join(separator);
+}
+function serialiseThread(thread, limit) {
+  const parts = thread.map(({ question, answer: answer3 }) => `Side question: ${question}
+Side answer: ${answer3}`);
+  while (parts.length > 0 && parts.join("\n\n").length > limit) parts.shift();
+  return parts.join("\n\n");
+}
+function sideQuestionContext(entries, question, budget = DEFAULT_BTW_BUDGET, thread = []) {
+  const earlier = serialiseThread(thread, Math.floor(budget / 2));
+  const conversation = serialiseBranch(entries, Math.max(0, budget - question.length - earlier.length));
+  const now = Date.now();
+  const text7 = `<conversation>
+${conversation}
+</conversation>${earlier ? `
+
+<earlier_side_questions>
+${earlier}
+</earlier_side_questions>` : ""}`;
+  return {
+    systemPrompt: SYSTEM_PROMPT,
+    messages: [
+      { role: "user", content: [{ type: "text", text: text7 }], timestamp: now },
+      { role: "user", content: [{ type: "text", text: question }], timestamp: now }
+    ]
+  };
+}
+var QUESTION_MARK = "\u203A ";
+function panel(question, body, earlier) {
+  const exchanges = earlier.flatMap((exchange) => [`${QUESTION_MARK}${exchange.question}`, ...exchange.answer.split(/\r?\n/), ""]);
+  return [BTW_TITLE, ...exchanges, `${QUESTION_MARK}${question}`, ...body];
+}
+function show(ctx, lines) {
+  try {
+    ctx.ui.setWidget(BTW_WIDGET, lines, { placement: "aboveEditor" });
+  } catch {
+  }
+}
+async function answer(ctx, question, budget, thread, signal) {
+  const model = ctx.model;
+  if (!model) return { answered: false, reason: "no model is selected" };
+  if (!ctx.modelRegistry.hasConfiguredAuth(model)) return { answered: false, reason: `${model.provider}/${model.id} has no credentials` };
+  const context = sideQuestionContext(ctx.sessionManager.getBranch(), question, budget, thread);
+  const reply = await ctx.modelRegistry.streamSimple(model, context, { signal, cacheRetention: "none", sessionId: randomUUID() }).result();
+  if (reply.stopReason === "error") return { answered: false, reason: reply.errorMessage ?? "the provider failed" };
+  const text7 = textOf(reply.content);
+  return text7 ? { answered: true, text: text7 } : { answered: false, reason: "the model returned nothing" };
+}
+function createBtwExtension(options2 = {}) {
+  const budget = options2.budget ?? DEFAULT_BTW_BUDGET;
+  return function btw(pi) {
+    let pending;
+    let thread = [];
+    const cancel = () => {
+      pending?.abort();
+      pending = void 0;
+    };
+    const close2 = (ctx) => {
+      cancel();
+      thread = [];
+      show(ctx, void 0);
+    };
+    pi.registerCommand("btw", {
+      description: "Ask a side question about the conversation, without interrupting the agent or entering the conversation",
+      handler: async (args, ctx) => {
+        const question = args.trim();
+        if (!question) {
+          close2(ctx);
+          return;
+        }
+        cancel();
+        const controller = new AbortController();
+        pending = controller;
+        const earlier = [...thread];
+        show(ctx, panel(question, ["Answering\u2026"], earlier));
+        void answer(ctx, question, budget, earlier, controller.signal).catch((error) => ({ answered: false, reason: error instanceof Error ? error.message : String(error) })).then((outcome) => {
+          if (pending !== controller) return;
+          pending = void 0;
+          if (outcome.answered) thread = [...earlier, { question, answer: outcome.text }];
+          const body = outcome.answered ? outcome.text.split(/\r?\n/) : [`No answer: ${outcome.reason}.`];
+          show(ctx, panel(question, body, earlier));
+        });
+      }
+    });
+    pi.on("session_start", (_event, ctx) => close2(ctx));
+    pi.on("session_shutdown", () => {
+      cancel();
+      thread = [];
+    });
+  };
+}
+
 // ../server/src/docxTool.ts
 import fs19 from "node:fs/promises";
 import path23 from "node:path";
@@ -105223,7 +105562,7 @@ var CHANGE_RECORD = /^w:\w+(?:Pr|PrEx|Grid)Change$/;
 var REVISION_PRECEDENCE = ["del", "moveFrom", "moveTo", "ins"];
 function parseBody(xml, deadline, pictureMarkerFor, review) {
   const blocks = [];
-  const show = review?.show === true;
+  const show2 = review?.show === true;
   let paragraph2 = [];
   let paragraphHeading;
   let styleId;
@@ -105318,9 +105657,9 @@ function parseBody(xml, deadline, pictureMarkerFor, review) {
     return removes(revision) ? { open: DELETE_OPEN, close: DELETE_CLOSE + referenceSentinel(id) } : { open: INSERT_OPEN, close: INSERT_CLOSE + referenceSentinel(id) };
   };
   const emit = (raw, revision) => {
-    const text7 = show ? raw.replace(/[\u0001\u0002]/g, "") : raw;
+    const text7 = show2 ? raw.replace(/[\u0001\u0002]/g, "") : raw;
     const markers = note(text7, revision);
-    target().push(show && markers !== void 0 ? { text: text7, format: runFormat, revision: markers } : { text: text7, format: runFormat });
+    target().push(show2 && markers !== void 0 ? { text: text7, format: runFormat, revision: markers } : { text: text7, format: runFormat });
   };
   const pushRaw = (text7) => target().push({ text: text7, format: 0, raw: true });
   const noteComment = (layer, id) => {
@@ -105340,7 +105679,7 @@ function parseBody(xml, deadline, pictureMarkerFor, review) {
   const flushParagraph = () => {
     const text7 = renderSpans(paragraph2).replace(/\s+/g, " ").trim();
     const heading3 = paragraphHeading;
-    const plain = show && heading3 !== void 0 ? acceptedText(paragraph2) : void 0;
+    const plain = show2 && heading3 !== void 0 ? acceptedText(paragraph2) : void 0;
     paragraph2 = [];
     paragraphHeading = void 0;
     styleId = void 0;
@@ -105417,14 +105756,14 @@ function parseBody(xml, deadline, pictureMarkerFor, review) {
           if (review === void 0 || id === void 0 || review.replies.has(id)) break;
           rangedComments.add(id);
           noteComment(review, id);
-          if (show && openComments.size === 0 && paragraphDepth > 0) pushRaw(ANCHOR_OPEN);
+          if (show2 && openComments.size === 0 && paragraphDepth > 0) pushRaw(ANCHOR_OPEN);
           openComments.add(id);
           break;
         }
         case "w:commentRangeEnd": {
           const id = event.attributes["w:id"];
           if (id === void 0 || !openComments.delete(id)) break;
-          if (!show) break;
+          if (!show2) break;
           if (paragraphDepth > 0) {
             if (openComments.size === 0) pushRaw(ANCHOR_CLOSE);
             pushRaw(referenceSentinel(`c:${id}`));
@@ -105437,7 +105776,7 @@ function parseBody(xml, deadline, pictureMarkerFor, review) {
           const id = event.attributes["w:id"];
           if (review === void 0 || id === void 0 || review.replies.has(id) || rangedComments.has(id)) break;
           noteComment(review, id);
-          if (show) pushRaw(referenceSentinel(`c:${id}`));
+          if (show2) pushRaw(referenceSentinel(`c:${id}`));
           break;
         }
         case "w:tbl":
@@ -105468,7 +105807,7 @@ function parseBody(xml, deadline, pictureMarkerFor, review) {
             paragraph2 = [];
             paragraphHeading = void 0;
           }
-          if (show && openComments.size > 0) pushRaw(ANCHOR_OPEN);
+          if (show2 && openComments.size > 0) pushRaw(ANCHOR_OPEN);
           break;
         case "w:pStyle":
           styleId = event.attributes["w:val"];
@@ -105498,7 +105837,7 @@ function parseBody(xml, deadline, pictureMarkerFor, review) {
         case "w:t":
         case "w:delText": {
           const revision = effectiveRevision();
-          if (removes(revision) ? show : event.name === "w:t") {
+          if (removes(revision) ? show2 : event.name === "w:t") {
             textTarget = inCell ? "cell" : "paragraph";
             textRevision = revision;
           } else if (removes(revision)) {
@@ -105530,7 +105869,7 @@ function parseBody(xml, deadline, pictureMarkerFor, review) {
         case "w:br":
         case "w:cr": {
           const revision = effectiveRevision();
-          if (!removes(revision) || show) emit(" ", revision);
+          if (!removes(revision) || show2) emit(" ", revision);
           break;
         }
         default:
@@ -105597,7 +105936,7 @@ function parseBody(xml, deadline, pictureMarkerFor, review) {
         break;
       case "w:p":
         if (paragraphDepth > 0) paragraphDepth--;
-        if (show && openComments.size > 0) pushRaw(ANCHOR_CLOSE);
+        if (show2 && openComments.size > 0) pushRaw(ANCHOR_CLOSE);
         group = void 0;
         if (inCell) cell.push({ text: " ", format: 0 });
         else {
@@ -105612,7 +105951,7 @@ function parseBody(xml, deadline, pictureMarkerFor, review) {
         }
         break;
       case "w:tr":
-        if (tableDepth === 1 && !(rowDeleted && !show)) rows.push(row);
+        if (tableDepth === 1 && !(rowDeleted && !show2)) rows.push(row);
         if (tableDepth === 1 && rowRevision !== void 0) {
           revisions.splice(revisions.indexOf(rowRevision), 1);
           rowRevision = void 0;
@@ -105886,10 +106225,10 @@ async function extractDocx(bytes, options2 = {}) {
   if (documentXml === null) {
     throw new DocxError("unreadable", `This package has no ${DOCUMENT_PART}: it is not a Word document.`);
   }
-  const show = options2.review === true;
-  const comments = readComments(buffer, limits, show);
+  const show2 = options2.review === true;
+  const comments = readComments(buffer, limits, show2);
   const layer = {
-    show,
+    show: show2,
     replies: new Set([...comments.values()].filter((comment) => comment.parentId !== void 0).map((comment) => comment.id)),
     entries: /* @__PURE__ */ new Map()
   };
@@ -105904,15 +106243,15 @@ async function extractDocx(bytes, options2 = {}) {
   const blockCount = blocks.length;
   if (blockCount === 0) {
     return {
-      markdown: "_This document has no extractable body content._\n\n" + (show ? "> Headers, footers, footnotes and text boxes are not read by this tool." : "> Headers, footers, footnotes, comments and text boxes are not read by this tool."),
+      markdown: "_This document has no extractable body content._\n\n" + (show2 ? "> Headers, footers, footnotes and text boxes are not read by this tool." : "> Headers, footers, footnotes, comments and text boxes are not read by this tool."),
       blocks: [],
       blockCount: 0,
       pictures,
-      ...show ? { review: reviewCounts(layer) } : {}
+      ...show2 ? { review: reviewCounts(layer) } : {}
     };
   }
   const requested = options2.blocks ? parseBlockRange(options2.blocks, blockCount) : rangeTo(blockCount);
-  const labels = show ? numberReferences(blocks) : /* @__PURE__ */ new Map();
+  const labels = show2 ? numberReferences(blocks) : /* @__PURE__ */ new Map();
   const shown2 = [];
   const pieces = [];
   const covered = [];
@@ -105931,7 +106270,7 @@ async function extractDocx(bytes, options2 = {}) {
     }
     deadline();
     let rendered = renderBlock(blocks[number2 - 1], mode);
-    if (show) {
+    if (show2) {
       const resolved2 = resolveSentinels(rendered, labels);
       rendered = resolved2.text;
       for (const id of resolved2.references) if (!shown2.includes(id)) shown2.push(id);
@@ -105953,7 +106292,7 @@ async function extractDocx(bytes, options2 = {}) {
     );
   }
   const leads = [struckThroughNotice(pieces.join("\n\n")), reviewNotice(layer, shown2, labels)].filter((line) => line !== "");
-  const list3 = show && shown2.length > 0 ? [reviewList(shown2, layer, labels, headingPaths(blocks), comments)] : [];
+  const list3 = show2 && shown2.length > 0 ? [reviewList(shown2, layer, labels, headingPaths(blocks), comments)] : [];
   const markdown = [...leads, ...pieces, ...list3, ...notes].join("\n\n");
   if (full && markdown.length > ABSOLUTE_MAX_CHARS) {
     throw new DocxError(
@@ -105967,7 +106306,7 @@ async function extractDocx(bytes, options2 = {}) {
     ...nextBlock === void 0 ? {} : { nextBlock },
     blockCount,
     pictures,
-    ...show ? { review: reviewCounts(layer) } : {}
+    ...show2 ? { review: reviewCounts(layer) } : {}
   };
 }
 function readComments(buffer, limits, review) {
@@ -106379,10 +106718,10 @@ function commentsOf(annotations, pieces) {
   return { comments: top, count: count(top) };
 }
 function quoted(remark, indent2) {
-  const cut = remark.length > MAX_REMARK_CHARS;
-  const text7 = cut ? remark.slice(0, MAX_REMARK_CHARS) : remark;
+  const cut2 = remark.length > MAX_REMARK_CHARS;
+  const text7 = cut2 ? remark.slice(0, MAX_REMARK_CHARS) : remark;
   const lines = text7.split("\n").map((line) => line.trim() === "" ? `${indent2}>` : `${indent2}> ${line}`);
-  if (cut) lines.push(`${indent2}> _[remark cut at ${MAX_REMARK_CHARS} characters]_`);
+  if (cut2) lines.push(`${indent2}> _[remark cut at ${MAX_REMARK_CHARS} characters]_`);
   return lines;
 }
 function heading(comment) {
@@ -107940,11 +108279,11 @@ function serialToDate(serial, epoch1904) {
 function pad(value, width) {
   return String(value).padStart(width, "0");
 }
-function formatDateParts(parts, show) {
+function formatDateParts(parts, show2) {
   const date = `${pad(parts.year, 4)}-${pad(parts.month, 2)}-${pad(parts.day, 2)}`;
   const time = `${pad(parts.hours, 2)}:${pad(parts.minutes, 2)}:${pad(parts.seconds, 2)}`;
-  if (show.date && show.time) return `${date} ${time}`;
-  if (show.time) return time;
+  if (show2.date && show2.time) return `${date} ${time}`;
+  if (show2.time) return time;
   return date;
 }
 function generalNumber(value) {
@@ -108561,7 +108900,7 @@ var parameters = typebox_exports.Object({
   )
 });
 var DESCRIPTION = [
-  "Extract a spreadsheet (.xlsx) as markdown tables: one table per sheet, with the workbook's own column letters and row numbers so cells stay addressable.",
+  "Extract an Excel spreadsheet (.xlsx) as markdown tables: one table per sheet, with the workbook's own column letters and row numbers so cells stay addressable.",
   "If the user wants the workbook saved, converted, or written anywhere, pass output_path: it writes every visible sheet there in one call and returns a short summary.",
   "Do not return the content and then write it yourself \u2014 that spends the context twice.",
   "Without sheet, every visible sheet is read in workbook order; hidden sheets and hidden columns are not read and are reported.",
@@ -111193,22 +111532,22 @@ function createMailExtractToolDefinition(options2) {
           `This message's body is ${message.body?.markdown.length} characters, past the ${ABSOLUTE_MAX_BODY_CHARS}-character ceiling for one call. Pass output_path to write it to a file instead.`
         );
       }
-      const answer2 = assembleAnswer(message, unpacked, {
+      const answer3 = assembleAnswer(message, unpacked, {
         maxBodyChars: wholeMessage ? ABSOLUTE_MAX_BODY_CHARS : MAX_BODY_CHARS
       });
       if (destination === void 0) {
-        const text7 = answer2.text.length > LARGE_ANSWER_CHARS3 ? `${answer2.text}
+        const text7 = answer3.text.length > LARGE_ANSWER_CHARS3 ? `${answer3.text}
 
-> This answer is ${answer2.text.length} characters. For a message this size, pass output_path next time to write it to a file instead.` : answer2.text;
+> This answer is ${answer3.text.length} characters. For a message this size, pass output_path next time to write it to a file instead.` : answer3.text;
         return { content: [{ type: "text", text: text7 }], details: void 0 };
       }
-      const file = await writeExtraction(destination, answer2.text, {
+      const file = await writeExtraction(destination, answer3.text, {
         cwd: options2.cwd,
         writableRoot: options2.writableRoot
       });
       const summary = extractionSummary(file, {
-        covered: `the whole message (${answer2.bodyChars} characters of body, ${message.attachments.length} attachment${message.attachments.length === 1 ? "" : "s"})`,
-        excerpt: excerptOf(answer2.text)
+        covered: `the whole message (${answer3.bodyChars} characters of body, ${message.attachments.length} attachment${message.attachments.length === 1 ? "" : "s"})`,
+        excerpt: excerptOf(answer3.text)
       });
       const unpackedText = describeUnpacked(unpacked);
       return {
@@ -125115,7 +125454,7 @@ var textOfRunContent = (element) => {
       return "";
   }
 };
-var textOf = (paragraph2) => {
+var textOf2 = (paragraph2) => {
   const fields = [];
   const read = (element) => {
     const name = nameOf$3(element);
@@ -125163,7 +125502,7 @@ var paragraphDetailsOf = (paragraphs, followBookmarks) => {
       element,
       styleId: attributeOf(childOf(properties, "w:pStyle"), "w:val"),
       outlineLevel: numberAttributeOf(childOf(properties, "w:outlineLvl"), "w:val"),
-      text: textOf(element),
+      text: textOf2(element),
       bookmarks: (_bookmarks$index = bookmarks[index4]) !== null && _bookmarks$index !== void 0 ? _bookmarks$index : /* @__PURE__ */ new Set()
     };
   });
@@ -164595,11 +164934,11 @@ var SECTION_ORDER = [
   "printerSettings",
   "sectPrChange"
 ];
-function textOf2(xml) {
+function textOf3(xml) {
   return [...xml.matchAll(/<w:t(?:\s[^>]*)?>([^<]*)<\/w:t>/g)].map((match) => match[1]).join("
");
 }
 function assertTextUnchanged(part, before, after) {
-  if (textOf2(before) !== textOf2(after)) throw new WordTemplateError(`restyling would have changed the text of ${part}; nothing was written`);
+  if (textOf3(before) !== textOf3(after)) throw new WordTemplateError(`restyling would have changed the text of ${part}; nothing was written`);
 }
 function mathSpans(xml) {
   return [...xml.matchAll(/<m:oMath\b[\s\S]*?<\/m:oMath>/g)].map((match) => [match.index, match.index + match[0].length]);
@@ -165852,7 +166191,7 @@ function layoutTimeline(data, today, options2 = {}) {
     else years.push({ label: String(segment4.year), x: band.x, width: band.width });
   });
   const unit = timelineHeaderUnit(px, options2.unit);
-  const cut = (starts, label) => starts.map((day, index4) => {
+  const cut2 = (starts, label) => starts.map((day, index4) => {
     const next = index4 + 1 < starts.length ? starts[index4 + 1] : end + 1;
     return { label: label(day), x: xOf(day), width: (next - day) * px };
   });
@@ -165861,7 +166200,7 @@ function layoutTimeline(data, today, options2 = {}) {
   if (unit === "week") {
     const mondays = [];
     for (let day = start - weekday(start) + 7; day <= end; day += 7) mondays.push(day);
-    lower = cut([start, ...mondays], (day) => `W${isoWeek(day)}`);
+    lower = cut2([start, ...mondays], (day) => `W${isoWeek(day)}`);
     upper = months.map((month) => ({ label: `${month.label} ${month.year}`, x: month.x, width: month.width }));
   } else if (unit === "quarter") {
     const quarterStarts = segments.filter((segment4, index4) => index4 === 0 || segment4.month % 3 === 0);
@@ -169364,14 +169703,14 @@ function roundedPath(points, radius) {
     if (toPrevious === 0 || toNext === 0) continue;
     const turn = ((corner.x - previous4.x) * (next.y - corner.y) - (corner.y - previous4.y) * (next.x - corner.x)) / (toPrevious * toNext);
     if (Math.abs(turn) < 0.02) continue;
-    const cut = Math.min(radius, toPrevious / 2, toNext / 2);
+    const cut2 = Math.min(radius, toPrevious / 2, toNext / 2);
     const entry = {
-      x: corner.x - (corner.x - previous4.x) / toPrevious * cut,
-      y: corner.y - (corner.y - previous4.y) / toPrevious * cut
+      x: corner.x - (corner.x - previous4.x) / toPrevious * cut2,
+      y: corner.y - (corner.y - previous4.y) / toPrevious * cut2
     };
     const exit3 = {
-      x: corner.x + (next.x - corner.x) / toNext * cut,
-      y: corner.y + (next.y - corner.y) / toNext * cut
+      x: corner.x + (next.x - corner.x) / toNext * cut2,
+      y: corner.y + (next.y - corner.y) / toNext * cut2
     };
     parts.push(`L ${entry.x} ${entry.y}`, `Q ${corner.x} ${corner.y} ${exit3.x} ${exit3.y}`);
   }
@@ -177996,130 +178335,6 @@ var checkStructuredExchangeSchema = (document4) => {
   return [...misplacedEnvelopeIssues(document4), ...issues.sort((left, right) => right.path.split("/").length - left.path.split("/").length)];
 };
 
-// ../shared/src/structuredExchangeProfile.ts
-var STRUCTURED_EXCHANGE_PROFILE_REGISTRY_SCHEMA_V2 = "urn:structured-exchange-profile-registry:2";
-var STRUCTURED_EXCHANGE_PROFILE_REGISTRY_PATH = ".pi-outpost/structured-exchange.json";
-var STRUCTURED_EXCHANGE_CONFORMITY_REPORT_PROFILE = "urn:structured-exchange-conformity-report:1";
-var STRUCTURED_EXCHANGE_RULES_REGISTER_PROFILE = "urn:structured-exchange-rules-register:1";
-var STRUCTURED_EXCHANGE_RULE_PATTERNS_PROFILE = "urn:structured-exchange-rule-patterns:1";
-var RESERVED_PROFILE_IDENTIFIERS = /* @__PURE__ */ new Set([
-  STRUCTURED_EXCHANGE_CONFORMITY_REPORT_PROFILE,
-  STRUCTURED_EXCHANGE_RULES_REGISTER_PROFILE,
-  STRUCTURED_EXCHANGE_RULE_PATTERNS_PROFILE
-]);
-var STRUCTURED_EXCHANGE_PROFILE_CEILINGS = {
-  /** A profile's identifier, bounded like the `profile` a document names it by. */
-  id: 200,
-  label: 500,
-  description: 2e3,
-  /** Kinds per vocabulary, as a document's `kindsPerVocabulary`. */
-  kindsPerVocabulary: 64,
-  /** Attributes one kind declares, as a document's `attributesPerItem`. */
-  attributesPerKind: 50,
-  attributeName: 200,
-  /**
-   * Values one enumeration lists. Generous: a requirements tool's enumerations
-   * include long ones — components, suppliers — and a profile that cannot hold its
-   * model's is a profile nobody can finish.
-   */
-  enumerationValues: 500,
-  /** One enumeration value, as a document's `attributeString`. */
-  enumerationValue: 1e3,
-  viewpoints: 20,
-  /** Profiles one registry lists. */
-  profilesPerRegistry: 20,
-  profilePath: 500,
-  /** Bytes read from a profile file before it is parsed. */
-  profileBytes: 1048576,
-  /** Bytes read from a registry file before it is parsed. */
-  registryBytes: 65536
-};
-function profileListing(profile) {
-  const lines = [`Profile ${profile.id} \u2014 ${profile.label}`];
-  if (profile.description !== void 0) lines.push(profile.description);
-  const vocabulary = (heading3, kinds, relationships) => {
-    const declared = kinds ?? [];
-    lines.push("", `${heading3}: ${declared.length}`);
-    for (const declaration of declared) {
-      lines.push(`  ${declaration.kind}`);
-      if (declaration.description !== void 0) lines.push(`    ${declaration.description}`);
-      if (relationships) {
-        lines.push(`    source: ${declaration.from?.join(", ") ?? "any element kind"}`);
-        lines.push(`    target: ${declaration.to?.join(", ") ?? "any element kind"}`);
-      }
-      const attributes2 = declaration.attributes ?? [];
-      if (attributes2.length === 0) lines.push("    (no attributes)");
-      for (const attribute of attributes2) {
-        const traits = [
-          attribute.list === true ? `list of ${attribute.type}` : attribute.type,
-          ...attribute.type === "enumeration" ? [attribute.closed === true ? "closed" : "open"] : [],
-          attribute.required === true ? "required" : "optional"
-        ];
-        const count = attribute.type === "enumeration" ? ` \u2014 ${(attribute.values ?? []).length} values` : "";
-        lines.push(`    ${attribute.name}: ${traits.join(", ")}${count}`);
-        if (attribute.description !== void 0) lines.push(`      ${attribute.description}`);
-        for (const value of attribute.values ?? []) lines.push(`      - ${value}`);
-      }
-    }
-  };
-  vocabulary("Element kinds (graph elements and table rows)", profile.elementKinds, false);
-  vocabulary("Relationship kinds (graph relationships and table relations)", profile.relationshipKinds, true);
-  const viewpoints = profile.viewpoints ?? [];
-  lines.push("", `Viewpoints: ${viewpoints.length}`);
-  for (const viewpoint of viewpoints) {
-    lines.push(`  ${viewpoint.id} \u2014 ${viewpoint.label}: ${viewpoint.concern}`);
-    if (viewpoint.elementKinds !== void 0) lines.push(`    element kinds: ${viewpoint.elementKinds.join(", ")}`);
-    if (viewpoint.relationshipKinds !== void 0) lines.push(`    relationship kinds: ${viewpoint.relationshipKinds.join(", ")}`);
-  }
-  return `${lines.join("\n")}
-`;
-}
-function describeConditions(set) {
-  return Object.entries(set ?? {}).map(([name, values]) => `${name} \u2208 {${values.map((value) => JSON.stringify(value)).join(", ")}}`).join(" and ") || "always";
-}
-function describeLinkConditions(set) {
-  const parts = [
-    set?.from === void 0 ? void 0 : `source ${describeConditions(set.from)}`,
-    set?.to === void 0 ? void 0 : `target ${describeConditions(set.to)}`
-  ].filter((part) => part !== void 0);
-  return parts.length === 0 ? "always" : parts.join(" and ");
-}
-function rulesListing(profileId, rules) {
-  const conditions = describeConditions;
-  const ends = describeLinkConditions;
-  const lines = [`Rules for ${profileId}: ${rules.length}`];
-  for (const rule of rules) {
-    lines.push("", `  ${rule.id} \u2014 ${rule.level}${rule.source === void 0 ? "" : ` \u2014 ${rule.source}`}`, `    ${rule.statement}`);
-    if (rule.element !== void 0) {
-      lines.push(`    applies to: element ${rule.element}`, `    when: ${conditions(rule.when)}`);
-      lines.push(`    then: ${rule.then === "forbidden" ? "forbidden" : conditions(rule.then)}`);
-    } else {
-      lines.push(`    applies to: relationship ${rule.relationship}`, `    when: ${ends(rule.when)}`);
-      lines.push(`    then: ${rule.then === "forbidden" ? "forbidden" : ends(rule.then)}`);
-    }
-  }
-  return `${lines.join("\n")}
-`;
-}
-var STRUCTURED_EXCHANGE_RULES_CEILINGS = {
-  rulesPerFile: 200,
-  ruleId: 200,
-  statement: 2e3,
-  source: 500,
-  /** Conditions in one set — `when`, `then`, or one end of a link. */
-  conditionsPerSet: 20,
-  /** Values one condition allows, as `enumerationValues`. */
-  valuesPerCondition: 500,
-  /** One value, as `enumerationValue`. */
-  value: 1e3,
-  attributeName: 200,
-  kind: 100,
-  /** Rules files one registry lists. */
-  rulesFilesPerRegistry: 20,
-  /** Bytes read from a rules file before it is parsed. */
-  rulesBytes: 1048576
-};
-
 // ../shared/src/structuredExchangeDocumentItems.ts
 function effective(raw, path25) {
   const set = raw.set ?? void 0;
@@ -181620,7 +181835,7 @@ var DESCRIPTION10 = [
   "Reading a poster shows each picture the user put in as a marker, poster-picture:N, and neither the marker nor its frame's name tells you what the picture shows.",
   "Call this before describing, captioning, choosing or moving a picture: it answers each picture as an image after its marker."
 ].join(" ");
-var answer = (content3, isError = false) => ({ content: content3, details: void 0, ...isError ? { isError: true } : {} });
+var answer2 = (content3, isError = false) => ({ content: content3, details: void 0, ...isError ? { isError: true } : {} });
 function createPosterPicturesToolDefinition(options2) {
   return {
     name: "poster_pictures",
@@ -181633,25 +181848,25 @@ function createPosterPicturesToolDefinition(options2) {
     parameters: parameters10,
     async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
       const { path: target, pictures: wanted } = params;
-      if (!target.toLowerCase().endsWith(POSTER_SUFFIX)) return answer([{ type: "text", text: `"${target}" is not a poster: give a ${POSTER_SUFFIX} file.` }], true);
+      if (!target.toLowerCase().endsWith(POSTER_SUFFIX)) return answer2([{ type: "text", text: `"${target}" is not a poster: give a ${POSTER_SUFFIX} file.` }], true);
       const resolved2 = await realResolve(path19.resolve(options2.cwd, target));
       if (!isWithinAny(options2.allowedRoots, resolved2)) {
         throw new Error(`Access denied: "${target}" is outside the sandbox (${options2.allowedRoots[0]})`);
       }
       const stat = await fs15.stat(resolved2).catch(() => null);
-      if (stat === null || !stat.isFile()) return answer([{ type: "text", text: `No such file: ${target}` }], true);
-      if (stat.size > MAX_POSTER_BYTES + 64 * 1024) return answer([{ type: "text", text: `"${target}" is larger than a poster may be.` }], true);
+      if (stat === null || !stat.isFile()) return answer2([{ type: "text", text: `No such file: ${target}` }], true);
+      if (stat.size > MAX_POSTER_BYTES + 64 * 1024) return answer2([{ type: "text", text: `"${target}" is larger than a poster may be.` }], true);
       const text7 = await fs15.readFile(resolved2, "utf8");
       try {
         readPage(text7);
       } catch (error) {
-        if (error instanceof PosterRefusal) return answer([{ type: "text", text: `"${target}" cannot be looked at: ${error.message}. Run poster_check on it.` }], true);
+        if (error instanceof PosterRefusal) return answer2([{ type: "text", text: `"${target}" cannot be looked at: ${error.message}. Run poster_check on it.` }], true);
         throw error;
       }
       const { pictures } = hidePictures(text7, "");
-      if (pictures.length === 0) return answer([{ type: "text", text: `"${target}" holds no picture: its frames, if any, are empty.` }]);
+      if (pictures.length === 0) return answer2([{ type: "text", text: `"${target}" holds no picture: its frames, if any, are empty.` }]);
       if (ctx?.model && !ctx.model.input.includes("image")) {
-        return answer([{ type: "text", text: `"${target}" holds ${pictures.length} picture(s), but the model in use (${ctx.model.id}) does not take images, so they cannot be shown. Do not guess what they show from their frames' names; ask the user.` }], true);
+        return answer2([{ type: "text", text: `"${target}" holds ${pictures.length} picture(s), but the model in use (${ctx.model.id}) does not take images, so they cannot be shown. Do not guess what they show from their frames' names; ask the user.` }], true);
       }
       const numbers2 = (wanted?.length ? wanted : pictures.map((_picture, index4) => index4 + 1)).slice(0, MAX_SEEN_PICTURES);
       const content3 = [{ type: "text", text: `"${target}" holds ${pictures.length} picture(s); shown here: ${numbers2.map((n) => `poster-picture:${n}`).join(", ")}.` }];
@@ -181670,7 +181885,7 @@ function createPosterPicturesToolDefinition(options2) {
       }
       const unseen = (wanted?.length ? wanted.length : pictures.length) - numbers2.length;
       if (unseen > 0) content3.push({ type: "text", text: `${unseen} more picture(s) not shown: ask for them by number.` });
-      return answer(content3);
+      return answer2(content3);
     }
   };
 }
@@ -181947,7 +182162,7 @@ var parameters12 = typebox_exports.Object({
   images: imagesParameter
 });
 var DESCRIPTION12 = [
-  "Extract a Word (.docx) document as markdown: paragraphs, headings, and tables with the rows and columns the document declares.",
+  "Read a Word document (.docx): extract its text, headings and tables as Markdown, preserving the rows and columns the Word document declares.",
   "If the user wants the document saved, converted, or written anywhere, pass output_path: it writes the whole document there in one call and returns a short summary.",
   "Do not return the content and then write it yourself \u2014 that spends the context twice.",
   "Otherwise output is capped per call \u2014 when it is truncated it says so and names the block range to ask for next, or pass full:true to get everything at once.",
@@ -182935,8 +183150,14 @@ async function createPiOutpostTools(settings2) {
 }
 async function piOutpostTools_default(pi) {
   const tools = await createPiOutpostTools(parseToolsSettings(process.env[TOOLS_ENV_VAR]));
-  for (const tool of tools) pi.registerTool(tool);
+  for (const tool of deferOnDemandTools(tools)) pi.registerTool(tool);
+  pi.on("session_start", () => {
+    const active = pi.getActiveTools();
+    if (active.includes(TOOL_SEARCH_TOOL) || !pi.getAllTools().some((tool) => tool.name === TOOL_SEARCH_TOOL)) return;
+    pi.setActiveTools([...active, TOOL_SEARCH_TOOL]);
+  });
   registerPosterPictureHooks(pi);
+  createBtwExtension()(pi);
 }
 export {
   TOOLS_ENV_VAR,