autohand-cli 0.8.2 → 0.9.0

package/dist/{chunk-5P2NXKP3.js → chunk-UEIXJG45.js}

@@ -1,43 +1,65 @@
 import {
-  installMetadata as installMetadata2,
+  metadata as metadata45
+} from "./chunk-ZR46OJNZ.js";
+import {
+  metadata as metadata46
+} from "./chunk-5JTTM5SC.js";
+import {
+  metadata as metadata47
+} from "./chunk-2H5O745H.js";
+import {
+  metadata as metadata48
+} from "./chunk-XV2HXRHX.js";
+import {
+  metadata as metadata49
+} from "./chunk-ES2HJQ4N.js";
+import {
+  metadata as metadata50
+} from "./chunk-6R25D2H5.js";
+import {
+  aliasMetadata,
+  metadata as metadata51
+} from "./chunk-BFQDQRDE.js";
+import {
   metadata as metadata40
-} from "./chunk-6RF7UKUS.js";
+} from "./chunk-HBXAA3XB.js";
 import {
   metadata as metadata41
-} from "./chunk-HBXAA3XB.js";
+} from "./chunk-3OEDGIFW.js";
 import {
   metadata as metadata42
-} from "./chunk-3OEDGIFW.js";
+} from "./chunk-WNUVPKBW.js";
 import {
   metadata as metadata43
-} from "./chunk-WNUVPKBW.js";
+} from "./chunk-FQAVGSPW.js";
 import {
   metadata as metadata44
-} from "./chunk-DSPQEHDT.js";
+} from "./chunk-JMN3GZU6.js";
 import {
   metadata as metadata32
-} from "./chunk-OOKY3HPZ.js";
+} from "./chunk-AT7OWLY5.js";
 import {
   metadata as metadata33
-} from "./chunk-CWMZKFTT.js";
+} from "./chunk-VRMZO6TB.js";
 import {
   metadata as metadata34
-} from "./chunk-CAMZTXV6.js";
+} from "./chunk-U4C3HW6P.js";
 import {
   metadata as metadata35
-} from "./chunk-TNZRZQ7Q.js";
+} from "./chunk-M4KNC5BQ.js";
 import {
   metadata as metadata36
-} from "./chunk-SCXX4LW5.js";
+} from "./chunk-I24CWKKK.js";
 import {
   metadata as metadata37
-} from "./chunk-4PKF7WPD.js";
+} from "./chunk-HXJEGMGB.js";
 import {
   metadata as metadata38
-} from "./chunk-JCLYQ2JC.js";
+} from "./chunk-OHWMWKJQ.js";
 import {
+  installMetadata as installMetadata2,
   metadata as metadata39
-} from "./chunk-AYS2ASM7.js";
+} from "./chunk-HKYZSUQ5.js";
 import {
   installMetadata,
   metadata as metadata28,
@@ -45,126 +67,125 @@ import {
   searchMetadata,
   trendingMetadata,
   useMetadata
-} from "./chunk-HLQV64Y5.js";
+} from "./chunk-7RFJB75Y.js";
 import {
   metadata as metadata29
-} from "./chunk-WHE2SWHU.js";
+} from "./chunk-6NVAK6CK.js";
 import {
   metadata as metadata30
-} from "./chunk-QOXPOR5D.js";
+} from "./chunk-OV3PVUYN.js";
 import {
   metadata as metadata31
-} from "./chunk-AYSFIUFW.js";
+} from "./chunk-FGT6KK6T.js";
+import {
+  metadata as metadata20
+} from "./chunk-YV63VW4K.js";
+import {
+  metadata as metadata21
+} from "./chunk-24QIWILL.js";
+import {
+  metadata as metadata22
+} from "./chunk-2NUX2RAI.js";
+import {
+  metadata as metadata23
+} from "./chunk-JYKPWK5O.js";
 import {
   metadata as metadata24
-} from "./chunk-H5SWOLG6.js";
+} from "./chunk-PQLKJCIE.js";
 import {
   metadata as metadata25
-} from "./chunk-72FKPBT5.js";
+} from "./chunk-VDWJMWDF.js";
 import {
   metadata as metadata26
-} from "./chunk-LWUJFGOZ.js";
+} from "./chunk-QQ7PANOP.js";
 import {
   metadata as metadata27
-} from "./chunk-HIVRCQS2.js";
+} from "./chunk-L4F7SUYL.js";
+import {
+  metadata as metadata13
+} from "./chunk-QCHIDZBA.js";
+import {
+  metadata as metadata14
+} from "./chunk-SVLBJMYO.js";
+import {
+  metadata as metadata15
+} from "./chunk-B5CGDNMR.js";
 import {
   metadata as metadata16
-} from "./chunk-G4CAKI3V.js";
+} from "./chunk-A7HHCIDQ.js";
 import {
   metadata as metadata17
-} from "./chunk-J4Q7XR3G.js";
+} from "./chunk-CFFE4VA3.js";
 import {
   metadata as metadata18
-} from "./chunk-QNGEW5TC.js";
+} from "./chunk-OM24WXEE.js";
 import {
   metadata as metadata19
-} from "./chunk-24QIWILL.js";
-import {
-  metadata as metadata20
-} from "./chunk-2NUX2RAI.js";
+} from "./chunk-7HPWMALN.js";
 import {
-  metadata as metadata21
-} from "./chunk-SKV2F3NM.js";
+  metadata as metadata7
+} from "./chunk-WZV6UVPY.js";
 import {
-  metadata as metadata22
-} from "./chunk-KPELYZ6L.js";
+  metadata as metadata8
+} from "./chunk-TSV4LVHK.js";
 import {
-  metadata as metadata23
-} from "./chunk-JX3DFKBI.js";
+  metadata as metadata9
+} from "./chunk-VKBIE6I6.js";
 import {
   metadata as metadata10
-} from "./chunk-SVLBJMYO.js";
+} from "./chunk-GZ6DV2UG.js";
 import {
   metadata as metadata11
-} from "./chunk-EGMZDTSL.js";
+} from "./chunk-GWO66KBI.js";
 import {
   metadata as metadata12
-} from "./chunk-FKSDEWDH.js";
+} from "./chunk-ACDQGA4Z.js";
 import {
-  metadata as metadata13
-} from "./chunk-X2MSVKDV.js";
-import {
-  metadata as metadata14
-} from "./chunk-G27PQQFD.js";
+  metadata as metadata6
+} from "./chunk-LUMV3DB2.js";
 import {
-  metadata as metadata15
-} from "./chunk-N23UAW4I.js";
+  metadata
+} from "./chunk-TBOLJDUG.js";
 import {
   metadata as metadata2
-} from "./chunk-NDMIPTV4.js";
+} from "./chunk-E46DJH5S.js";
 import {
   metadata as metadata3
-} from "./chunk-TSV4LVHK.js";
+} from "./chunk-Y3M2DABP.js";
 import {
   metadata as metadata4
-} from "./chunk-33RSHBDH.js";
+} from "./chunk-EZJHLOWP.js";
 import {
   metadata as metadata5
-} from "./chunk-YGN4CQIP.js";
-import {
-  metadata as metadata6
-} from "./chunk-MYISNQH4.js";
-import {
-  aliasMetadata,
-  metadata as metadata7
-} from "./chunk-34M3HWLR.js";
-import {
-  metadata as metadata8
-} from "./chunk-XX2ZO7DS.js";
-import {
-  metadata as metadata9
-} from "./chunk-XRZEUWKF.js";
-import {
-  metadata
-} from "./chunk-NCC6ETZS.js";
+} from "./chunk-SWCQM52V.js";
 
 // src/core/slashCommands.ts
 var SLASH_COMMANDS = [
-  metadata6,
-  metadata2,
-  metadata3,
-  metadata4,
-  metadata5,
+  metadata11,
   metadata7,
-  aliasMetadata,
   metadata8,
   metadata9,
   metadata10,
-  metadata11,
-  metadata13,
+  metadata51,
+  aliasMetadata,
   metadata12,
+  metadata13,
   metadata14,
   metadata15,
   metadata16,
+  metadata5,
   metadata17,
   metadata18,
   metadata19,
+  metadata2,
   metadata20,
   metadata21,
   metadata22,
   metadata23,
   metadata24,
   metadata25,
+  metadata,
+  metadata3,
   metadata26,
   metadata27,
   metadata28,
@@ -181,16 +202,23 @@ var SLASH_COMMANDS = [
   metadata34,
   metadata35,
   metadata36,
-  metadata,
+  metadata6,
+  metadata4,
   metadata37,
   metadata38,
   metadata39,
-  metadata40,
   installMetadata2,
+  metadata40,
   metadata41,
   metadata42,
   metadata43,
-  metadata44
+  metadata44,
+  metadata45,
+  metadata46,
+  metadata47,
+  metadata48,
+  metadata49,
+  metadata50
 ].filter((cmd) => cmd != null && typeof cmd.command === "string");
 
 export {

package/dist/{chunk-22D2CNTP.cjs → chunk-UGFVM77J.cjs}

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunkSEKD5FH3cjs = require('./chunk-SEKD5FH3.cjs');
+var _chunkE26KKI46cjs = require('./chunk-E26KKI46.cjs');
 
 // src/skills/CommunitySkillsCache.ts
 var _fsextra = require('fs-extra'); var _fsextra2 = _interopRequireDefault(_fsextra);
@@ -8,8 +8,11 @@ var _path = require('path'); var _path2 = _interopRequireDefault(_path);
 var DEFAULT_TTL_MS = 24 * 60 * 60 * 1e3;
 var DEFAULT_MAX_SKILLS_CACHE = 50;
 var CommunitySkillsCache = class {
+  
+  
+  
   constructor(config = {}) {
-    this.cacheDir = config.cacheDir || _path2.default.join(_chunkSEKD5FH3cjs.AUTOHAND_HOME, "community-skills", "cache");
+    this.cacheDir = config.cacheDir || _path2.default.join(_chunkE26KKI46cjs.AUTOHAND_HOME, "community-skills", "cache");
     this.ttlMs = _nullishCoalesce(config.ttlMs, () => ( DEFAULT_TTL_MS));
     this.maxSkillsCache = _nullishCoalesce(config.maxSkillsCache, () => ( DEFAULT_MAX_SKILLS_CACHE));
   }

package/dist/chunk-UOQECODR.js

@@ -0,0 +1,34 @@
+// src/utils/ripgrep.ts
+import fs from "fs";
+import path from "path";
+function getExecutableName() {
+  return process.platform === "win32" ? "rg.exe" : "rg";
+}
+function getBundledRipgrepPath() {
+  const executableName = getExecutableName();
+  const candidates = [
+    path.join(path.dirname(process.execPath), executableName)
+  ];
+  for (const candidate of candidates) {
+    try {
+      if (fs.existsSync(candidate)) {
+        return candidate;
+      }
+    } catch {
+    }
+  }
+  return null;
+}
+function resolveRipgrepCommand() {
+  return getBundledRipgrepPath() ?? "rg";
+}
+
+export {
+  getBundledRipgrepPath,
+  resolveRipgrepCommand
+};
+/**
+ * @license
+ * Copyright 2025 Autohand AI LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */

package/dist/chunk-UR27UDTB.js

@@ -0,0 +1,354 @@
+// src/core/context/priority.ts
+function extractMessageMetadata(message) {
+  const content = message.content ?? "";
+  const metadata = {};
+  const filePatterns = [
+    /(?:^|\s)([\/\w.-]+\.[a-zA-Z]{1,5})(?:\s|$|:|\()/gm,
+    /`([^`]+\.[a-zA-Z]{1,5})`/g,
+    /["']([^"']+\.[a-zA-Z]{1,5})["']/g
+  ];
+  const files = /* @__PURE__ */ new Set();
+  for (const pattern of filePatterns) {
+    let match;
+    while ((match = pattern.exec(content)) !== null) {
+      const file = match[1];
+      if (file && !file.startsWith("http") && !file.includes("://")) {
+        files.add(file);
+      }
+    }
+  }
+  if (files.size > 0) {
+    metadata.files = [...files];
+  }
+  if (message.name) {
+    metadata.tools = [message.name];
+  }
+  if (message.tool_calls && message.tool_calls.length > 0) {
+    metadata.tools = message.tool_calls.map((tc) => tc.function.name);
+  }
+  const decisionPatterns = [
+    /I('ll| will|'m going to| chose| decided| picked| selected)/i,
+    /let's (use|go with|implement|create)/i,
+    /we should (use|implement|create|add)/i,
+    /the (best|better|recommended) (approach|option|choice)/i
+  ];
+  metadata.isDecision = decisionPatterns.some((p) => p.test(content));
+  const errorPatterns = [
+    /error:|failed:|exception:|crash|bug|issue:|problem:/i,
+    /TypeError|SyntaxError|ReferenceError|Error:/,
+    /❌|✗|FAIL|FAILED/
+  ];
+  metadata.isError = errorPatterns.some((p) => p.test(content));
+  return metadata;
+}
+function determineMessagePriority(message) {
+  const content = message.content ?? "";
+  const metadata = message.metadata ?? extractMessageMetadata(message);
+  if (message.role === "system") {
+    return "critical";
+  }
+  if (message.role === "user") {
+    if (metadata.isDecision) return "critical";
+    if (content.length < 100) return "high";
+    return "high";
+  }
+  if (metadata.isError) {
+    return "high";
+  }
+  if (message.role === "tool" && metadata.files && metadata.files.length > 0) {
+    return "medium";
+  }
+  if (message.role === "tool" && content.length > 2e3) {
+    return "low";
+  }
+  if (message.role === "assistant" && metadata.isDecision) {
+    return "high";
+  }
+  return "medium";
+}
+function sortMessagesByPriority(messages) {
+  const priorityOrder = {
+    "low": 0,
+    "medium": 1,
+    "high": 2,
+    "critical": 3
+  };
+  const indices = messages.map((msg, i) => ({
+    index: i,
+    priority: msg.priority ?? determineMessagePriority(msg),
+    age: i
+  }));
+  indices.sort((a, b) => {
+    const priorityDiff = priorityOrder[a.priority] - priorityOrder[b.priority];
+    if (priorityDiff !== 0) return priorityDiff;
+    return a.age - b.age;
+  });
+  return indices.map((i) => i.index);
+}
+function findCoherentRemovalIndices(messages, targetIndices) {
+  const toRemove = new Set(targetIndices);
+  for (const idx of [...toRemove]) {
+    const msg = messages[idx];
+    if (msg.role === "tool" && msg.tool_call_id) {
+      const assistantIdx = messages.findIndex(
+        (m) => m.role === "assistant" && m.tool_calls?.some((tc) => tc.id === msg.tool_call_id)
+      );
+      if (assistantIdx >= 0) toRemove.add(assistantIdx);
+    }
+  }
+  for (const idx of [...toRemove]) {
+    const msg = messages[idx];
+    if (msg.role === "assistant" && msg.tool_calls) {
+      for (const tc of msg.tool_calls) {
+        const toolIdx = messages.findIndex(
+          (m) => m.role === "tool" && m.tool_call_id === tc.id
+        );
+        if (toolIdx >= 0) toRemove.add(toolIdx);
+      }
+    }
+  }
+  return [...toRemove].sort((a, b) => a - b);
+}
+
+// src/core/context/serializer.ts
+var TOOL_RESULT_MAX_LENGTH = 2e3;
+function serializeMessagesForSummary(messages) {
+  const lines = [];
+  for (const msg of messages) {
+    switch (msg.role) {
+      case "system":
+        break;
+      case "user":
+        lines.push(`[User]: ${msg.content ?? ""}`);
+        break;
+      case "assistant": {
+        const content = msg.content ?? "";
+        if (msg.tool_calls && msg.tool_calls.length > 0) {
+          const callDescriptions = msg.tool_calls.map((tc) => {
+            const args = tc.function.arguments ?? "{}";
+            let shortArgs = args;
+            try {
+              const parsed = JSON.parse(args);
+              const keys = Object.keys(parsed);
+              const preview = keys.slice(0, 3).map((k) => `${k}="${String(parsed[k]).slice(0, 80)}"`).join(", ");
+              shortArgs = keys.length > 3 ? `${preview}, +${keys.length - 3} more` : preview;
+            } catch {
+              shortArgs = args.slice(0, 100);
+            }
+            return `${tc.function.name}(${shortArgs})`;
+          }).join("; ");
+          if (content) {
+            lines.push(`[Assistant]: ${content.slice(0, 500)}`);
+          }
+          lines.push(`[Assistant tool calls]: ${callDescriptions}`);
+        } else {
+          lines.push(`[Assistant]: ${content.slice(0, 500)}`);
+        }
+        break;
+      }
+      case "tool": {
+        const toolName = msg.name ?? "unknown";
+        const rawContent = msg.content ?? "";
+        const truncated = rawContent.length > TOOL_RESULT_MAX_LENGTH ? rawContent.slice(0, Math.floor(TOOL_RESULT_MAX_LENGTH * 0.6)) + `
+... [${rawContent.length - TOOL_RESULT_MAX_LENGTH} chars truncated] ...
+` + rawContent.slice(-Math.floor(TOOL_RESULT_MAX_LENGTH * 0.3)) : rawContent;
+        lines.push(`[Tool result (${toolName})]: ${truncated}`);
+        break;
+      }
+    }
+  }
+  return lines.join("\n");
+}
+
+// src/core/context/summarizer.ts
+function summarizeMessagesStatic(messages) {
+  const files = /* @__PURE__ */ new Set();
+  const tools = /* @__PURE__ */ new Set();
+  const decisions = [];
+  const errors = [];
+  const userRequests = [];
+  for (const msg of messages) {
+    const metadata = msg.metadata ?? extractMessageMetadata(msg);
+    if (metadata.files) {
+      metadata.files.forEach((f) => files.add(f));
+    }
+    if (metadata.tools) {
+      metadata.tools.forEach((t) => tools.add(t));
+    }
+    if (msg.role === "user") {
+      const preview = (msg.content ?? "").slice(0, 100);
+      userRequests.push(preview + (preview.length < (msg.content?.length ?? 0) ? "..." : ""));
+    }
+    if (metadata.isDecision && msg.role === "assistant") {
+      const preview = (msg.content ?? "").slice(0, 150);
+      decisions.push(preview);
+    }
+    if (metadata.isError) {
+      const preview = (msg.content ?? "").slice(0, 150);
+      errors.push(preview);
+    }
+  }
+  const parts = [
+    `[Context Summary - ${messages.length} messages condensed]`
+  ];
+  if (userRequests.length > 0) {
+    parts.push(`User requests: ${userRequests.slice(0, 3).join(" | ")}`);
+  }
+  if (files.size > 0) {
+    parts.push(`Files touched: ${[...files].slice(0, 10).join(", ")}${files.size > 10 ? ` (+${files.size - 10} more)` : ""}`);
+  }
+  if (tools.size > 0) {
+    parts.push(`Tools used: ${[...tools].join(", ")}`);
+  }
+  if (decisions.length > 0) {
+    parts.push(`Key decisions: ${decisions.slice(0, 2).join(" | ")}`);
+  }
+  if (errors.length > 0) {
+    parts.push(`Errors encountered: ${errors.slice(0, 2).join(" | ")}`);
+  }
+  return parts.join("\n");
+}
+async function summarizeWithLLM(messages, llm, memoryManager) {
+  if (!llm || messages.length === 0) {
+    return summarizeMessagesStatic(messages);
+  }
+  try {
+    const serializedLog = serializeMessagesForSummary(messages);
+    const summarizationPrompt = [
+      "Summarize the following conversation for context preservation. Include:",
+      "1. The user's original request and intent",
+      "2. What has been accomplished so far (files created/modified, commands run)",
+      "3. What remains to be done",
+      "4. Any key decisions or constraints discovered",
+      "5. Any user preferences or project-relevant points worth remembering",
+      "",
+      "Keep it concise (under 500 words). This summary replaces the removed messages.",
+      "",
+      "--- Conversation ---",
+      serializedLog
+    ].join("\n");
+    const response = await llm.complete({
+      messages: [
+        { role: "system", content: "You are a context summarization assistant. Produce concise, factual summaries that preserve task continuity." },
+        { role: "user", content: summarizationPrompt }
+      ],
+      temperature: 0.1,
+      maxTokens: 1e3
+    });
+    const summaryText = response.content?.trim();
+    if (!summaryText) {
+      return summarizeMessagesStatic(messages);
+    }
+    if (memoryManager) {
+      await persistKeyFacts(summaryText, memoryManager).catch(() => {
+      });
+    }
+    return `[LLM Context Summary - ${messages.length} messages condensed]
+${summaryText}`;
+  } catch {
+    return summarizeMessagesStatic(messages);
+  }
+}
+function buildStructuredSummary(summaryText, fileOps) {
+  const lines = summaryText.split("\n").map((l) => l.trim()).filter(Boolean);
+  const goal = lines.find((l) => /goal|intent|request|objective/i.test(l)) ?? lines[0] ?? "";
+  const constraints = [];
+  const progress = [];
+  const keyDecisions = [];
+  const nextSteps = [];
+  const criticalContext = [];
+  for (const line of lines) {
+    if (/constraint|requirement|must|should/i.test(line)) constraints.push(line);
+    else if (/accomplished|done|completed|created|modified|implemented/i.test(line)) progress.push(line);
+    else if (/decided|chose|selected|preference/i.test(line)) keyDecisions.push(line);
+    else if (/remain|todo|next|pending|still/i.test(line)) nextSteps.push(line);
+    else if (/critical|important|essential|key/i.test(line)) criticalContext.push(line);
+  }
+  return {
+    goal,
+    constraints,
+    progress,
+    keyDecisions,
+    nextSteps,
+    criticalContext,
+    readFiles: fileOps.readFiles,
+    modifiedFiles: fileOps.modifiedFiles
+  };
+}
+function extractFileOperations(messages) {
+  const readFiles = /* @__PURE__ */ new Set();
+  const modifiedFiles = /* @__PURE__ */ new Set();
+  for (const msg of messages) {
+    const metadata = msg.metadata ?? extractMessageMetadata(msg);
+    if (!metadata.tools || !metadata.files) continue;
+    for (const tool of metadata.tools) {
+      const isReadTool = tool.includes("read") || tool.includes("cat") || tool.includes("grep") || tool.includes("search");
+      const isWriteTool = tool.includes("write") || tool.includes("edit") || tool.includes("create") || tool.includes("delete") || tool.includes("move");
+      if (isReadTool) {
+        metadata.files.forEach((f) => readFiles.add(f));
+      }
+      if (isWriteTool) {
+        metadata.files.forEach((f) => modifiedFiles.add(f));
+      }
+    }
+  }
+  return {
+    readFiles: [...readFiles],
+    modifiedFiles: [...modifiedFiles]
+  };
+}
+async function persistKeyFacts(summary, memoryManager) {
+  const factPatterns = [
+    /(?:chose|decided|selected|using|preference|prefer)\s+.{10,100}/gi,
+    /(?:constraint|requirement|must|should)\s+.{10,100}/gi
+  ];
+  const facts = /* @__PURE__ */ new Set();
+  for (const pattern of factPatterns) {
+    let match;
+    while ((match = pattern.exec(summary)) !== null) {
+      facts.add(match[0].trim());
+    }
+  }
+  for (const fact of [...facts].slice(0, 5)) {
+    await memoryManager.store(fact, "project", ["context-summary"], "context-summarization");
+  }
+}
+var summarizeMessages = summarizeMessagesStatic;
+
+export {
+  extractMessageMetadata,
+  determineMessagePriority,
+  sortMessagesByPriority,
+  findCoherentRemovalIndices,
+  summarizeMessagesStatic,
+  summarizeWithLLM,
+  buildStructuredSummary,
+  extractFileOperations,
+  persistKeyFacts,
+  summarizeMessages
+};
+/**
+ * @license
+ * Copyright 2025 Autohand AI LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Metadata extraction, priority scoring, sorting, and tool-call coherence.
+ * Extracted from contextManager.ts for composability.
+ */
+/**
+ * @license
+ * Copyright 2025 Autohand AI LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Message → text serialization for summarization prompts.
+ * Converts LLMMessage[] into a plain-text conversation log that
+ * prevents the LLM from treating it as a conversation to continue.
+ */
+/**
+ * @license
+ * Copyright 2025 Autohand AI LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * LLM-powered + static summarization with structured format.
+ * Extracted from contextManager.ts for composability.
+ */