@mrclrchtr/supi-web 1.14.2 → 1.15.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,18 +1,27 @@
 {
   "name": "@mrclrchtr/supi-core",
-  "version": "1.14.2",
+  "version": "1.15.0",
   "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/mrclrchtr/supi.git"
+    "url": "git+https://github.com/mrclrchtr/supi.git",
+    "directory": "packages/supi-core"
+  },
+  "homepage": "https://github.com/mrclrchtr/supi/tree/main/packages/supi-core#readme",
+  "bugs": {
+    "url": "https://github.com/mrclrchtr/supi/issues"
   },
   "publishConfig": {
     "access": "public"
   },
   "keywords": [
     "pi",
-    "pi-coding-agent"
+    "pi-coding-agent",
+    "supi",
+    "extension-utils",
+    "settings",
+    "configuration"
   ],
   "files": [
     "src/**/*.ts",

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,11 +1,16 @@
 {
   "name": "@mrclrchtr/supi-web",
-  "version": "1.14.2",
+  "version": "1.15.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": {
     "type": "git",
-    "url": "git+https://github.com/mrclrchtr/supi.git"
+    "url": "git+https://github.com/mrclrchtr/supi.git",
+    "directory": "packages/supi-web"
+  },
+  "homepage": "https://github.com/mrclrchtr/supi/tree/main/packages/supi-web#readme",
+  "bugs": {
+    "url": "https://github.com/mrclrchtr/supi/issues"
   },
   "publishConfig": {
     "access": "public"
@@ -13,7 +18,13 @@
   "keywords": [
     "pi-package",
     "pi",
-    "pi-coding-agent"
+    "pi-coding-agent",
+    "pi-extension",
+    "web-fetch",
+    "markdown",
+    "context7",
+    "documentation",
+    "readability"
   ],
   "files": [
     "src/**/*.ts",
@@ -24,19 +35,27 @@
     "@mozilla/readability": "^0.6.0",
     "turndown": "^7.2.0",
     "turndown-plugin-gfm": "^1.0.2",
-    "@mrclrchtr/supi-core": "1.14.2"
+    "@mrclrchtr/supi-core": "1.15.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
     }
@@ -45,7 +64,7 @@
     "extensions": [
       "./src/extension.ts"
     ],
-    "image": "https://raw.githubusercontent.com/mrclrchtr/supi/main/packages/supi-web/assets/logo.png"
+    "image": "https://raw.githubusercontent.com/mrclrchtr/supi/main/screenshots/supi-web.png"
   },
   "main": "src/api.ts",
   "exports": {

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));