@mrclrchtr/supi-web 1.12.0 → 1.13.0

package/README.md

@@ -97,6 +97,6 @@ Skip step 1 if you already know the exact Context7 `library_id`.
 
 ## Context7 API key
 
-`web_docs_search` and `web_docs_fetch` use [Context7](https://context7.com/) through `@upstash/context7-sdk`.
+`web_docs_search` and `web_docs_fetch` call the [Context7 REST API](https://context7.com/) directly.
 
-If `CONTEXT7_API_KEY` is set in your environment, the SDK uses it automatically for higher rate limits. Without a key, the tools still work with lower defaults.
+Set `CONTEXT7_API_KEY` in your environment to authenticate with the Context7 API. Without a key, the tools will return an authentication error when called. Get a free API key at https://context7.com/dashboard.

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

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-core",
-  "version": "1.12.0",
+  "version": "1.13.0",
   "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
   "license": "MIT",
   "repository": {
@@ -44,6 +44,7 @@
     "./config": "./src/config.ts",
     "./context": "./src/context.ts",
     "./debug": "./src/debug-registry.ts",
+    "./footer-registry": "./src/footer-registry.ts",
     "./llm": "./src/llm.ts",
     "./package.json": "./package.json",
     "./path": "./src/path.ts",

package/node_modules/@mrclrchtr/supi-core/src/api.ts

@@ -13,6 +13,8 @@ export * from "./context.ts";
 // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
 export * from "./debug-registry.ts";
 // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
+export * from "./footer-registry.ts";
+// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
 export * from "./llm.ts";
 // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
 export * from "./path.ts";

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

@@ -0,0 +1,57 @@
+// Shared footer contribution registry for SuPi extensions.
+//
+// Extensions register pre-styled text chunks with a placement hint
+// ("stats" for the metrics line, "status" for the extension status line).
+// The custom footer in supi-extras (or PI's built-in footer) reads these
+// contributions and renders them alongside the built-in metrics.
+
+import { createRegistry } from "./registry-utils.ts";
+
+/** Where the contribution should appear in the footer. */
+export type FooterPlacement = "stats" | "status";
+
+/** A single footer contribution registered by an extension. */
+export interface FooterContribution {
+  /** Unique key for this contribution. Re-registering with the same key replaces it. */
+  key: string;
+  /** Which footer line this belongs on. */
+  placement: FooterPlacement;
+  /**
+   * Sort order within the placement (lower values render further left). Default: 100.
+   * Priority 0 is reserved for the turn cache-hit part so it stays adjacent to CH.
+   */
+  priority?: number;
+  /** Return the pre-styled text for this contribution. Called on every render. */
+  render: () => string;
+}
+
+const registry = createRegistry<FooterContribution>("footer-contributions");
+
+function sortByPriority(a: FooterContribution, b: FooterContribution): number {
+  return (a.priority ?? 100) - (b.priority ?? 100);
+}
+
+export const footerContributions = {
+  /** Register or replace a footer contribution. */
+  register(contribution: FooterContribution): void {
+    registry.register(contribution.key, contribution);
+  },
+
+  /** Remove a contribution (e.g. on session_shutdown or when disabled). */
+  unregister(key: string): void {
+    registry.unregister(key);
+  },
+
+  /** Get contributions for a specific placement, sorted by priority. */
+  getByPlacement(placement: FooterPlacement): FooterContribution[] {
+    return registry
+      .getAll()
+      .filter((c) => c.placement === placement)
+      .sort(sortByPriority);
+  },
+
+  /** Remove all contributions (primarily for tests). */
+  clear(): void {
+    registry.clear();
+  },
+};

package/node_modules/@mrclrchtr/supi-core/src/index.ts

@@ -13,6 +13,8 @@ export * from "./context.ts";
 // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
 export * from "./debug-registry.ts";
 // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
+export * from "./footer-registry.ts";
+// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
 export * from "./path.ts";
 // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
 export * from "./project.ts";

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

@@ -27,7 +27,7 @@ function getGlobalRegistryMap<T>(name: string): Map<string, T> {
  *
  * @typeParam T - The value type stored in the registry.
  * @param name - Unique registry name (used to construct the `Symbol.for` key).
- * @returns An object with `register`, `getAll`, and `clear` functions.
+ * @returns An object with `register`, `unregister`, `getAll`, and `clear` functions.
  */
 export function createRegistry<T>(name: string) {
   const getMap = (): Map<string, T> => getGlobalRegistryMap<T>(name);
@@ -40,6 +40,13 @@ export function createRegistry<T>(name: string) {
       getMap().set(id, value);
     },
 
+    /**
+     * Remove a registration by id. No-op if not registered.
+     */
+    unregister: (id: string): void => {
+      getMap().delete(id);
+    },
+
     /**
      * Get all registered values in registration order.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-web",
-  "version": "1.12.0",
+  "version": "1.13.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": {
@@ -20,12 +20,11 @@
     "README.md"
   ],
   "dependencies": {
-    "@upstash/context7-sdk": "^0.3.0",
     "jsdom": "^29.0.0",
     "@mozilla/readability": "^0.6.0",
     "turndown": "^7.2.0",
     "turndown-plugin-gfm": "^1.0.2",
-    "@mrclrchtr/supi-core": "1.12.0"
+    "@mrclrchtr/supi-core": "1.13.0"
   },
   "bundledDependencies": [
     "@mrclrchtr/supi-core"

package/src/context7-client.ts

@@ -1,12 +1,19 @@
 /**
- * Context7 API client — thin wrapper around @upstash/context7-sdk.
+ * Context7 API client — calls the Context7 REST API directly via fetch(),
+ * matching the official Context7 pi extension pattern.
  *
- * API key is read automatically from CONTEXT7_API_KEY env var by the SDK.
+ * API key is read from CONTEXT7_API_KEY env var. Without a key, requests are
+ * sent without an Authorization header; the API will return 401.
  */
 
-import { Context7, Context7Error } from "@upstash/context7-sdk";
+const BASE_URL = "https://context7.com/api";
 
-export { Context7Error };
+export class Context7Error extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = "Context7Error";
+  }
+}
 
 export interface SearchResult {
   id: string;
@@ -24,11 +31,74 @@ export interface DocSnippet {
   source: string;
 }
 
-const client = new Context7();
+function authHeaders(): Record<string, string> {
+  const apiKey = process.env.CONTEXT7_API_KEY;
+  return apiKey ? { Authorization: `Bearer ${apiKey}` } : {};
+}
+
+async function parseErrorResponse(response: Response): Promise<string> {
+  try {
+    const json = (await response.json()) as { message?: string };
+    if (json.message) return json.message;
+  } catch {
+    // JSON parsing failed, fall through to status-based message
+  }
+
+  const hasKey = Boolean(process.env.CONTEXT7_API_KEY);
+  if (response.status === 429) {
+    return hasKey
+      ? "Rate limited or quota exceeded. Upgrade your plan at https://context7.com/plans for higher limits."
+      : "Rate limited or quota exceeded. Create a free API key at https://context7.com/dashboard for higher limits.";
+  }
+  if (response.status === 404) {
+    return "The library you are trying to access does not exist. Please try with a different library ID.";
+  }
+  if (response.status === 401) {
+    return "Invalid API key. Please check your API key. API keys should start with 'ctx7sk' prefix.";
+  }
+  return `Request failed with status ${response.status}. Please try again later.`;
+}
+
+interface ApiSearchResult {
+  id: string;
+  title: string;
+  description: string;
+  totalSnippets: number;
+  trustScore: number;
+  benchmarkScore: number;
+  versions?: string[];
+}
+
+interface ApiSearchResponse {
+  error?: string;
+  results: ApiSearchResult[];
+}
+
+function mapSearchResult(r: ApiSearchResult): SearchResult {
+  return {
+    id: r.id,
+    name: r.title,
+    description: r.description,
+    totalSnippets: r.totalSnippets,
+    trustScore: r.trustScore,
+    benchmarkScore: r.benchmarkScore,
+    versions: r.versions,
+  };
+}
 
 export async function searchLibrary(query: string, libraryName: string): Promise<SearchResult[]> {
-  const results = await client.searchLibrary(query, libraryName);
-  return results as unknown as 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() });
+
+  if (!response.ok) {
+    throw new Context7Error(await parseErrorResponse(response));
+  }
+
+  const data = (await response.json()) as ApiSearchResponse;
+  return (data.results ?? []).map(mapSearchResult);
 }
 
 export async function getContext(
@@ -36,6 +106,20 @@ export async function getContext(
   libraryId: string,
   raw?: boolean,
 ): Promise<string | DocSnippet[]> {
-  const options = raw ? ({ type: "json" } as const) : ({ type: "txt" } as const);
-  return client.getContext(query, libraryId, options) as 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() });
+
+  if (!response.ok) {
+    throw new Context7Error(await parseErrorResponse(response));
+  }
+
+  if (raw) {
+    const json = (await response.json()) as DocSnippet[];
+    return json;
+  }
+
+  return response.text();
 }

package/src/fetch.ts

@@ -2,7 +2,7 @@
  * HTTP fetching with content negotiation and Markdown sniffing.
  */
 
-// biome-ignore lint/nursery/noExcessiveLinesPerFile: expanded guessLanguage map pushes past the threshold; nursery rule, not stable
+// biome-ignore lint/style/noExcessiveLinesPerFile: expanded guessLanguage map pushes past the threshold; nursery rule, not stable
 const USER_AGENT = "Mozilla/5.0 (compatible; supi-web/1.0; +https://github.com/mrclrchtr/supi)";
 const ACCEPT_SIBLING = "text/markdown,text/plain;q=0.9,*/*;q=0.1";
 const DEFAULT_TIMEOUT_MS = 30_000;