@j0hanz/superfetch 1.1.2 → 1.1.3

package/README.md

@@ -307,6 +307,8 @@ node dist/index.js --stdio
 
 ## Available Tools
 
+> **Note:** If extracted content exceeds `MAX_INLINE_CONTENT_CHARS`, the tool response includes a `resourceUri` and a `resource_link` content block instead of embedding the full text.
+
 ### `fetch-url`
 
 Fetches a webpage and converts it to AI-readable JSONL format with semantic content blocks.
@@ -635,6 +637,12 @@ Configure SuperFetch behavior by adding environment variables to your MCP client
 | `CACHE_TTL`      | `3600`  | `60`-`86400`     | Cache lifetime in seconds (1min-24hrs) |
 | `CACHE_MAX_KEYS` | `100`   | `10`-`1000`      | Maximum number of cached entries       |
 
+#### 📦 Output Settings
+
+| Variable                   | Default | Valid Values    | Description                                                     |
+| -------------------------- | ------- | --------------- | --------------------------------------------------------------- |
+| `MAX_INLINE_CONTENT_CHARS` | `20000` | `1000`-`200000` | Inline content limit before returning a `resource_link` instead |
+
 #### 📝 Logging Settings
 
 | Variable         | Default | Valid Values                        | Description                |
@@ -651,18 +659,26 @@ Configure SuperFetch behavior by adding environment variables to your MCP client
 
 #### 🛡️ Security Settings
 
-| Variable       | Default  | Description                                                                  |
-| -------------- | -------- | ---------------------------------------------------------------------------- |
-| `API_KEY`      | –        | API Key for authentication (required if `REQUIRE_AUTH` is true)              |
-| `REQUIRE_AUTH` | `true`\* | Require authentication (\*defaults to `false` on loopback unless configured) |
-| `ALLOW_REMOTE` | `false`  | Allow binding to non-loopback interfaces                                     |
+| Variable       | Default | Description                                              |
+| -------------- | ------- | -------------------------------------------------------- |
+| `API_KEY`      | -       | API Key for HTTP authentication (required for HTTP mode) |
+| `ALLOW_REMOTE` | `false` | Allow binding to non-loopback interfaces                 |
+
+#### Rate Limiting
+
+| Variable                | Default | Valid Values      | Description                          |
+| ----------------------- | ------- | ----------------- | ------------------------------------ |
+| `RATE_LIMIT_ENABLED`    | `true`  | `true` / `false`  | Enable/disable HTTP rate limiting    |
+| `RATE_LIMIT_MAX`        | `100`   | `1`-`10000`       | Max requests per window per IP       |
+| `RATE_LIMIT_WINDOW_MS`  | `60000` | `1000`-`3600000`  | Rate limit window in milliseconds    |
+| `RATE_LIMIT_CLEANUP_MS` | `60000` | `10000`-`3600000` | Cleanup interval for limiter entries |
 
 ### HTTP Mode Configuration
 
 <details>
 <summary><strong>HTTP Mode</strong> (Advanced) — For running as a standalone HTTP server</summary>
 
-SuperFetch can run as an HTTP server for custom integrations. HTTP mode requires additional configuration:
+SuperFetch can run as an HTTP server for custom integrations. HTTP mode requires additional configuration and an `API_KEY` for authenticated access (send `Authorization: Bearer <key>` or `X-API-Key: <key>`).
 
 #### Start HTTP Server
 
@@ -673,14 +689,15 @@ npx -y @j0hanz/superfetch@latest
 
 #### HTTP-Specific Environment Variables
 
-| Variable          | Default     | Description                                      |
-| ----------------- | ----------- | ------------------------------------------------ |
-| `PORT`            | `3000`      | HTTP server port                                 |
-| `HOST`            | `127.0.0.1` | HTTP server host (`0.0.0.0` for Docker/K8s)      |
-| `ALLOWED_ORIGINS` | `[]`        | Comma-separated CORS origins                     |
-| `CORS_ALLOW_ALL`  | `false`     | Allow all CORS origins (dev only, security risk) |
-| `SESSION_TTL_MS`  | `1800000`   | Session time-to-live in milliseconds (30 mins)   |
-| `MAX_SESSIONS`    | `200`       | Maximum number of active sessions                |
+| Variable                  | Default     | Description                                      |
+| ------------------------- | ----------- | ------------------------------------------------ |
+| `PORT`                    | `3000`      | HTTP server port                                 |
+| `HOST`                    | `127.0.0.1` | HTTP server host (`0.0.0.0` for Docker/K8s)      |
+| `ALLOWED_ORIGINS`         | `[]`        | Comma-separated CORS origins                     |
+| `CORS_ALLOW_ALL`          | `false`     | Allow all CORS origins (dev only, security risk) |
+| `SESSION_TTL_MS`          | `1800000`   | Session time-to-live in milliseconds (30 mins)   |
+| `SESSION_INIT_TIMEOUT_MS` | `10000`     | Time allowed for session initialization (ms)     |
+| `MAX_SESSIONS`            | `200`       | Maximum number of active sessions                |
 
 #### VS Code HTTP Mode Setup
 
@@ -749,7 +766,8 @@ Blocked headers: `host`, `authorization`, `cookie`, `x-forwarded-for`, `x-real-i
 
 ### Rate Limiting
 
-Default: **100 requests/minute** per IP (configurable)
+Default: **100 requests/minute** per IP. Configure with `RATE_LIMIT_MAX` and
+`RATE_LIMIT_WINDOW_MS`.
 
 ### HTTP Mode Endpoints
 
@@ -770,17 +788,20 @@ Sessions are managed via `mcp-session-id` header with 30-minute TTL.
 
 ### Scripts
 
-| Command              | Description                        |
-| -------------------- | ---------------------------------- |
-| `npm run dev`        | Development server with hot reload |
-| `npm run build`      | Compile TypeScript                 |
-| `npm start`          | Production server                  |
-| `npm run lint`       | Run ESLint                         |
-| `npm run type-check` | TypeScript type checking           |
-| `npm run format`     | Format with Prettier               |
-| `npm run release`    | Create new release                 |
-| `npm run knip`       | Find unused exports/dependencies   |
-| `npm run knip:fix`   | Auto-fix unused code               |
+| Command                 | Description                        |
+| ----------------------- | ---------------------------------- |
+| `npm run dev`           | Development server with hot reload |
+| `npm run build`         | Compile TypeScript                 |
+| `npm start`             | Production server                  |
+| `npm run lint`          | Run ESLint                         |
+| `npm run type-check`    | TypeScript type checking           |
+| `npm run format`        | Format with Prettier               |
+| `npm test`              | Run Vitest tests                   |
+| `npm run test:coverage` | Run tests with coverage            |
+| `npm run bench`         | Run minimal performance benchmark  |
+| `npm run release`       | Create new release                 |
+| `npm run knip`          | Find unused exports/dependencies   |
+| `npm run knip:fix`      | Auto-fix unused code               |
 
 ### Tech Stack
 
@@ -790,7 +811,7 @@ Sessions are managed via `mcp-session-id` header with 30-minute TTL.
 | Language           | TypeScript 5.9                    |
 | MCP SDK            | @modelcontextprotocol/sdk ^1.25.1 |
 | Content Extraction | @mozilla/readability ^0.6.0       |
-| HTML Parsing       | Cheerio ^1.1.2, JSDOM ^27.3.0     |
+| HTML Parsing       | Cheerio ^1.1.2, LinkeDOM ^0.18.12 |
 | Markdown           | Turndown ^7.2.2                   |
 | HTTP               | Express ^5.2.1, Axios ^1.7.9      |
 | Caching            | node-cache ^5.1.2                 |
@@ -803,8 +824,9 @@ Sessions are managed via `mcp-session-id` header with 30-minute TTL.
 1. Fork the repository
 2. Create a feature branch: `git checkout -b feature/amazing-feature`
 3. Ensure linting passes: `npm run lint`
-4. Commit changes: `git commit -m 'Add amazing feature'`
-5. Push: `git push origin feature/amazing-feature`
-6. Open a Pull Request
+4. Run tests: `npm test`
+5. Commit changes: `git commit -m 'Add amazing feature'`
+6. Push: `git push origin feature/amazing-feature`
+7. Open a Pull Request
 
 For examples of other MCP servers, see: [github.com/modelcontextprotocol/servers](https://github.com/modelcontextprotocol/servers)

package/dist/config/formatting.d.ts

@@ -0,0 +1,9 @@
+export declare const LINE_BREAK = "\n";
+export declare const TRUNCATION_MARKER = "...[truncated]";
+export declare const CODE_BLOCK: {
+    readonly fence: "```";
+    readonly format: (code: string, language?: string) => string;
+};
+export declare const FRONTMATTER_DELIMITER = "---";
+export declare const joinLines: (lines: string[]) => string;
+//# sourceMappingURL=formatting.d.ts.map

package/dist/config/formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../src/config/formatting.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,OAAO,CAAC;AAE/B,eAAO,MAAM,iBAAiB,mBAAmB,CAAC;AAElD,eAAO,MAAM,UAAU;;4BAEN,MAAM,wBAAkB,MAAM;CAGrC,CAAC;AAEX,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAE3C,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,EAAE,KAAG,MAAgC,CAAC"}

package/dist/config/formatting.js

@@ -0,0 +1,11 @@
+export const LINE_BREAK = '\n';
+export const TRUNCATION_MARKER = '...[truncated]';
+export const CODE_BLOCK = {
+    fence: '```',
+    format: (code, language = '') => {
+        return `\`\`\`${language}\n${code}\n\`\`\``;
+    },
+};
+export const FRONTMATTER_DELIMITER = '---';
+export const joinLines = (lines) => lines.join(LINE_BREAK);
+//# sourceMappingURL=formatting.js.map

package/dist/config/formatting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.js","sourceRoot":"","sources":["../../src/config/formatting.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC;AAE/B,MAAM,CAAC,MAAM,iBAAiB,GAAG,gBAAgB,CAAC;AAElD,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,CAAC,IAAY,EAAE,QAAQ,GAAG,EAAE,EAAU,EAAE;QAC9C,OAAO,SAAS,QAAQ,KAAK,IAAI,UAAU,CAAC;IAC9C,CAAC;CACO,CAAC;AAEX,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAE3C,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAe,EAAU,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC"}

package/dist/config/index.d.ts

@@ -1,10 +1,12 @@
+import type { LogLevel } from './types.js';
 export declare const config: {
     readonly server: {
         readonly name: "superFetch";
-        readonly version: "1.1.2";
+        readonly version: string;
         readonly port: number;
         readonly host: string;
         readonly sessionTtlMs: number;
+        readonly sessionInitTimeoutMs: number;
         readonly maxSessions: number;
     };
     readonly fetcher: {
@@ -25,13 +27,14 @@ export declare const config: {
         readonly minParagraphLength: 10;
     };
     readonly logging: {
-        readonly level: "debug" | "info" | "warn" | "error";
+        readonly level: LogLevel;
         readonly enabled: boolean;
     };
     readonly constants: {
         readonly maxHtmlSize: number;
         readonly maxContentSize: number;
         readonly maxUrlLength: 2048;
+        readonly maxInlineContentChars: number;
     };
     readonly security: {
         readonly blockedHosts: Set<string>;
@@ -41,5 +44,11 @@ export declare const config: {
         readonly allowRemote: boolean;
         readonly requireAuth: boolean;
     };
+    readonly rateLimit: {
+        readonly enabled: boolean;
+        readonly maxRequests: number;
+        readonly windowMs: number;
+        readonly cleanupIntervalMs: number;
+    };
 };
 //# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAyCA,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oCAiEV,SAAS,MAAM,EAAE;;;;;;CAahB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AA6D3C,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oCAgFV,SAAS,MAAM,EAAE;;;;;;;;;;;;CA6BhB,CAAC"}

package/dist/config/index.js

@@ -1,14 +1,20 @@
+import packageJson from '../../package.json' with { type: 'json' };
 function parseInteger(envValue, defaultValue, min, max) {
+    const parsed = parseRawInteger(envValue, defaultValue);
+    return clampInteger(parsed, defaultValue, min, max);
+}
+function parseRawInteger(envValue, defaultValue) {
     if (!envValue)
         return defaultValue;
     const parsed = parseInt(envValue, 10);
-    if (isNaN(parsed))
-        return defaultValue;
-    if (min !== undefined && parsed < min)
+    return Number.isNaN(parsed) ? defaultValue : parsed;
+}
+function clampInteger(value, defaultValue, min, max) {
+    if (min !== undefined && value < min)
         return defaultValue;
-    if (max !== undefined && parsed > max)
+    if (max !== undefined && value > max)
         return defaultValue;
-    return parsed;
+    return value;
 }
 function parseBoolean(envValue, defaultValue) {
     if (!envValue)
@@ -17,23 +23,29 @@ function parseBoolean(envValue, defaultValue) {
 }
 function parseLogLevel(envValue) {
     const level = envValue?.toLowerCase();
-    if (level === 'debug' ||
-        level === 'info' ||
-        level === 'warn' ||
-        level === 'error') {
-        return level;
-    }
-    return 'info';
+    if (!level)
+        return 'info';
+    return isLogLevel(level) ? level : 'info';
+}
+const ALLOWED_LOG_LEVELS = new Set([
+    'debug',
+    'info',
+    'warn',
+    'error',
+]);
+function isLogLevel(value) {
+    return ALLOWED_LOG_LEVELS.has(value);
 }
 const host = process.env.HOST ?? '127.0.0.1';
 const isLoopbackHost = host === '127.0.0.1' || host === '::1' || host === 'localhost';
 export const config = {
     server: {
         name: 'superFetch',
-        version: '1.1.2',
+        version: packageJson.version,
         port: parseInteger(process.env.PORT, 3000, 1024, 65535),
         host,
         sessionTtlMs: parseInteger(process.env.SESSION_TTL_MS, 30 * 60 * 1000, 60 * 1000, 24 * 60 * 60 * 1000),
+        sessionInitTimeoutMs: parseInteger(process.env.SESSION_INIT_TIMEOUT_MS, 10000, 1000, 60000),
         maxSessions: parseInteger(process.env.MAX_SESSIONS, 200, 10, 10000),
     },
     fetcher: {
@@ -61,6 +73,7 @@ export const config = {
         maxHtmlSize: 10 * 1024 * 1024,
         maxContentSize: 5 * 1024 * 1024,
         maxUrlLength: 2048,
+        maxInlineContentChars: parseInteger(process.env.MAX_INLINE_CONTENT_CHARS, 20000, 1000, 200000),
     },
     security: {
         blockedHosts: new Set([
@@ -81,12 +94,15 @@ export const config = {
             /^127\./,
             /^0\./,
             /^169\.254\./,
+            /^100\.64\./,
             /^fc00:/i,
+            /^fd00:/i,
             /^fe80:/i,
             /^::ffff:127\./,
             /^::ffff:10\./,
             /^::ffff:172\.(1[6-9]|2\d|3[01])\./,
             /^::ffff:192\.168\./,
+            /^::ffff:169\.254\./,
         ],
         blockedHeaders: new Set([
             'host',
@@ -100,5 +116,11 @@ export const config = {
         allowRemote: parseBoolean(process.env.ALLOW_REMOTE, false),
         requireAuth: parseBoolean(process.env.REQUIRE_AUTH, !isLoopbackHost),
     },
+    rateLimit: {
+        enabled: parseBoolean(process.env.RATE_LIMIT_ENABLED, true),
+        maxRequests: parseInteger(process.env.RATE_LIMIT_MAX, 100, 1, 10000),
+        windowMs: parseInteger(process.env.RATE_LIMIT_WINDOW_MS, 60000, 1000, 3600000),
+        cleanupIntervalMs: parseInteger(process.env.RATE_LIMIT_CLEANUP_MS, 60000, 10000, 3600000),
+    },
 };
 //# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"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"}

package/dist/config/types/content.d.ts

@@ -0,0 +1,107 @@
+type ContentBlockType = 'metadata' | 'heading' | 'paragraph' | 'list' | 'code' | 'table' | 'image' | 'blockquote';
+interface ContentBlock {
+    type: ContentBlockType;
+}
+export interface MetadataBlock extends ContentBlock {
+    type: 'metadata';
+    title?: string;
+    description?: string;
+    author?: string;
+    url: string;
+    fetchedAt: string;
+}
+export interface HeadingBlock extends ContentBlock {
+    type: 'heading';
+    level: number;
+    text: string;
+}
+export interface ParagraphBlock extends ContentBlock {
+    type: 'paragraph';
+    text: string;
+}
+export interface ListBlock extends ContentBlock {
+    type: 'list';
+    ordered: boolean;
+    items: string[];
+}
+export interface CodeBlock extends ContentBlock {
+    type: 'code';
+    language?: string;
+    text: string;
+}
+export interface TableBlock extends ContentBlock {
+    type: 'table';
+    headers?: string[];
+    rows: string[][];
+}
+export interface ImageBlock extends ContentBlock {
+    type: 'image';
+    src: string;
+    alt?: string;
+}
+export interface BlockquoteBlock extends ContentBlock {
+    type: 'blockquote';
+    text: string;
+}
+export type ContentBlockUnion = MetadataBlock | HeadingBlock | ParagraphBlock | ListBlock | CodeBlock | TableBlock | ImageBlock | BlockquoteBlock;
+export interface ExtractedArticle {
+    title?: string;
+    byline?: string;
+    content: string;
+    textContent: string;
+    excerpt?: string;
+    siteName?: string;
+}
+export interface CacheEntry {
+    url: string;
+    content: string;
+    fetchedAt: string;
+    expiresAt: string;
+}
+export interface ExtractedLink {
+    href: string;
+    text: string;
+    type: LinkType;
+}
+export interface ExtractedMetadata {
+    title?: string;
+    description?: string;
+    author?: string;
+}
+export interface ExtractionResult {
+    article: ExtractedArticle | null;
+    metadata: ExtractedMetadata;
+}
+export type ParseableTagName = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'p' | 'ul' | 'ol' | 'pre' | 'code' | 'table' | 'img' | 'blockquote';
+export interface LinksTransformResult {
+    links: ExtractedLink[];
+    linkCount: number;
+    filtered: number;
+    truncated: boolean;
+}
+export interface ExtractLinksOptions {
+    includeInternal: boolean;
+    includeExternal: boolean;
+    includeImages: boolean;
+    maxLinks?: number;
+    filterPattern?: RegExp;
+}
+export interface MarkdownTransformResult {
+    markdown: string;
+    title: string | undefined;
+    truncated: boolean;
+}
+export interface TransformOptions {
+    extractMainContent: boolean;
+    includeMetadata: boolean;
+    maxContentLength?: number;
+}
+export interface JsonlTransformResult {
+    content: string;
+    contentBlocks: number;
+    title: string | undefined;
+    truncated?: boolean;
+}
+export type LinkType = 'internal' | 'external' | 'image';
+export {};
+//# sourceMappingURL=content.d.ts.map

package/dist/config/types/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../src/config/types/content.ts"],"names":[],"mappings":"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"}

package/dist/config/types/content.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=content.js.map

package/dist/config/types/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../../src/config/types/content.ts"],"names":[],"mappings":""}

package/dist/config/types/runtime.d.ts

@@ -0,0 +1,78 @@
+import type { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+export interface RateLimitEntry {
+    count: number;
+    resetTime: number;
+    lastAccessed: number;
+}
+export interface RateLimiterOptions {
+    maxRequests: number;
+    windowMs: number;
+    cleanupIntervalMs: number;
+}
+export type ToolContentBlock = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'resource_link';
+    uri: string;
+    name: string;
+    title?: string;
+    description?: string;
+    mimeType?: string;
+};
+export interface FetchOptions {
+    customHeaders?: Record<string, string>;
+    signal?: AbortSignal;
+    timeout?: number;
+}
+export interface ContentTransformOptions {
+    readonly extractMainContent: boolean;
+    readonly includeMetadata: boolean;
+}
+export interface TruncationResult {
+    readonly content: string;
+    readonly truncated: boolean;
+}
+export interface SessionEntry {
+    readonly transport: StreamableHTTPServerTransport;
+    createdAt: number;
+    lastSeen: number;
+}
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export type LogMetadata = Record<string, unknown>;
+export interface McpRequestBody {
+    method?: string;
+    id?: string | number;
+    jsonrpc?: '2.0';
+    params?: unknown;
+}
+export interface FetchPipelineOptions<T> {
+    /** URL to fetch */
+    url: string;
+    /** Cache namespace (e.g., 'url', 'links', 'markdown') */
+    cacheNamespace: string;
+    /** Optional custom HTTP headers */
+    customHeaders?: Record<string, string>;
+    /** Optional: number of retry attempts (1-10, defaults to 3) */
+    retries?: number;
+    /** Optional: AbortSignal for request cancellation */
+    signal?: AbortSignal;
+    /** Optional: per-request timeout override in milliseconds */
+    timeout?: number;
+    /** Optional: cache variation input for headers/flags */
+    cacheVary?: Record<string, unknown> | string;
+    /** Transform function to process HTML into desired format */
+    transform: (html: string, url: string) => T;
+    /** Optional: serialize result for caching (defaults to JSON.stringify) */
+    serialize?: (result: T) => string;
+    /** Optional: deserialize cached content */
+    deserialize?: (cached: string) => T | undefined;
+}
+export interface PipelineResult<T> {
+    data: T;
+    fromCache: boolean;
+    url: string;
+    fetchedAt: string;
+    cacheKey?: string | null;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/config/types/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/config/types/runtime.ts"],"names":[],"mappings":"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"}

package/dist/config/types/runtime.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime.js.map

package/dist/config/types/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/config/types/runtime.ts"],"names":[],"mappings":""}

package/dist/config/types/tools.d.ts

@@ -0,0 +1,99 @@
+import type { ToolContentBlock } from './runtime.js';
+interface RequestOptions {
+    /** Custom HTTP headers for the request */
+    customHeaders?: Record<string, string>;
+    /** Request timeout in milliseconds (1000-60000) */
+    timeout?: number;
+    /** Number of retry attempts (1-10) */
+    retries?: number;
+}
+export interface FetchUrlInput extends RequestOptions {
+    url: string;
+    extractMainContent?: boolean;
+    includeMetadata?: boolean;
+    maxContentLength?: number;
+    format?: 'jsonl' | 'markdown';
+}
+export interface FetchLinksInput extends RequestOptions {
+    url: string;
+    includeExternal?: boolean;
+    includeInternal?: boolean;
+    maxLinks?: number;
+    filterPattern?: string;
+    includeImages?: boolean;
+}
+export interface FetchMarkdownInput extends RequestOptions {
+    url: string;
+    extractMainContent?: boolean;
+    includeMetadata?: boolean;
+    maxContentLength?: number;
+}
+export interface FetchUrlsInput extends RequestOptions {
+    urls: string[];
+    extractMainContent?: boolean;
+    includeMetadata?: boolean;
+    maxContentLength?: number;
+    format?: 'jsonl' | 'markdown';
+    concurrency?: number;
+    continueOnError?: boolean;
+}
+export interface ErrorResponse {
+    error: {
+        message: string;
+        code: string;
+        statusCode: number;
+        details?: Record<string, unknown>;
+        stack?: string;
+    };
+}
+export interface ToolResponse<T = Record<string, unknown>> {
+    [x: string]: unknown;
+    content: ToolContentBlock[];
+    structuredContent: T & Record<string, unknown>;
+}
+export interface BatchUrlResult {
+    url: string;
+    success: boolean;
+    title?: string;
+    content?: string;
+    contentBlocks?: number;
+    contentSize?: number;
+    resourceUri?: string;
+    resourceMimeType?: string;
+    cached?: boolean;
+    truncated?: boolean;
+    error?: string;
+    errorCode?: string;
+}
+export interface BatchSummary {
+    total: number;
+    successful: number;
+    failed: number;
+    cached: number;
+    totalContentBlocks: number;
+}
+export interface BatchResponseContent {
+    [x: string]: unknown;
+    results: BatchUrlResult[];
+    summary: BatchSummary;
+    fetchedAt: string;
+}
+export interface ToolErrorResponse {
+    [x: string]: unknown;
+    content: ToolContentBlock[];
+    structuredContent: {
+        [x: string]: unknown;
+        error: string;
+        url: string;
+        errorCode: string;
+    };
+    isError: true;
+}
+export interface ToolResponseBase {
+    [x: string]: unknown;
+    content: ToolContentBlock[];
+    structuredContent?: Record<string, unknown>;
+    isError?: boolean;
+}
+export {};
+//# sourceMappingURL=tools.d.ts.map