@mrclrchtr/supi-web 6.4.0 → 7.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-web",
-  "version": "6.4.0",
+  "version": "7.0.1",
   "description": "Public web pages to Markdown, plus focused Context7 docs",
   "license": "MIT",
   "repository": {

package/src/tool/result.ts

@@ -7,9 +7,6 @@ import {
 } from "@earendil-works/pi-coding-agent";
 import { writeTempFile } from "../temp-file.ts";
 
-/** Human-readable truncation contract shared by all model-visible web outputs. */
-export const MODEL_OUTPUT_LIMIT_DESCRIPTION = `Inline truncates at ${DEFAULT_MAX_LINES.toLocaleString()} lines/${formatSize(DEFAULT_MAX_BYTES)}; full saved to temp.`;
-
 /** Result of preparing content for a tool response visible to the model. */
 export interface ModelVisibleOutput {
   /** Text safe to return in a tool result. */

package/src/tool/web_docs_fetch/guidance.ts

@@ -1,9 +1,6 @@
-import { MODEL_OUTPUT_LIMIT_DESCRIPTION } from "../result.ts";
+export const toolDescription =
+  "Fetch focused Context7 docs for a known library_id. Search first if the ID is unknown. Markdown is the default; raw=true returns JSON snippets.";
 
-export const toolDescription = `Fetch focused Context7 docs for a known Context7 library_id. Markdown by default; raw=true returns JSON snippets. Search first if unknown. ${MODEL_OUTPUT_LIMIT_DESCRIPTION}`;
+export const promptSnippet = "fetch focused Context7 documentation";
 
-export const promptSnippet = "web_docs_fetch: focused Context7 docs";
-
-export const promptGuidelines = [
-  "Use web_docs_fetch with a known library_id and narrow query; raw only for JSON.",
-];
+export const promptGuidelines: string[] = [];

package/src/tool/web_docs_fetch/spec.ts

@@ -8,7 +8,7 @@ export const WEB_DOCS_FETCH_TOOL_LABEL = "Web Docs Fetch";
 export const webDocsFetchParameters = Type.Object(
   {
     library_id: Type.String({
-      description: "Context7 ID (e.g. /facebook/react); search first if unknown",
+      description: "Context7 ID, for example /facebook/react.",
     }),
     query: Type.String({ description: "Specific docs question" }),
     raw: Type.Optional(

package/src/tool/web_docs_search/guidance.ts

@@ -1,7 +1,5 @@
-import { MODEL_OUTPUT_LIMIT_DESCRIPTION } from "../result.ts";
+export const toolDescription = "Search Context7 for library IDs and return compact Markdown.";
 
-export const toolDescription = `Search Context7 for library IDs; returns compact Markdown. ${MODEL_OUTPUT_LIMIT_DESCRIPTION}`;
+export const promptSnippet = "find Context7 library IDs";
 
-export const promptSnippet = "web_docs_search: Context7 library IDs";
-
-export const promptGuidelines = ["Use web_docs_search before web_docs_fetch if ID unknown."];
+export const promptGuidelines: string[] = [];

package/src/tool/web_fetch_md/guidance.ts

@@ -1,32 +1,17 @@
-import { spawnSync } from "node:child_process";
-import { MODEL_OUTPUT_LIMIT_DESCRIPTION } from "../result.ts";
 import type { WebToolPromptSurface } from "../tool-specs.ts";
 import { WEB_FETCH_INLINE_MAX_CHARS } from "./spec.ts";
 
-export const toolDescription = `Fetch public http(s) URL as Markdown. Not for login/private pages. output_mode auto inlines <=${WEB_FETCH_INLINE_MAX_CHARS.toLocaleString()} chars else temp; inline may truncate; file returns a temp path. Links are absolute by default. ${MODEL_OUTPUT_LIMIT_DESCRIPTION}`;
+export const toolDescription = `Fetch a public http(s) URL as Markdown. Not for login or private pages. Use gh for GitHub URLs when available. output_mode auto returns up to ${WEB_FETCH_INLINE_MAX_CHARS.toLocaleString()} characters inline and otherwise returns a temporary-file path; file always returns a temporary-file path. Links are absolute by default.`;
 
-export const promptSnippet = "web_fetch_md: public URL to Markdown";
+export const promptSnippet = "fetch a public URL as Markdown";
 
-export const promptGuidelines = ["Use web_fetch_md only for public http(s); ask if login/private."];
+export const promptGuidelines: string[] = [];
 
-/** Runtime prompt surface; adds gh guidance when the gh CLI is available. */
+/** Return the static prompt surface for web_fetch_md. */
 export function getWebFetchPromptSurface(): WebToolPromptSurface {
-  const guidelines = [...promptGuidelines];
-  if (isGhAvailable()) {
-    guidelines.push("Use `gh` CLI instead of web_fetch_md for GitHub URLs.");
-  }
   return {
     description: toolDescription,
     promptSnippet,
-    promptGuidelines: guidelines,
+    promptGuidelines,
   };
 }
-
-function isGhAvailable(): boolean {
-  try {
-    const result = spawnSync("gh", ["--version"], { stdio: "ignore" });
-    return result.status === 0;
-  } catch {
-    return false;
-  }
-}