@dai_ming/plugin-deliverables 1.0.16 → 1.0.18

package/index.js

@@ -1,6 +1,9 @@
 "use strict";
 
 const FETCH_PATCH_KEY = "__plugin_deliverables_palz_fetch_patch__";
+const SUMMARY_CACHE_KEY = "__plugin_deliverables_summary_cache__";
+const SUMMARY_CACHE_LIMIT = 200;
+const SHORT_SUMMARY_THRESHOLD = 120;
 
 const RUNTIME_DELIVERABLES_GUIDANCE = [
   "## Deliverables Runtime Guard (HARD CONSTRAINT)",
@@ -9,13 +12,20 @@ const RUNTIME_DELIVERABLES_GUIDANCE = [
   "- When the user asks for a document, article, report, HTML page, Markdown file, PPT, image, archive, game, or any other file deliverable, you MUST create it under the current workspace `output/` directory and upload it with `deliverables__upload_deliverable`.",
   "- Do not use direct message attachments to deliver generated files. This includes the message tool attachment fields such as `media`, `path`, `filePath`, `buffer`, `attachment`, or similar file-carrying fields.",
   "- Do not emit `MEDIA:` file references for user-facing deliverables. Deliverable links must come from the deliverables upload tool instead.",
-  "- After a successful upload, reply with a short content-aware intro and then preserve the Markdown links returned by the deliverables tool.",
+  "- After a successful upload, reply with a substantive content summary before the links. For documents/articles/reports, prefer 1 short intro plus 3-6 concise bullets covering key sections, highlights, or findings, then preserve the Markdown links returned by the deliverables tool.",
 ].join("\n");
 
 function isString(value) {
   return typeof value === "string";
 }
 
+function getSummaryCache() {
+  if (!globalThis[SUMMARY_CACHE_KEY] || !(globalThis[SUMMARY_CACHE_KEY] instanceof Map)) {
+    globalThis[SUMMARY_CACHE_KEY] = new Map();
+  }
+  return globalThis[SUMMARY_CACHE_KEY];
+}
+
 const ATTACHMENT_PARAM_KEYS = new Set([
   "attachment",
   "attachments",
@@ -121,6 +131,246 @@ function stripBulletPrefix(line) {
   return String(line || "").replace(/^\s*[-*+]\s+/, "");
 }
 
+function stripNumberedPrefix(line) {
+  return String(line || "").replace(/^\s*\d+[.)]\s+/, "");
+}
+
+function cleanInlineMarkdown(text) {
+  return String(text || "")
+    .replace(/!\[[^\]]*\]\([^)]+\)/g, "")
+    .replace(/\[([^\]]+)\]\([^)]+\)/g, "$1")
+    .replace(/`([^`]*)`/g, "$1")
+    .replace(/\*\*([^*]+)\*\*/g, "$1")
+    .replace(/\*([^*]+)\*/g, "$1")
+    .replace(/__([^_]+)__/g, "$1")
+    .replace(/_([^_]+)_/g, "$1")
+    .replace(/^\s*>\s?/gm, "")
+    .replace(/\s+/g, " ")
+    .trim();
+}
+
+function trimSummaryText(text, limit = 160) {
+  const normalized = cleanInlineMarkdown(text);
+  if (normalized.length <= limit) {
+    return normalized;
+  }
+  return normalized.slice(0, limit - 1).trimEnd() + "…";
+}
+
+function extractTitleFromContent(text, fallbackName) {
+  const normalized = String(text || "").replace(/\r\n/g, "\n");
+  const lines = normalized.split("\n");
+  for (const line of lines) {
+    const match = line.match(/^\s*#\s+(.+?)\s*$/u);
+    if (match && match[1]) {
+      return trimSummaryText(match[1], 80);
+    }
+  }
+  return trimSummaryText(String(fallbackName || "").replace(/\.[^.]+$/, ""), 80);
+}
+
+function isBulletLine(line) {
+  return /^\s*[-*+]\s+/.test(String(line || ""));
+}
+
+function isNumberedLine(line) {
+  return /^\s*\d+[.)]\s+/.test(String(line || ""));
+}
+
+function summarizeSectionBody(lines) {
+  const bulletItems = [];
+  const paragraphLines = [];
+
+  for (const rawLine of lines) {
+    const line = String(rawLine || "").trim();
+    if (!line) {
+      continue;
+    }
+    if (isBulletLine(line)) {
+      bulletItems.push(trimSummaryText(stripBulletPrefix(line), 80));
+      continue;
+    }
+    if (isNumberedLine(line)) {
+      bulletItems.push(trimSummaryText(stripNumberedPrefix(line), 80));
+      continue;
+    }
+    if (/^\s*#{1,6}\s+/u.test(line)) {
+      continue;
+    }
+    paragraphLines.push(cleanInlineMarkdown(line));
+  }
+
+  if (bulletItems.length > 0) {
+    return bulletItems.slice(0, 2).join("；");
+  }
+
+  if (paragraphLines.length > 0) {
+    return trimSummaryText(paragraphLines.join(" "), 120);
+  }
+
+  return "";
+}
+
+function buildSummaryFromTextContent(text, fallbackName) {
+  const normalized = String(text || "").replace(/\r\n/g, "\n").trim();
+  if (!normalized) {
+    return "";
+  }
+
+  const title = extractTitleFromContent(normalized, fallbackName);
+  const lines = normalized.split("\n");
+  const sections = [];
+  let current = null;
+
+  for (const rawLine of lines) {
+    const line = String(rawLine || "");
+    const headingMatch = line.match(/^\s*#{2,3}\s+(.+?)\s*$/u);
+    if (headingMatch && headingMatch[1]) {
+      if (current) {
+        sections.push(current);
+      }
+      current = {
+        heading: trimSummaryText(headingMatch[1], 40),
+        lines: [],
+      };
+      continue;
+    }
+    if (current) {
+      current.lines.push(line);
+    }
+  }
+  if (current) {
+    sections.push(current);
+  }
+
+  const bulletLines = [];
+  for (const section of sections) {
+    const snippet = summarizeSectionBody(section.lines);
+    if (!snippet) {
+      continue;
+    }
+    bulletLines.push(`- ${section.heading}：${snippet}`);
+    if (bulletLines.length >= 4) {
+      break;
+    }
+  }
+
+  if (bulletLines.length === 0) {
+    const fallbackSnippet = summarizeSectionBody(lines);
+    if (!fallbackSnippet) {
+      return title ? `已为你生成《${title}》。` : "";
+    }
+    return title
+      ? `已为你生成《${title}》。\n\n内容摘要：\n- ${fallbackSnippet}`
+      : `内容摘要：\n- ${fallbackSnippet}`;
+  }
+
+  const intro = title ? `已为你生成《${title}》。` : "已为你生成交付物。";
+  return `${intro}\n\n内容摘要：\n${bulletLines.join("\n")}`;
+}
+
+function selectPrimaryTextFile(files) {
+  if (!Array.isArray(files) || files.length === 0) {
+    return null;
+  }
+
+  const textFiles = files.filter((file) => isString(file && file.content_text) && file.content_text.trim());
+  if (textFiles.length === 0) {
+    return null;
+  }
+
+  const scored = textFiles.map((file) => {
+    const name = String(file.name || "");
+    const content = String(file.content_text || "");
+    let score = content.length;
+    if (/\/?index\.html?$/i.test(name)) {
+      score += 2000;
+    }
+    if (/\.(md|markdown)$/i.test(name)) {
+      score += 1500;
+    }
+    if (/\.(txt|html?)$/i.test(name)) {
+      score += 800;
+    }
+    return { file, score };
+  });
+
+  scored.sort((a, b) => b.score - a.score);
+  return scored[0].file;
+}
+
+function buildSummaryFromUploadParams(params) {
+  if (!params || typeof params !== "object" || Array.isArray(params)) {
+    return "";
+  }
+
+  if (isString(params.content_text) && params.content_text.trim()) {
+    return buildSummaryFromTextContent(params.content_text, params.file_name);
+  }
+
+  const primaryFile = selectPrimaryTextFile(params.files);
+  if (primaryFile && isString(primaryFile.content_text) && primaryFile.content_text.trim()) {
+    return buildSummaryFromTextContent(primaryFile.content_text, primaryFile.name || params.file_name);
+  }
+
+  if (Array.isArray(params.files) && params.files.length > 0) {
+    const names = params.files
+      .map((file) => trimSummaryText(file && file.name ? String(file.name) : "", 40))
+      .filter(Boolean)
+      .slice(0, 4);
+    if (names.length > 0) {
+      return `已为你生成《${trimSummaryText(String(params.file_name || "交付物"), 60)}》。\n\n内容摘要：\n- 共包含 ${params.files.length} 个文件\n- 主要文件：${names.join("、")}`;
+    }
+  }
+
+  return "";
+}
+
+function cacheUploadSummary(params) {
+  const resourceId = isString(params && params.resource_id) ? params.resource_id.trim() : "";
+  if (!resourceId) {
+    return;
+  }
+  const summary = buildSummaryFromUploadParams(params);
+  if (!summary) {
+    return;
+  }
+  const cache = getSummaryCache();
+  cache.set(resourceId, {
+    summary,
+    createdAt: Date.now(),
+  });
+  while (cache.size > SUMMARY_CACHE_LIMIT) {
+    const firstKey = cache.keys().next();
+    if (firstKey.done) {
+      break;
+    }
+    cache.delete(firstKey.value);
+  }
+}
+
+function takeCachedSummary(resourceId) {
+  const key = isString(resourceId) ? resourceId.trim() : "";
+  if (!key) {
+    return "";
+  }
+  const cache = getSummaryCache();
+  const entry = cache.get(key);
+  cache.delete(key);
+  return entry && isString(entry.summary) ? entry.summary.trim() : "";
+}
+
+function isSummaryTooShort(summary) {
+  const text = cleanInlineMarkdown(summary);
+  if (!text) {
+    return true;
+  }
+  if (text.length < SHORT_SUMMARY_THRESHOLD) {
+    return true;
+  }
+  return !/\n\s*[-*+]\s+/u.test(String(summary || ""));
+}
+
 function isLinksHeading(line) {
   return /^\s*#{1,6}\s*访问链接\s*$/u.test(String(line || ""));
 }
@@ -178,26 +428,35 @@ function splitDeliverableMessage(text) {
   summaryLines = trimTrailingBlankLines(summaryLines);
 
   const linkLines = [];
+  const linkUrls = [];
   for (let i = firstLinkIndex; i < lines.length; i += 1) {
     const line = lines[i];
     if (isLinksHeading(line)) {
       continue;
     }
     if (isDeliverableLinkLine(line)) {
-      const url = extractDeliverableURL(stripBulletPrefix(line));
-      if (url) {
-        linkLines.push(url);
+      const normalizedLine = stripBulletPrefix(line).trim();
+      if (normalizedLine) {
+        linkLines.push(normalizedLine);
+        const url = extractDeliverableURL(normalizedLine);
+        if (url) {
+          linkUrls.push(url);
+        }
       }
     }
   }
 
   const summary = summaryLines.join("\n").trim();
-  const links = linkLines.length > 0 ? linkLines[0] : "";
+  const links = linkLines.join("\n").trim();
   if (!summary || !links) {
     return null;
   }
 
-  return { summary, links };
+  return {
+    summary,
+    links,
+    primaryLinkUrl: linkUrls.length > 0 ? linkUrls[0] : "",
+  };
 }
 
 function cloneBody(body, content, suffix) {
@@ -212,6 +471,12 @@ function cloneBody(body, content, suffix) {
   return next;
 }
 
+function cloneBodyAsFileLink(body, fileUrl, suffix) {
+  const next = cloneBody(body, [{ type: "file", file_url: { url: fileUrl } }], suffix);
+  delete next.msg_type;
+  return next;
+}
+
 function shouldSplitPalzPayload(body) {
   if (!body || typeof body !== "object" || Array.isArray(body)) {
     return null;
@@ -230,7 +495,19 @@ function shouldSplitPalzPayload(body) {
   if (body.palz_msg_type || body.tool_content) {
     return null;
   }
-  return splitDeliverableMessage(body.content);
+  const split = splitDeliverableMessage(body.content);
+  if (!split) {
+    return null;
+  }
+
+  const cachedSummary = takeCachedSummary(body.resource_id);
+  if (cachedSummary && isSummaryTooShort(split.summary)) {
+    return {
+      summary: cachedSummary,
+      links: split.links,
+    };
+  }
+  return split;
 }
 
 function resolveFetchURL(input) {
@@ -307,12 +584,14 @@ function installPalzFetchPatch(api) {
     }
 
     const summaryBody = cloneBody(parsed, split.summary, "__summary");
-    const linksBody = cloneBody(parsed, split.links, "__links");
+    const linksBody = split.primaryLinkUrl
+      ? cloneBodyAsFileLink(parsed, split.primaryLinkUrl, "__links")
+      : cloneBody(parsed, split.links, "__links");
     const summaryBodyStr = JSON.stringify(summaryBody);
     const linksBodyStr = JSON.stringify(linksBody);
 
     api.logger.info?.(
-      `[plugin-deliverables] split deliverable reply for palz target=${String(parsed.conversation_id || "")} summaryMsgId=${String(summaryBody.msg_id || "")} linksMsgId=${String(linksBody.msg_id || "")}`,
+      `[plugin-deliverables] split deliverable reply injected by plugin-deliverables target=${String(parsed.conversation_id || "")} summaryMsgId=${String(summaryBody.msg_id || "")} linksMsgId=${String(linksBody.msg_id || "")} linksMode=${split.primaryLinkUrl ? "file_url" : "text"}`,
     );
     api.logger.info?.(
       `[plugin-deliverables] palz summary request body_length=${summaryBodyStr.length}\n  request_body=${summaryBodyStr}`,
@@ -366,6 +645,7 @@ const plugin = {
 
     api.on("before_tool_call", async (event) => {
       if (isDeliverablesUploadTool(event.toolName)) {
+        cacheUploadSummary(event.params);
         return;
       }
       if (!isOutboundMessageTool(event.toolName)) {

package/openclaw-plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "plugin-deliverables",
-  "version": "1.0.16",
+  "version": "1.0.18",
   "npm_package": "@dai_ming/plugin-deliverables",
   "description": "Deliverables plugin: MCP server + skill + AGENTS rules for AI-generated file uploads",
   "mcp_servers": {

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "plugin-deliverables",
   "name": "Deliverables",
   "description": "Deliverables runtime guard for upload-first file delivery with Palz split-send diagnostics.",
-  "version": "1.0.16",
+  "version": "1.0.18",
   "skills": ["./skills"],
   "configSchema": {
     "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dai_ming/plugin-deliverables",
-  "version": "1.0.16",
+  "version": "1.0.18",
   "description": "OpenClaw deliverables plugin — upload AI-generated files to OSS and return shareable preview/download links",
   "keywords": [
     "openclaw",