@mrclrchtr/supi-web 1.1.3 → 1.3.0

package/README.md

@@ -18,6 +18,13 @@ pi install ./packages/supi-web
 
 After editing the source, run `/reload` to pick up changes.
 
+## Package surfaces
+
+- `@mrclrchtr/supi-web/api` — programmatic exports (conversion helpers, fetch utilities, tool factories)
+- `@mrclrchtr/supi-web/extension` — aggregated pi extension entrypoint that registers all three tools
+
+`pi.extensions` still points at the real file path `./src/extension.ts` inside the package. The `/api` and `/extension` paths are consumer-facing package exports, not manifest aliases.
+
 ## What it adds
 
 Registers three agent-callable tools:
@@ -81,6 +88,8 @@ The tool reads the `CONTEXT7_API_KEY` environment variable automatically when se
 
 ### Source files
 
+- `src/api.ts` — public package exports
+- `src/extension.ts` — aggregated extension entrypoint
 - `src/web.ts` — `web_fetch_md` tool registration
 - `src/docs.ts` — `web_docs_search` + `web_docs_fetch` tool registration
 - `src/context7-client.ts` — thin wrapper around `@upstash/context7-sdk`

package/node_modules/@mrclrchtr/supi-core/README.md

@@ -12,7 +12,12 @@ pnpm add @mrclrchtr/supi-core
 
 ## Package role
 
-`@mrclrchtr/supi-core` is a library package. It does **not** register a pi extension and is not meant to be installed as a standalone pi package.
+`@mrclrchtr/supi-core` now has two explicit surfaces:
+
+- `@mrclrchtr/supi-core/api` — shared library helpers for other SuPi packages
+- `@mrclrchtr/supi-core/extension` — a minimal pi extension that registers `/supi-settings`
+
+`pi.extensions` still points at the real file path `./src/extension.ts` inside the package. The `/api` and `/extension` paths are consumer-facing package exports, not manifest aliases.
 
 ## What it provides
 
@@ -59,7 +64,7 @@ Main helpers:
 ## Example
 
 ```ts
-import { loadSupiConfig, registerConfigSettings, wrapExtensionContext } from "@mrclrchtr/supi-core";
+import { loadSupiConfig, registerConfigSettings, wrapExtensionContext } from "@mrclrchtr/supi-core/api";
 
 const config = loadSupiConfig("my-extension", process.cwd(), {
   enabled: true,
@@ -87,4 +92,5 @@ const message = wrapExtensionContext("my-extension", "hello", {
 
 ## Source
 
-- Main exports: `src/index.ts`
+- Library surface: `src/api.ts`
+- Extension surface: `src/extension.ts`

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

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-core",
-  "version": "1.1.3",
+  "version": "1.3.0",
   "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
   "license": "MIT",
   "repository": {
@@ -30,5 +30,15 @@
       "optional": true
     }
   },
-  "main": "src/index.ts"
+  "main": "src/api.ts",
+  "exports": {
+    "./api": "./src/api.ts",
+    "./extension": "./src/extension.ts",
+    "./package.json": "./package.json"
+  },
+  "pi": {
+    "extensions": [
+      "./src/extension.ts"
+    ]
+  }
 }

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

@@ -0,0 +1,83 @@
+// supi-core — shared infrastructure for SuPi extensions.
+// Provides XML context tag wrapping, unified config system, context-message utilities,
+// and settings registry for supi-wide TUI settings.
+
+export type { SupiConfigLocation, SupiConfigOptions } from "./config.ts";
+export {
+  loadSupiConfig,
+  loadSupiConfigForScope,
+  removeSupiConfigKey,
+  writeSupiConfig,
+} from "./config.ts";
+export type { ConfigSettingsHelpers, ConfigSettingsOptions } from "./config-settings.ts";
+export { registerConfigSettings } from "./config-settings.ts";
+export type { ContextMessageLike } from "./context-messages.ts";
+export {
+  findLastUserMessageIndex,
+  getContextToken,
+  getPromptContent,
+  pruneAndReorderContextMessages,
+  restorePromptContent,
+} from "./context-messages.ts";
+export type { ContextProvider } from "./context-provider-registry.ts";
+export {
+  clearRegisteredContextProviders,
+  getRegisteredContextProviders,
+  registerContextProvider,
+} from "./context-provider-registry.ts";
+export { wrapExtensionContext } from "./context-tag.ts";
+export type {
+  DebugAgentAccess,
+  DebugEvent,
+  DebugEventInput,
+  DebugEventQuery,
+  DebugEventQueryResult,
+  DebugEventView,
+  DebugLevel,
+  DebugNotifyLevel,
+  DebugRegistryConfig,
+  DebugSummary,
+} from "./debug-registry.ts";
+export {
+  clearDebugEvents,
+  configureDebugRegistry,
+  DEBUG_REGISTRY_DEFAULTS,
+  getDebugEvents,
+  getDebugRegistryConfig,
+  getDebugSummary,
+  recordDebugEvent,
+  redactDebugData,
+  resetDebugRegistry,
+} from "./debug-registry.ts";
+export type { KnownRootEntry } from "./project-roots.ts";
+export {
+  buildKnownRootsMap,
+  byPathDepth,
+  dedupeTopmostRoots,
+  findProjectRoot,
+  isWithin,
+  isWithinOrEqual,
+  mergeKnownRoots,
+  resolveKnownRoot,
+  segmentCount,
+  sortRootsBySpecificity,
+  walkProject,
+} from "./project-roots.ts";
+export { getActiveBranchEntries } from "./session-utils.ts";
+export { registerSettingsCommand } from "./settings-command.ts";
+export type { SettingsScope, SettingsSection } from "./settings-registry.ts";
+export {
+  clearRegisteredSettings,
+  getRegisteredSettings,
+  registerSettings,
+} from "./settings-registry.ts";
+export { createInputSubmenu, openSettingsOverlay } from "./settings-ui.ts";
+export type { TitleTarget } from "./terminal.ts";
+export {
+  DONE_SYMBOL,
+  formatTitle,
+  signalBell,
+  signalDone,
+  signalWaiting,
+  WAITING_SYMBOL,
+} from "./terminal.ts";

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

@@ -0,0 +1 @@
+export { registerSettingsCommand as default } from "./settings-command.ts";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-web",
-  "version": "1.1.3",
+  "version": "1.3.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": {
@@ -25,7 +25,7 @@
     "@mozilla/readability": "^0.6.0",
     "turndown": "^7.2.0",
     "turndown-plugin-gfm": "^1.0.2",
-    "@mrclrchtr/supi-core": "1.1.3"
+    "@mrclrchtr/supi-core": "1.3.0"
   },
   "bundledDependencies": [
     "@mrclrchtr/supi-core"
@@ -44,9 +44,13 @@
   },
   "pi": {
     "extensions": [
-      "./src/web.ts",
-      "./src/docs.ts"
+      "./src/extension.ts"
     ]
   },
-  "main": "src/index.ts"
+  "main": "src/api.ts",
+  "exports": {
+    "./api": "./src/api.ts",
+    "./extension": "./src/extension.ts",
+    "./package.json": "./package.json"
+  }
 }

package/src/api.ts

@@ -0,0 +1,14 @@
+/**
+ * SuPi Web extension — public API exports.
+ */
+
+export { htmlToMarkdown, wrapAsCodeBlock } from "./convert.ts";
+export { default as docsExtension } from "./docs.ts";
+export {
+  FetchError,
+  type FetchOptions,
+  type FetchResult,
+  fetchWithNegotiation,
+  isValidHttpUrl,
+} from "./fetch.ts";
+export { default } from "./web.ts";

package/src/extension.ts

@@ -0,0 +1,7 @@
+import docsExtension from "./docs.ts";
+import webExtension from "./web.ts";
+
+export default function extension(pi: Parameters<typeof webExtension>[0]): void {
+  webExtension(pi);
+  docsExtension(pi);
+}