@onedotmint/siftpath 0.0.0-stage → 2.0.0

package/dist/router.js

@@ -0,0 +1,85 @@
+import { McpClients } from './client.js';
+import { parseConfiguration, providerStatus } from './config.js';
+import { SiftpathError } from './errors.js';
+import { parseInput, publicUrl, readSchema, searchSchema } from './inputs.js';
+import { normalize } from './output.js';
+/** $field references tool input; missing optional fields are omitted, not sent as null. */
+export function mapArguments(template, input) {
+    const map = (value) => {
+        if (typeof value === 'string' && /^\$(query|intent|maxResults|url|focus)$/.test(value))
+            return input[value.slice(1)];
+        if (Array.isArray(value))
+            return value.map(map).filter(item => item !== undefined);
+        if (value && typeof value === 'object')
+            return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, map(child)]).filter(([, child]) => child !== undefined));
+        return value;
+    };
+    return map(template);
+}
+export class Siftpath {
+    env;
+    configuration;
+    clients;
+    shutdown = new AbortController();
+    constructor(config = {}, env = process.env) {
+        this.env = env;
+        this.configuration = parseConfiguration(config);
+        this.clients = new McpClients(this.configuration, env);
+    }
+    search(input, options = {}) {
+        const args = parseInput(searchSchema, input);
+        const intent = args.intent ?? this.configuration.routes.defaultIntent;
+        return this.route('search', { ...args, intent, maxResults: args.maxResults ?? 5 }, options.signal);
+    }
+    read(input, options = {}) {
+        const args = parseInput(readSchema, input);
+        publicUrl(args.url);
+        return this.route('read', args, options.signal);
+    }
+    async close() { this.shutdown.abort(); await this.clients.close(); }
+    async route(kind, input, caller) {
+        const c = this.configuration, routes = c.routes, deadline = AbortSignal.timeout(c.timeoutMs);
+        const signal = AbortSignal.any([deadline, this.shutdown.signal, ...(caller ? [caller] : [])]);
+        const primary = kind === 'search' ? routes.intents[input.intent] ?? routes.search : routes.read;
+        const order = [...new Set([primary, ...routes[kind === 'search' ? 'searchFallback' : 'readFallback']])];
+        const diagnostics = [];
+        const cancelled = () => {
+            if (this.shutdown.signal.aborted)
+                throw new SiftpathError('CLOSED', 'Siftpath has been closed.');
+            if (caller?.aborted)
+                throw new SiftpathError('ABORTED', 'Operation cancelled.');
+            if (deadline.aborted)
+                throw new SiftpathError('TIMEOUT', 'Operation deadline exceeded.', diagnostics);
+        };
+        for (const id of order) {
+            cancelled();
+            const status = providerStatus(id, c, this.env), provider = c.providers[id], binding = provider?.[kind];
+            if (status.code !== 'READY') {
+                diagnostics.push(status);
+                continue;
+            }
+            if (!binding) {
+                diagnostics.push({ provider: id, code: 'UNSUPPORTED_OPERATION' });
+                continue;
+            }
+            const attempt = AbortSignal.timeout(provider.timeoutMs ?? c.providerTimeoutMs);
+            try {
+                const raw = await this.clients.call(id, binding.name, mapArguments(binding.arguments, input), AbortSignal.any([signal, attempt]));
+                cancelled();
+                const warnings = [];
+                if (kind === 'read' && input.focus && !JSON.stringify(binding.arguments).includes('"$focus"'))
+                    warnings.push({ provider: id, code: 'FOCUS_UNSUPPORTED' });
+                warnings.push(...diagnostics.map(({ provider, code }) => ({ provider, code })));
+                return normalize(raw, id, binding.name, c.maxOutputChars, kind === 'read' ? String(input.url) : undefined, warnings);
+            }
+            catch (error) {
+                cancelled();
+                const code = attempt.aborted ? 'PROVIDER_TIMEOUT' : error instanceof SiftpathError ? error.code : 'UPSTREAM_ERROR';
+                diagnostics.push({ provider: id, code });
+            }
+        }
+        cancelled();
+        throw new SiftpathError('NO_PROVIDER_SUCCEEDED', 'No official MCP succeeded. Run siftpath doctor and check credentials, tool names and connectivity.', diagnostics);
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

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

package/dist/setup-ui.d.ts

@@ -0,0 +1,8 @@
+import * as clack from '@clack/prompts';
+import { type Configuration } from './config.js';
+type Prompts = Pick<typeof clack, 'intro' | 'outro' | 'cancel' | 'log' | 'select' | 'multiselect' | 'password' | 'confirm' | 'isCancel'>;
+export declare function runSetupWizard(saved: Configuration, env?: NodeJS.ProcessEnv, prompts?: Prompts): Promise<{
+    configuration: Configuration;
+    test: boolean;
+} | null>;
+export {};