@mrclrchtr/supi-web 1.14.3 → 1.16.0

package/README.md

@@ -26,7 +26,10 @@ pi install ./packages/supi-web
 
 ## What you get
 
-After install, pi gets three tools:
+After install, pi gets three tools.
+
+In PI's TUI, these tools now render a collapsed summary by default; expand the tool row to reveal the full inline output.
+
 
 | Tool | Purpose |
 |------|---------|
@@ -50,7 +53,7 @@ Fetches a public URL and returns clean Markdown.
 ### Output modes
 
 - **`auto`** — returns Markdown inline if ≤15,000 characters; otherwise writes to a temporary file and returns the path
-- **`inline`** — always returns Markdown inline
+- **`inline`** — returns Markdown inline, truncated to PI's model-visible output limit when necessary
 - **`file`** — always writes to a temporary file and returns the path
 
 ### Behavior
@@ -58,6 +61,7 @@ Fetches a public URL and returns clean Markdown.
 - Only accepts real `http://` or `https://` URLs
 - Access-controlled pages (login, paywall) should be skipped — ask the user for an allowed source instead
 - Plain-text responses are wrapped in fenced code blocks
+- Model-visible inline output is truncated to 2,000 lines or 50KB; full truncated output is saved to a temp file
 - Links and images are absolutized by default; set `abs_links: false` to keep them relative
 
 ## `web_docs_search`
@@ -71,7 +75,7 @@ Searches Context7 for library IDs before fetching documentation.
 | `library_name` | string | ✓ | Library name to search for (e.g. `"react"`, `"next.js"`) |
 | `query` | string | ✓ | What you're trying to do — used for relevance ranking |
 
-Results return as a Markdown table with library ID, name, description, trust score, benchmark score, snippet count, and available versions.
+Results return as a compact Markdown table with library ID, name, description, trust score, benchmark score, snippet count, and shortened version lists (top 10 matches shown).
 
 ## `web_docs_fetch`
 
@@ -85,7 +89,7 @@ Retrieves documentation context for a known Context7 library.
 | `query` | string | ✓ | — | Specific question about the library |
 | `raw` | boolean | — | `false` | When `true`, returns JSON-serialized snippet objects instead of Markdown |
 
-Default mode returns pre-formatted Markdown. Set `raw: true` when you need structured JSON for programmatic use.
+Default mode returns pre-formatted Markdown. Set `raw: true` when you need structured JSON for programmatic use. Large model-visible responses are truncated to 2,000 lines or 50KB with the full response saved to a temp file.
 
 ## Typical workflow
 

package/node_modules/@mrclrchtr/supi-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-core",
-  "version": "1.14.3",
+  "version": "1.16.0",
   "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
   "license": "MIT",
   "repository": {

package/node_modules/@mrclrchtr/supi-core/src/context/context-provider-registry.ts

@@ -6,7 +6,7 @@
 import { createRegistry } from "../registry-utils.ts";
 
 export interface ContextProvider {
-  /** Unique identifier — e.g. "rtk" */
+  /** Unique identifier — e.g. "lsp" */
   id: string;
   /** Human-readable label shown in the report */
   label: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-web",
-  "version": "1.14.3",
+  "version": "1.16.0",
   "description": "SuPi Web extension — fetch web pages as clean Markdown (web_fetch_md) and library docs via Context7 (web_docs_search, web_docs_fetch)",
   "license": "MIT",
   "repository": {
@@ -35,19 +35,27 @@
     "@mozilla/readability": "^0.6.0",
     "turndown": "^7.2.0",
     "turndown-plugin-gfm": "^1.0.2",
-    "@mrclrchtr/supi-core": "1.14.3"
+    "@mrclrchtr/supi-core": "1.16.0"
   },
   "bundledDependencies": [
     "@mrclrchtr/supi-core"
   ],
   "peerDependencies": {
+    "@earendil-works/pi-ai": "*",
     "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
     "typebox": "*"
   },
   "peerDependenciesMeta": {
+    "@earendil-works/pi-ai": {
+      "optional": true
+    },
     "@earendil-works/pi-coding-agent": {
       "optional": true
     },
+    "@earendil-works/pi-tui": {
+      "optional": true
+    },
     "typebox": {
       "optional": true
     }

package/src/api.ts

@@ -2,6 +2,7 @@
  * SuPi Web extension — public API exports.
  */
 
+export type { Context7RequestOptions } from "./context7-client.ts";
 export { htmlToMarkdown, wrapAsCodeBlock } from "./convert.ts";
 export { default as docsExtension } from "./docs.ts";
 export {
@@ -11,4 +12,13 @@ export {
   fetchWithNegotiation,
   isValidHttpUrl,
 } from "./fetch.ts";
+export {
+  WEB_FETCH_INLINE_MAX_CHARS,
+  WEB_TOOL_NAMES,
+  WEB_TOOL_SPECS,
+  type WebDocsFetchInput,
+  type WebDocsSearchInput,
+  type WebFetchMdInput,
+  type WebToolName,
+} from "./tool/tool-specs.ts";
 export { default } from "./web.ts";

package/src/context7-client.ts

@@ -31,6 +31,11 @@ export interface DocSnippet {
   source: string;
 }
 
+/** Request options shared by Context7 REST calls. */
+export interface Context7RequestOptions {
+  signal?: AbortSignal;
+}
+
 function authHeaders(): Record<string, string> {
   const apiKey = process.env.CONTEXT7_API_KEY;
   return apiKey ? { Authorization: `Bearer ${apiKey}` } : {};
@@ -86,12 +91,16 @@ function mapSearchResult(r: ApiSearchResult): SearchResult {
   };
 }
 
-export async function searchLibrary(query: string, libraryName: string): Promise<SearchResult[]> {
+export async function searchLibrary(
+  query: string,
+  libraryName: string,
+  options: Context7RequestOptions = {},
+): Promise<SearchResult[]> {
   const url = new URL(`${BASE_URL}/v2/libs/search`);
   url.searchParams.set("query", query);
   url.searchParams.set("libraryName", libraryName);
 
-  const response = await fetch(url, { headers: authHeaders() });
+  const response = await fetch(url, { headers: authHeaders(), signal: options.signal });
 
   if (!response.ok) {
     throw new Context7Error(await parseErrorResponse(response));
@@ -105,12 +114,13 @@ export async function getContext(
   query: string,
   libraryId: string,
   raw?: boolean,
+  options: Context7RequestOptions = {},
 ): Promise<string | DocSnippet[]> {
   const url = new URL(`${BASE_URL}/v2/context`);
   url.searchParams.set("query", query);
   url.searchParams.set("libraryId", libraryId);
 
-  const response = await fetch(url, { headers: authHeaders() });
+  const response = await fetch(url, { headers: authHeaders(), signal: options.signal });
 
   if (!response.ok) {
     throw new Context7Error(await parseErrorResponse(response));

package/src/docs.ts

@@ -1,198 +1,337 @@
 /**
  * SuPi Web Context7 extension — registers web_docs_search and web_docs_fetch tools.
  *
- * Uses @upstash/context7-sdk for up-to-date library documentation lookups.
  * API key is read automatically from the CONTEXT7_API_KEY environment variable.
  */
 
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import { Type } from "typebox";
-import { Context7Error, getContext, searchLibrary } from "./context7-client.ts";
+import type {
+  AgentToolResult,
+  AgentToolUpdateCallback,
+  ExtensionAPI,
+  ExtensionContext,
+  TruncationResult,
+} from "@earendil-works/pi-coding-agent";
+import { getContext, searchLibrary } from "./context7-client.ts";
+import { getWebToolPromptSurface } from "./tool/guidance.ts";
+import { limitModelVisibleOutput } from "./tool/output.ts";
+import { renderCollapsibleTextResult, renderToolCall } from "./tool/render.ts";
 import {
-  promptGuidelines as fetchPromptGuidelines,
-  promptSnippet as fetchPromptSnippet,
-  toolDescription as fetchToolDescription,
-} from "./tool/web-docs-fetch-guidance.ts";
-import {
-  promptGuidelines as searchPromptGuidelines,
-  promptSnippet as searchPromptSnippet,
-  toolDescription as searchToolDescription,
-} from "./tool/web-docs-search-guidance.ts";
+  getWebToolSpec,
+  WEB_DOCS_FETCH_TOOL_NAME,
+  WEB_DOCS_SEARCH_TOOL_NAME,
+  type WebDocsFetchInput,
+  type WebDocsSearchInput,
+} from "./tool/tool-specs.ts";
+
+interface SearchDetails extends Record<string, unknown> {
+  count: number;
+  libraryName: string;
+  truncation?: TruncationResult;
+  fullOutputPath?: string;
+}
+
+interface FetchDetails extends Record<string, unknown> {
+  libraryId: string;
+  raw: boolean;
+  chars: number;
+  lines: number;
+  truncation?: TruncationResult;
+  fullOutputPath?: string;
+}
+
+type SearchLibraryResult = Awaited<ReturnType<typeof searchLibrary>>[number];
 
-const SEARCH_TOOL_NAME = "web_docs_search";
-const SEARCH_TOOL_LABEL = "Web Docs Search";
-const FETCH_TOOL_NAME = "web_docs_fetch";
-const FETCH_TOOL_LABEL = "Web Docs Fetch";
+const MAX_SEARCH_RESULTS = 10;
+const MAX_DESCRIPTION_CHARS = 120;
+const MAX_VERSION_COUNT = 5;
 
 export default function docsExtension(pi: ExtensionAPI): void {
+  const searchSpec = getWebToolSpec(WEB_DOCS_SEARCH_TOOL_NAME);
+  const searchSurface = getWebToolPromptSurface(WEB_DOCS_SEARCH_TOOL_NAME);
   pi.registerTool({
-    name: SEARCH_TOOL_NAME,
-    label: SEARCH_TOOL_LABEL,
-    description: searchToolDescription,
-    promptSnippet: searchPromptSnippet,
-    promptGuidelines: searchPromptGuidelines,
-    parameters: Type.Object({
-      library_name: Type.String({
-        description: "Library name to search for (e.g. react, next.js, fastapi)",
-      }),
-      query: Type.String({
-        description: "What you're trying to do — used for relevance ranking of results",
-      }),
-    }),
+    name: searchSpec.name,
+    label: searchSpec.label,
+    description: searchSurface.description,
+    promptSnippet: searchSurface.promptSnippet,
+    promptGuidelines: searchSurface.promptGuidelines,
+    parameters: searchSpec.parameters,
     execute: runSearch,
+    renderCall(args, theme) {
+      const input = (args ?? {}) as WebDocsSearchInput;
+      const libraryName = typeof input.library_name === "string" ? input.library_name : "";
+      const query = typeof input.query === "string" ? truncatePreview(input.query) : undefined;
+      return renderToolCall(searchSpec.name, libraryName, theme, query);
+    },
+    renderResult(result, { expanded, isPartial }, theme) {
+      if (isPartial) {
+        return renderCollapsibleTextResult({
+          summary: theme.fg("warning", "Searching Context7..."),
+          expanded,
+          theme,
+        });
+      }
+
+      const details = result.details as SearchDetails | undefined;
+      const summary = buildSearchSummary(details, theme);
+      const content = result.content.find((item) => item.type === "text");
+      const body =
+        details?.count === 0 ? undefined : content?.type === "text" ? content.text : undefined;
+
+      return renderCollapsibleTextResult({
+        summary,
+        body,
+        expanded,
+        theme,
+        fullOutputPath: details?.fullOutputPath,
+      });
+    },
   });
 
+  const fetchSpec = getWebToolSpec(WEB_DOCS_FETCH_TOOL_NAME);
+  const fetchSurface = getWebToolPromptSurface(WEB_DOCS_FETCH_TOOL_NAME);
   pi.registerTool({
-    name: FETCH_TOOL_NAME,
-    label: FETCH_TOOL_LABEL,
-    description: fetchToolDescription,
-    promptSnippet: fetchPromptSnippet,
-    promptGuidelines: fetchPromptGuidelines,
-    parameters: Type.Object({
-      library_id: Type.String({
-        description:
-          "Context7 library ID (e.g. /facebook/react, /vercel/next.js). Find it via web_docs_search.",
-      }),
-      query: Type.String({
-        description: "Specific question about the library",
-      }),
-      raw: Type.Optional(
-        Type.Boolean({
-          description:
-            "When true, returns JSON-serialized snippet objects instead of plain text Markdown",
-          default: false,
-        }),
-      ),
-    }),
+    name: fetchSpec.name,
+    label: fetchSpec.label,
+    description: fetchSurface.description,
+    promptSnippet: fetchSurface.promptSnippet,
+    promptGuidelines: fetchSurface.promptGuidelines,
+    parameters: fetchSpec.parameters,
     execute: runFetch,
+    renderCall(args, theme) {
+      const input = (args ?? {}) as WebDocsFetchInput;
+      const libraryId = typeof input.library_id === "string" ? input.library_id : "";
+      const query = typeof input.query === "string" ? truncatePreview(input.query) : undefined;
+      return renderToolCall(fetchSpec.name, libraryId, theme, query);
+    },
+    renderResult(result, { expanded, isPartial }, theme) {
+      if (isPartial) {
+        return renderCollapsibleTextResult({
+          summary: theme.fg("warning", "Fetching Context7 docs..."),
+          expanded,
+          theme,
+        });
+      }
+
+      const details = result.details as FetchDetails | undefined;
+      const summary = buildFetchSummary(details, theme);
+      const content = result.content.find((item) => item.type === "text");
+      const body = content?.type === "text" ? content.text : undefined;
+
+      return renderCollapsibleTextResult({
+        summary,
+        body,
+        expanded,
+        theme,
+        fullOutputPath: details?.fullOutputPath,
+      });
+    },
   });
 }
 
 // biome-ignore lint/complexity/useMaxParams: pi ToolDefinition.execute signature
 async function runSearch(
   _toolCallId: string,
-  params: Record<string, unknown>,
-  _signal: AbortSignal | undefined,
-  _onUpdate: unknown,
-  _ctx: unknown,
-): Promise<{
-  content: { type: "text"; text: string }[];
-  details: Record<string, unknown>;
-  isError?: boolean;
-}> {
-  const libraryName = (params.library_name as string | undefined)?.trim();
-  const query = (params.query as string | undefined)?.trim();
-
-  if (!libraryName) {
-    return {
-      content: [{ type: "text", text: "Error: 'library_name' parameter is required" }],
-      isError: true,
-      details: {},
-    };
-  }
+  params: unknown,
+  signal: AbortSignal | undefined,
+  onUpdate: AgentToolUpdateCallback<Record<string, unknown>> | undefined,
+  _ctx: ExtensionContext,
+): Promise<AgentToolResult<SearchDetails>> {
+  const input = (params ?? {}) as WebDocsSearchInput;
+  const libraryName = input.library_name?.trim();
+  const query = input.query?.trim();
 
-  if (!query) {
-    return {
-      content: [{ type: "text", text: "Error: 'query' parameter is required" }],
-      isError: true,
-      details: {},
-    };
-  }
+  if (!libraryName) throw new Error("'library_name' parameter is required");
+  if (!query) throw new Error("'query' parameter is required");
 
-  try {
-    const results = await searchLibrary(query, libraryName);
-
-    if (results.length === 0) {
-      return {
-        content: [
-          {
-            type: "text",
-            text: `No libraries found for "${libraryName}". Try a different search term.`,
-          },
-        ],
-        details: { count: 0, libraryName },
-      };
-    }
-
-    const rows = results.map(
-      (lib) =>
-        `| **${escapeMd(lib.name)}** | \`${escapeMd(lib.id)}\` | ${escapeMd(lib.description ?? "")} | ${lib.trustScore ?? ""} | ${lib.benchmarkScore ?? ""} | ${lib.totalSnippets ?? ""} | ${lib.versions ? lib.versions.join(", ") : ""} |`,
-    );
-
-    const markdown = [
-      `Found **${results.length}** library/libraries matching "${libraryName}":`,
-      "",
-      "| Name | ID | Description | Trust | Benchmark | Snippets | Versions |",
-      "|---|---|---|---|---|---|---|",
-      ...rows,
-      "",
-      `> Use \`web_docs_fetch\` with the library ID to retrieve documentation.`,
-    ].join("\n");
+  onUpdate?.({
+    content: [{ type: "text", text: `Searching Context7 for ${libraryName}...` }],
+    details: { libraryName },
+  });
 
+  const requestOptions = signal ? { signal } : undefined;
+  const results = await searchLibrary(query, libraryName, requestOptions);
+
+  if (results.length === 0) {
     return {
-      content: [{ type: "text", text: markdown }],
-      details: { count: results.length, libraryName },
-    };
-  } catch (err) {
-    const message = err instanceof Context7Error ? err.message : `Unexpected error: ${String(err)}`;
-    return {
-      content: [{ type: "text", text: `Error: ${message}` }],
-      isError: true,
-      details: { libraryName, error: String(err) },
+      content: [
+        {
+          type: "text",
+          text: `No libraries found for "${libraryName}". Try a different search term.`,
+        },
+      ],
+      details: { count: 0, libraryName },
     };
   }
+
+  const markdown = formatSearchResults(libraryName, results);
+  const output = await limitModelVisibleOutput(markdown, {
+    tempPrefix: "web-docs-search",
+    suffix: ".md",
+  });
+
+  return {
+    content: [{ type: "text", text: output.text }],
+    details: {
+      count: results.length,
+      libraryName,
+      truncation: output.truncation,
+      fullOutputPath: output.fullOutputPath,
+    },
+  };
 }
 
 // biome-ignore lint/complexity/useMaxParams: pi ToolDefinition.execute signature
 async function runFetch(
   _toolCallId: string,
-  params: Record<string, unknown>,
-  _signal: AbortSignal | undefined,
-  _onUpdate: unknown,
-  _ctx: unknown,
-): Promise<{
-  content: { type: "text"; text: string }[];
-  details: Record<string, unknown>;
-  isError?: boolean;
-}> {
-  const libraryId = (params.library_id as string | undefined)?.trim();
-  const query = (params.query as string | undefined)?.trim();
-  const raw = Boolean(params.raw);
-
-  if (!libraryId) {
-    return {
-      content: [{ type: "text", text: "Error: 'library_id' parameter is required" }],
-      isError: true,
-      details: {},
-    };
+  params: unknown,
+  signal: AbortSignal | undefined,
+  onUpdate: AgentToolUpdateCallback<Record<string, unknown>> | undefined,
+  _ctx: ExtensionContext,
+): Promise<AgentToolResult<FetchDetails>> {
+  const input = (params ?? {}) as WebDocsFetchInput;
+  const libraryId = input.library_id?.trim();
+  const query = input.query?.trim();
+  const raw = Boolean(input.raw);
+
+  if (!libraryId) throw new Error("'library_id' parameter is required");
+  if (!query) throw new Error("'query' parameter is required");
+
+  onUpdate?.({
+    content: [{ type: "text", text: `Fetching Context7 docs for ${libraryId}...` }],
+    details: { libraryId, raw },
+  });
+
+  const requestOptions = signal ? { signal } : undefined;
+  const content = await getContext(query, libraryId, raw, requestOptions);
+  const textContent = typeof content === "string" ? content : JSON.stringify(content, null, 2);
+  const output = await limitModelVisibleOutput(textContent, {
+    tempPrefix: "web-docs-fetch",
+    suffix: raw ? ".json" : ".md",
+  });
+
+  return {
+    content: [{ type: "text", text: output.text }],
+    details: {
+      libraryId,
+      raw,
+      chars: textContent.length,
+      lines: textContent.split("\n").length,
+      truncation: output.truncation,
+      fullOutputPath: output.fullOutputPath,
+    },
+  };
+}
+
+function formatSearchResults(
+  libraryName: string,
+  results: Awaited<ReturnType<typeof searchLibrary>>,
+): string {
+  const visibleResults = results.slice(0, MAX_SEARCH_RESULTS);
+  const hiddenCount = results.length - visibleResults.length;
+  const rows = visibleResults.map(formatSearchRow);
+  const noun = results.length === 1 ? "library" : "libraries";
+  const hiddenNote =
+    hiddenCount > 0
+      ? [`_${hiddenCount} more omitted; refine \`library_name\` or \`query\` if needed._`, ""]
+      : [];
+
+  return [
+    `Found ${results.length} Context7 ${noun} for "${libraryName}"${hiddenCount > 0 ? `; showing top ${visibleResults.length}` : ""}:`,
+    "",
+    "| ID | Name | Trust | Bench | Snips | Versions | Description |",
+    "|---|---|---|---|---|---|---|",
+    ...rows,
+    "",
+    ...hiddenNote,
+    "> Use `web_docs_fetch` with the chosen ID.",
+  ].join("\n");
+}
+
+function formatSearchRow(lib: SearchLibraryResult): string {
+  const cells = [
+    `\`${escapeMd(lib.id)}\``,
+    escapeMd(lib.name),
+    String(lib.trustScore ?? ""),
+    String(lib.benchmarkScore ?? ""),
+    String(lib.totalSnippets ?? ""),
+    escapeMd(formatVersions(lib.versions)),
+    escapeMd(truncateCell(lib.description ?? "", MAX_DESCRIPTION_CHARS)),
+  ];
+
+  return `| ${cells.join(" | ")} |`;
+}
+
+function formatVersions(versions?: string[]): string {
+  if (!versions?.length) return "";
+  const visibleVersions = versions.slice(0, MAX_VERSION_COUNT);
+  const hiddenCount = versions.length - visibleVersions.length;
+  return `${visibleVersions.join(", ")}${hiddenCount > 0 ? `, +${hiddenCount}` : ""}`;
+}
+
+function truncateCell(text: string, maxChars: number): string {
+  const compact = text.replace(/\s+/g, " ").trim();
+  if (compact.length <= maxChars) return compact;
+  return `${compact.slice(0, maxChars - 1).trimEnd()}…`;
+}
+
+function escapeMd(text: string): string {
+  return text.replace(/\|/g, "\\|").replace(/\n/g, " ");
+}
+
+function truncatePreview(text: string, maxChars = 48): string {
+  const compact = text.replace(/\s+/g, " ").trim();
+  if (compact.length <= maxChars) return compact;
+  return `${compact.slice(0, maxChars - 1).trimEnd()}…`;
+}
+
+function buildSearchSummary(
+  details: SearchDetails | undefined,
+  theme: { fg: (color: "success" | "warning" | "dim", text: string) => string },
+): string {
+  if (!details) {
+    return theme.fg("success", "Context7 search finished");
   }
 
-  if (!query) {
-    return {
-      content: [{ type: "text", text: "Error: 'query' parameter is required" }],
-      isError: true,
-      details: {},
-    };
+  if (details.count === 0) {
+    return [
+      theme.fg("warning", "No libraries found"),
+      theme.fg("dim", ` for ${JSON.stringify(details.libraryName)}`),
+    ].join("");
   }
 
-  try {
-    const content = await getContext(query, libraryId, raw);
-    const textContent = typeof content === "string" ? content : JSON.stringify(content, null, 2);
+  const noun = details.count === 1 ? "library" : "libraries";
+  let summary = [
+    theme.fg("success", `Found ${details.count} ${noun}`),
+    theme.fg("dim", ` for ${JSON.stringify(details.libraryName)}`),
+  ].join("");
 
-    return {
-      content: [{ type: "text", text: textContent }],
-      details: { libraryId, raw },
-    };
-  } catch (err) {
-    const message = err instanceof Context7Error ? err.message : `Unexpected error: ${String(err)}`;
-    return {
-      content: [{ type: "text", text: `Error: ${message}` }],
-      isError: true,
-      details: { libraryId, error: String(err) },
-    };
+  if (details.truncation?.truncated) {
+    summary += theme.fg("warning", " [truncated]");
   }
+
+  return summary;
 }
 
-function escapeMd(text: string): string {
-  return text.replace(/\|/g, "\\|").replace(/\n/g, " ");
+function buildFetchSummary(
+  details: FetchDetails | undefined,
+  theme: { fg: (color: "success" | "warning" | "dim", text: string) => string },
+): string {
+  if (!details) {
+    return theme.fg("success", "Fetched Context7 docs");
+  }
+
+  const format = details.raw ? "raw JSON" : "Markdown";
+  let summary = [
+    theme.fg("success", `Fetched ${format}`),
+    theme.fg(
+      "dim",
+      ` for ${details.libraryId} (${details.chars.toLocaleString()} chars, ${details.lines.toLocaleString()} lines)`,
+    ),
+  ].join("");
+
+  if (details.truncation?.truncated) {
+    summary += theme.fg("warning", " [truncated]");
+  }
+
+  return summary;
 }