@onedotmint/siftpath 0.0.0-stage → 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 GuDaStudio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,166 @@
-# Temporary Holding Version
+# Siftpath
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Siftpath is a small TypeScript/Node.js 22+ MCP router for AI agents. It exposes exactly two model-facing tools:
+
+- `web_search({ query, intent?, maxResults? })`
+- `web_read({ url, focus? })`
+
+It does not search, parse HTML, chunk, rerank, merge, or run an LLM. It lazily connects to configured official MCP servers, maps the two stable inputs to their configured tool names, forwards the official result, keeps source URLs, bounds the serialized output, and tries configured fallbacks sequentially.
+
+## Install and run
+
+Install the stable release (Node.js 22+; npm `latest` tag):
+
+```bash
+npm install -g @onedotmint/siftpath@latest
+siftpath --version
+siftpath setup
+siftpath status
+```
+
+Alternatively, build from an existing source checkout:
+
+```bash
+npm ci
+npm run build
+# Optional: npm link (installs the siftpath command for this source checkout)
+node dist/cli.js mcp
+```
+
+In an MCP client, the simplest local configuration is:
+
+```json
+{
+  "mcpServers": {
+    "siftpath": {
+      "command": "node",
+      "args": ["/absolute/path/to/Siftpath/dist/cli.js", "mcp"]
+    }
+  }
+}
+```
+
+The same process serves stdio MCP. It requires no Docker, database, browser, background daemon, local model, or HTTP server.
+
+With the global npm install or `npm link` (otherwise replace `siftpath` with `node dist/cli.js`):
+
+```bash
+siftpath doctor
+siftpath search "Node.js 22 release notes" --intent general
+siftpath search "semantic similarity API" --intent semantic --max-results 5
+siftpath read https://example.com --focus "What is this page about?"
+```
+
+To install the single package elsewhere, run `npm pack` here, then `npm install /absolute/path/to/onedotmint-siftpath-2.0.0.tgz` in the consuming project (or `npm install -g` for the CLI). The tarball includes compiled runtime, declarations, docs and the anonymous config example.
+
+SDK example:
+
+```ts
+import { Siftpath, readConfiguration } from '@onedotmint/siftpath';
+const siftpath = new Siftpath(await readConfiguration());
+try {
+  const result = await siftpath.search({ query: 'Node.js documentation' });
+  console.log(result.content, result.sources);
+} finally { await siftpath.close(); }
+```
+
+## Try without provider keys
+
+Exa and Jina currently offer anonymous hosted MCP access. To opt in (quotas/availability may change):
+
+```bash
+SIFTPATH_CONFIG="$PWD/examples/anonymous.json" node dist/cli.js search "Node.js documentation"
+SIFTPATH_CONFIG="$PWD/examples/anonymous.json" node dist/cli.js read https://example.com
+```
+
+For a local MCP client, add `"env": { "SIFTPATH_CONFIG": "/absolute/path/to/Siftpath/examples/anonymous.json" }` to the server entry above. Brave remains the general primary when a key exists, otherwise it falls back to Exa. These examples write no private configuration or secrets. See [配置与可选服务](docs/CONFIGURATION.md), [接口核验](docs/PROVIDERS.md), [验证记录](docs/TESTING.md), [迁移](docs/MIGRATION.md), and [安全边界](docs/SECURITY.md).
+
+## Configuration
+
+Run `siftpath setup` for the Clack wizard: arrows navigate, Space selects providers, Enter confirms, Esc/Ctrl+C cancels without saving. Select Brave/Exa/Tavily/Jina/Firecrawl, keep or replace hidden Keys (or explicitly choose supported anonymous access), choose default search/read and ordered fallback, then optionally confirm real tests. No tool-name/JSON editing is required.
+
+`setup --non-interactive` only creates minimal defaults at `~/.config/siftpath/config.json` (or `SIFTPATH_CONFIG`). Keys can also be supplied as environment variables. Configuration is private JSON, written atomically with mode 0600; secrets are never printed or put into model schemas.
+
+The built-in routes are:
+
+- general/default search → Brave `brave_web_search`
+- semantic search → Exa `web_search_exa`
+- research → optional configured provider (Tavily is an example)
+- read → Jina `read_url`, with `focus` mapped to its native `question` parameter
+
+Only a provider with a complete connection and all required credential references resolved is attempted. The default config uses:
+
+- Brave stdio: `npx -y @brave/brave-search-mcp-server@2.1.4 --transport stdio`, `BRAVE_API_KEY`
+- Exa stdio: `npx -y exa-mcp-server@3.4.2`, `EXA_API_KEY`
+- Jina Streamable HTTP: `https://mcp.jina.ai/v1`, `JINA_API_KEY` for the default authenticated route; anonymous reading is an explicit opt-in
+
+The versions and tool names above were checked against the official repositories on this rebuild. Check the official servers before upgrading: hosted/runtime schemas can change independently of their source README. Jina `question` is native; if a configured reader has no `$focus` mapping, Siftpath returns `FOCUS_UNSUPPORTED` rather than pretending to extract locally.
+
+Minimal custom provider example:
+
+```json
+{
+  "version": 2,
+  "providers": {
+    "brave": {
+      "enabled": true,
+      "connection": {
+        "transport": "stdio",
+        "command": "npx",
+        "args": ["-y", "@brave/brave-search-mcp-server@2.1.4", "--transport", "stdio"],
+        "env": { "BRAVE_API_KEY": "${BRAVE_API_KEY}" }
+      },
+      "search": {
+        "name": "brave_web_search",
+        "arguments": { "query": "$query", "count": "$maxResults" }
+      }
+    }
+  },
+  "routes": { "search": "brave", "read": "jina", "intents": {}, "searchFallback": [], "readFallback": [] }
+}
+```
+
+Connection transports are `stdio` (`command`, `args`, `env`) and Streamable HTTP (`url`, `headers`). HTTP URLs reject credentials, query-string secrets, and insecure non-loopback HTTP. Use `${ENV_NAME}` in connection env/headers, never in commands, arguments or URLs; environment variables override saved credentials. `doctor` reports `READY`, `MISSING_CREDENTIALS`, `DISABLED`, and unsupported route diagnostics without making network calls.
+
+Tavily and Firecrawl have built-in presets, disabled until selected in `setup`. Tavily uses official `tavily-mcp@0.2.22` / `tavily_search` (basic, 5–20 results), with a Key or its native stdio Keyless mode. Firecrawl uses official `firecrawl-mcp@3.33.4` / `firecrawl_scrape` with a Key, or the official anonymous hosted MCP. Both were verified through real MCP calls. See [配置向导](docs/CONFIGURATION.md). Clack 1.8.1 and esbuild 0.25.12 are build-only: the ~111 KiB setup bundle is dynamically loaded only in interactive setup, with no new runtime dependency.
+
+## Output and safety
+
+Each successful result includes the selected provider, official tool name, retrieval timestamp, original URL where relevant, traceable public source URLs, `UNTRUSTED_WEB_CONTENT`, fallback diagnostics, and `truncated`/`sourcesTruncated` flags. The returned `content` is official output, not a Siftpath-generated answer. Treat it as data, never instructions.
+
+Public HTTP(S) URLs only are accepted for reads. IP literals, local names, credentials and reverse-DNS names are rejected. Provider failures are sanitized into stable diagnostics; raw upstream bodies, API keys and URLs containing credentials are not returned. Connections are initialized on first use, reused within one process, and closed on normal MCP shutdown.
+
+## Status and Pi command
+
+```bash
+siftpath status                 # offline, never treats READY as tested availability
+siftpath status --json
+siftpath test brave --json      # real request to this provider only; no fallback
+siftpath test all               # sequential checks, may use API quota
+
+# Install the Pi command extension from the stable npm release:
+pi install npm:@onedotmint/siftpath@latest
+
+# Source-checkout alternatives (choose one instead of the npm install):
+# After building, try without changing Pi settings:
+pi -e /absolute/path/to/Siftpath/extensions/siftpath.mjs
+# Or install persistently: pi install /absolute/path/to/Siftpath
+```
+
+After installation, restart Pi or run `/reload`. In Pi: `/siftpath`, `/siftpath test brave`, `/siftpath test all`. The extension uses the same private configuration and credential environment as the CLI; set `SIFTPATH_CONFIG` before starting Pi to select another file. The extension only invokes the packaged CLI and displays its summary using native notifications. No model tools are added. Connection, tool discovery and real-request stages are reported separately; recent results are stored privately alongside the selected config, with changed configurations marked stale. See [诊断与 Pi 安装/真实验收](docs/DIAGNOSTICS.md).
+
+## Tests and verification
+
+```bash
+npm run typecheck
+npm test
+npm run test:live                 # skips network/quota tests unless explicitly enabled
+SIFTPATH_LIVE=1 npm run test:live # Exa anonymous + Jina anonymous in this rebuild
+SIFTPATH_CONTRACT=1 npm run test:live # tools/list contract checks only
+```
+
+Offline tests use real MCP SDK fixture processes and local HTTP MCP servers, not mocked vendor HTTP APIs: 81 tests cover tool exposure, stdio, Streamable HTTP, configuration, fallback, cancellation, timeout, output bounds, URL safety, provenance and shutdown. This repository run also verified real anonymous Exa search and Jina read, plus the full Siftpath stdio path. Brave real search was not verified because `BRAVE_API_KEY` was absent. Tavily anonymous official stdio search and Firecrawl anonymous hosted reading were also live-tested; account Key flows were not verified.
+
+## Deliberate non-goals
+
+The old EvidenceEngine, Gather path, multi-provider fusion, custom relevance scoring, sufficiency judgment, HTTP server, old Pi model-tool extension, generated host plugins, and research orchestration were removed from the active package. Siftpath is not a search engine or answer generator; official MCP services own those capabilities.

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,26 @@
+# Third-party notices
+
+The repository's MIT LICENSE is preserved from SmartSearch at `a6e310d8c51d1fb9eb454d27afbbc3f81cc2e61a`, including Copyright (c) 2025 GuDaStudio.
+
+This rebuild retains and adapts the project's private JSON configuration storage, hidden credential entry, public URL guard, CLI conventions and package-version reader. The old evidence engine and historical evaluation fixtures are no longer distributed.
+
+Runtime npm dependencies are @modelcontextprotocol/sdk (MIT) and Zod (MIT), with transitive dependencies installed from their registries; inspect package-lock.json and the installed packages' licenses. TypeScript (Apache-2.0), @types/node (MIT), undici-types (MIT) are development dependencies. Official provider MCP packages are launched separately on demand and retain their own licenses/terms.
+
+Official provider source and web-search-plus-mcp/agntn-web were interface/design references, not vendored implementation. Precise links and inspected revisions: docs/PROVIDERS.md. No upstream search/reader/ranking implementation is copied into Siftpath.
+
+## Bundled interactive setup
+
+The lazily loaded `dist/setup-ui.js` bundles @clack/prompts 1.8.1, @clack/core 1.5.1, sisteransi 1.0.5, fast-wrap-ansi 0.2.2, fast-string-width 3.0.2 and fast-string-truncated-width 3.0.3 (all MIT). Clack and esbuild 0.25.12 are build-only dependencies, not runtime package requirements.
+
+Copyright notices for bundled MIT code:
+
+- Copyright (c) 2025-Present Bombshell contributors (https://bomb.sh/team) — Clack
+- Copyright (c) 2018 Terkel Gjervig Nielsen — sisteransi
+- Copyright (c) 2024-present Fabio Spampinato — fast-string-width / fast-string-truncated-width
+- Copyright (c) 2025 James Garbutt; Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com) — fast-wrap-ansi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export declare function main(argv?: string[]): Promise<void>;

package/dist/cli.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+import { realpathSync } from 'node:fs';
+import { parseArgs } from 'node:util';
+import { fileURLToPath } from 'node:url';
+import { configPath, readConfiguration, diagnostics } from './config.js';
+import { statusReport, testReport, formatStatus, formatTests } from './diagnostics.js';
+import { SiftpathError, safeError } from './errors.js';
+import { Siftpath } from './router.js';
+import { serveStdio } from './mcp/stdio.js';
+import { setup } from './setup.js';
+import { packageVersion } from './version.js';
+import { invokeTool } from './tools.js';
+const help = `Siftpath — lightweight official MCP router (Node.js 22+)
+  siftpath mcp
+  siftpath search "question" [--intent general|semantic|research] [--max-results 5]
+  siftpath read URL [--focus "question about the page"]
+  siftpath status [--json]               # offline configuration and last tests
+  siftpath test <provider|all> [--json]   # real requests, no fallback; may use API quota
+  siftpath doctor
+  siftpath setup [--non-interactive]     # Clack provider/Key/routes wizard; tests are opt-in
+  siftpath --version
+Configuration: SIFTPATH_CONFIG or ~/.config/siftpath/config.json (JSON).
+Keys: BRAVE_API_KEY, EXA_API_KEY, JINA_API_KEY; optional TAVILY_API_KEY, FIRECRAWL_API_KEY.
+Only the selected provider is called; failures try configured fallbacks sequentially.
+`;
+export async function main(argv = process.argv.slice(2)) {
+    let parsed;
+    try {
+        parsed = parseArgs({ args: argv, allowPositionals: true, strict: true, options: {
+                help: { type: 'boolean', short: 'h' }, version: { type: 'boolean', short: 'v' }, intent: { type: 'string' },
+                json: { type: 'boolean' }, 'max-results': { type: 'string' }, focus: { type: 'string' }, 'non-interactive': { type: 'boolean' },
+            } });
+    }
+    catch {
+        throw new SiftpathError('INVALID_INPUT', 'Invalid command-line arguments. Run siftpath --help.');
+    }
+    const { values, positionals: [command, ...args] } = parsed;
+    if (command === 'search' && values.focus !== undefined || command === 'read' && (values.intent !== undefined || values['max-results'] !== undefined))
+        throw new SiftpathError('INVALID_INPUT', 'Options do not match the selected command. Run siftpath --help.');
+    if (values.help || !command && !values.version) {
+        process.stdout.write(help);
+        return;
+    }
+    if (values.version) {
+        process.stdout.write(packageVersion + '\n');
+        return;
+    }
+    if (command === 'setup') {
+        await setup(Boolean(values['non-interactive']));
+        return;
+    }
+    if (!['mcp', 'search', 'read', 'doctor', 'status', 'test'].includes(command))
+        throw new SiftpathError('INVALID_INPUT', 'Unknown command. Run siftpath --help.');
+    const config = await readConfiguration();
+    if (command === 'doctor') {
+        process.stdout.write(JSON.stringify(diagnostics(config), null, 2) + '\n');
+        return;
+    }
+    if (command === 'status') {
+        if (args.length)
+            throw new SiftpathError('INVALID_INPUT', 'status takes no positional arguments.');
+        const report = await statusReport(config);
+        process.stdout.write((values.json ? JSON.stringify({ ...report, summary: formatStatus(report) }) : formatStatus(report)) + '\n');
+        return;
+    }
+    if (command === 'test') {
+        if (args.length !== 1)
+            throw new SiftpathError('INVALID_INPUT', 'Use siftpath test <provider|all> [--json].');
+        const controller = new AbortController(), stop = () => controller.abort();
+        process.once('SIGINT', stop);
+        process.once('SIGTERM', stop);
+        try {
+            const report = await testReport(config, args[0], configPath(), process.env, controller.signal);
+            process.stdout.write((values.json ? JSON.stringify({ ...report, summary: formatTests(report) }) : formatTests(report)) + '\n');
+            if (!report.ok)
+                process.exitCode = controller.signal.aborted ? 130 : 1;
+        }
+        finally {
+            process.off('SIGINT', stop);
+            process.off('SIGTERM', stop);
+        }
+        return;
+    }
+    const router = new Siftpath(config);
+    if (command === 'mcp') {
+        try {
+            await serveStdio(router);
+        }
+        finally {
+            await router.close();
+        }
+        return;
+    }
+    const controller = new AbortController(), stop = () => controller.abort();
+    process.once('SIGINT', stop);
+    process.once('SIGTERM', stop);
+    try {
+        if (command === 'read' && args.length !== 1)
+            throw new SiftpathError('INVALID_INPUT', 'read requires exactly one URL.');
+        const input = command === 'search'
+            ? { query: args.join(' '), ...(values.intent !== undefined ? { intent: values.intent } : {}),
+                ...(values['max-results'] !== undefined ? { maxResults: Number(values['max-results']) } : {}) }
+            : { url: args[0], ...(values.focus !== undefined ? { focus: values.focus } : {}) };
+        const result = await invokeTool(router, `web_${command}`, input, { signal: controller.signal });
+        process.stdout.write(JSON.stringify(result) + '\n');
+    }
+    finally {
+        process.off('SIGINT', stop);
+        process.off('SIGTERM', stop);
+        await router.close();
+    }
+}
+if (process.argv[1] && realpathSync(process.argv[1]) === fileURLToPath(import.meta.url)) {
+    main().catch(error => { const safe = safeError(error); process.stderr.write(JSON.stringify(safe) + '\n'); process.exitCode = safe.code === 'ABORTED' ? 130 : 1; });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,144 @@
+import { type Configuration } from './config.js';
+export declare function abortable<T>(promise: Promise<T>, signal: AbortSignal): Promise<T>;
+/** One lazy connection per configured MCP, shared by all router calls in this process. */
+export declare class McpClients {
+    private config;
+    private env;
+    private connections;
+    private closed;
+    private closing?;
+    private requestSignal;
+    private fetch;
+    constructor(config: Configuration, env?: NodeJS.ProcessEnv);
+    private get;
+    connect(id: string, signal: AbortSignal): Promise<void>;
+    listTools(id: string, signal: AbortSignal, cursor?: string): Promise<{
+        [x: string]: unknown;
+        tools: {
+            inputSchema: {
+                [x: string]: unknown;
+                type: "object";
+                properties?: Record<string, object> | undefined;
+                required?: string[] | undefined;
+            };
+            name: string;
+            description?: string | undefined;
+            outputSchema?: {
+                [x: string]: unknown;
+                type: "object";
+                properties?: Record<string, object> | undefined;
+                required?: string[] | undefined;
+            } | undefined;
+            annotations?: {
+                title?: string | undefined;
+                readOnlyHint?: boolean | undefined;
+                destructiveHint?: boolean | undefined;
+                idempotentHint?: boolean | undefined;
+                openWorldHint?: boolean | undefined;
+            } | undefined;
+            execution?: {
+                taskSupport?: "optional" | "required" | "forbidden" | undefined;
+            } | undefined;
+            _meta?: Record<string, unknown> | undefined;
+            icons?: {
+                src: string;
+                mimeType?: string | undefined;
+                sizes?: string[] | undefined;
+                theme?: "light" | "dark" | undefined;
+            }[] | undefined;
+            title?: string | undefined;
+        }[];
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+        nextCursor?: string | undefined;
+    }>;
+    call(id: string, name: string, args: Record<string, unknown>, signal: AbortSignal): Promise<{
+        [x: string]: unknown;
+        content: ({
+            type: "text";
+            text: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: Record<string, unknown> | undefined;
+        } | {
+            type: "image";
+            data: string;
+            mimeType: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: Record<string, unknown> | undefined;
+        } | {
+            type: "audio";
+            data: string;
+            mimeType: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: Record<string, unknown> | undefined;
+        } | {
+            uri: string;
+            name: string;
+            type: "resource_link";
+            description?: string | undefined;
+            mimeType?: string | undefined;
+            size?: number | undefined;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            icons?: {
+                src: string;
+                mimeType?: string | undefined;
+                sizes?: string[] | undefined;
+                theme?: "light" | "dark" | undefined;
+            }[] | undefined;
+            title?: string | undefined;
+        } | {
+            type: "resource";
+            resource: {
+                uri: string;
+                text: string;
+                mimeType?: string | undefined;
+                _meta?: Record<string, unknown> | undefined;
+            } | {
+                uri: string;
+                blob: string;
+                mimeType?: string | undefined;
+                _meta?: Record<string, unknown> | undefined;
+            };
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: Record<string, unknown> | undefined;
+        })[];
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+        structuredContent?: Record<string, unknown> | undefined;
+        isError?: boolean | undefined;
+    }>;
+    close(): Promise<void>;
+}

package/dist/client.js

@@ -0,0 +1,130 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport, getDefaultEnvironment } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { StreamableHTTPClientTransport, StreamableHTTPError } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { CallToolResultSchema, ListToolsResultSchema } from '@modelcontextprotocol/sdk/types.js';
+import { providerStatus, resolveSecret } from './config.js';
+import { SiftpathError } from './errors.js';
+import { packageVersion } from './version.js';
+export async function abortable(promise, signal) {
+    return new Promise((resolve, reject) => {
+        const abort = () => reject(signal.reason);
+        promise.then(resolve, reject).finally(() => signal.removeEventListener('abort', abort));
+        if (signal.aborted)
+            abort();
+        else
+            signal.addEventListener('abort', abort, { once: true });
+    });
+}
+/** One lazy connection per configured MCP, shared by all router calls in this process. */
+export class McpClients {
+    config;
+    env;
+    connections = new Map();
+    closed = false;
+    closing;
+    requestSignal = new AsyncLocalStorage();
+    fetch = async (input, init) => {
+        const operation = this.requestSignal.getStore();
+        const signals = [init?.signal, init?.method === 'GET' ? undefined : operation].filter((s) => !!s);
+        const response = await globalThis.fetch(input, { ...init, signal: signals.length ? AbortSignal.any(signals) : undefined });
+        if (!response.body)
+            return response;
+        let bytes = 0;
+        const body = response.body.pipeThrough(new TransformStream({
+            transform(chunk, controller) {
+                bytes += chunk.byteLength;
+                if (bytes > 4 * 1024 * 1024) {
+                    controller.error(new SiftpathError('RESPONSE_TOO_LARGE', 'Official MCP response exceeded 4 MiB.'));
+                    return;
+                }
+                controller.enqueue(chunk);
+            },
+        }));
+        return new Response(body, { status: response.status, statusText: response.statusText, headers: response.headers });
+    };
+    constructor(config, env = process.env) {
+        this.config = config;
+        this.env = env;
+    }
+    get(id) {
+        if (this.closed)
+            throw new SiftpathError('CLOSED', 'Siftpath has been closed.');
+        const existing = this.connections.get(id);
+        if (existing)
+            return existing.ready;
+        const status = providerStatus(id, this.config, this.env);
+        if (status.code !== 'READY')
+            throw new SiftpathError(status.code, 'Provider is unavailable.', [status]);
+        const provider = this.config.providers[id], c = provider.connection;
+        const values = (entries) => Object.fromEntries(Object.entries(entries).map(([key, val]) => [key, resolveSecret(val, this.config, this.env)]));
+        const transport = c.transport === 'stdio'
+            ? new StdioClientTransport({ command: c.command, args: c.args, env: { ...getDefaultEnvironment(), ...values(c.env) }, stderr: 'ignore', maxBufferSize: 4 * 1024 * 1024 })
+            : new StreamableHTTPClientTransport(new URL(c.url), { fetch: this.fetch, requestInit: { headers: values(c.headers), redirect: 'error' },
+                reconnectionOptions: { maxRetries: 0, initialReconnectionDelay: 1000, maxReconnectionDelay: 1000, reconnectionDelayGrowFactor: 1 } });
+        const client = new Client({ name: 'siftpath', version: packageVersion });
+        client.onerror = () => { }; // Upstream messages may contain credentials; expose only our stable error codes.
+        const timeout = provider.timeoutMs ?? this.config.providerTimeoutMs;
+        const deadline = AbortSignal.timeout(timeout);
+        const ready = abortable(this.requestSignal.run(deadline, () => client.connect(transport, { timeout, signal: deadline })), deadline).then(() => client).catch(async (error) => {
+            if (this.connections.get(id)?.client === client)
+                this.connections.delete(id);
+            await client.close().catch(() => { });
+            const code = deadline.aborted ? 'PROVIDER_TIMEOUT' : error instanceof StreamableHTTPError && [401, 403].includes(error.code ?? 0) ? 'AUTH_FAILED'
+                : error instanceof StreamableHTTPError && error.code === 429 ? 'RATE_LIMITED' : 'CONNECTION_FAILED';
+            throw new SiftpathError(code, 'Cannot connect to official MCP. Check configuration, credentials and connectivity.');
+        });
+        this.connections.set(id, { client, transport, ready });
+        // The SDK invokes onclose when the underlying transport exits/disconnects.
+        client.onclose = () => { if (this.connections.get(id)?.client === client)
+            this.connections.delete(id); };
+        return ready;
+    }
+    async connect(id, signal) {
+        await abortable(this.get(id), signal);
+    }
+    async listTools(id, signal, cursor) {
+        const client = await abortable(this.get(id), signal);
+        // SDK listTools replaces its metadata cache per page; diagnostics retain and validate the complete list themselves.
+        return this.requestSignal.run(signal, () => abortable(client.request({ method: 'tools/list', params: cursor ? { cursor } : {} }, ListToolsResultSchema, { signal,
+            timeout: this.config.providers[id].timeoutMs ?? this.config.providerTimeoutMs }), signal));
+    }
+    async call(id, name, args, signal) {
+        const client = await abortable(this.get(id), signal);
+        signal.throwIfAborted();
+        try {
+            const result = await this.requestSignal.run(signal, () => abortable(client.callTool({ name, arguments: args }, CallToolResultSchema, { signal,
+                timeout: this.config.providers[id].timeoutMs ?? this.config.providerTimeoutMs }), signal));
+            return CallToolResultSchema.parse(result);
+        }
+        catch (error) {
+            // Expired HTTP sessions do not emit onclose in the SDK. Reconnect on the next operation, not an automatic billable retry.
+            if (error instanceof StreamableHTTPError && error.code === 404) {
+                if (this.connections.get(id)?.client === client)
+                    this.connections.delete(id);
+                await client.close().catch(() => { });
+            }
+            throw error;
+        }
+    }
+    async close() {
+        if (this.closing)
+            return this.closing;
+        this.closed = true;
+        const connections = [...this.connections.values()];
+        this.connections.clear();
+        this.closing = Promise.allSettled(connections.map(async ({ client, transport }) => {
+            try {
+                if (transport instanceof StreamableHTTPClientTransport && transport.sessionId) {
+                    const deadline = AbortSignal.timeout(2000);
+                    await this.requestSignal.run(deadline, () => abortable(transport.terminateSession(), deadline));
+                }
+            }
+            finally {
+                await client.close();
+            }
+        })).then(() => { });
+        return this.closing;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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