@onedotmint/siftpath 0.0.0-stage → 2.0.0

package/dist/config.d.ts

@@ -0,0 +1,107 @@
+import { z } from 'zod';
+import { type Diagnostic } from './errors.js';
+export declare const configurationMaxBytes = 65536;
+declare const bindingSchema: z.ZodObject<{
+    name: z.ZodString;
+    arguments: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+declare const providerSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    connection: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        transport: z.ZodLiteral<"stdio">;
+        command: z.ZodString;
+        args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strict>, z.ZodObject<{
+        transport: z.ZodLiteral<"http">;
+        url: z.ZodString;
+        headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strict>], "transport">;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    search: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        arguments: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>>;
+    read: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        arguments: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+declare const schema: z.ZodObject<{
+    version: z.ZodDefault<z.ZodLiteral<2>>;
+    credentials: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    providers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        connection: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            transport: z.ZodLiteral<"stdio">;
+            command: z.ZodString;
+            args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strict>, z.ZodObject<{
+            transport: z.ZodLiteral<"http">;
+            url: z.ZodString;
+            headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strict>], "transport">;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+        search: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+            arguments: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>>;
+        read: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+            arguments: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>>;
+    routes: z.ZodDefault<z.ZodObject<{
+        defaultIntent: z.ZodDefault<z.ZodEnum<{
+            general: "general";
+            semantic: "semantic";
+            research: "research";
+        }>>;
+        search: z.ZodDefault<z.ZodString>;
+        read: z.ZodDefault<z.ZodString>;
+        intents: z.ZodDefault<z.ZodObject<{
+            general: z.ZodOptional<z.ZodString>;
+            semantic: z.ZodOptional<z.ZodString>;
+            research: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        searchFallback: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        readFallback: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+    providerTimeoutMs: z.ZodDefault<z.ZodNumber>;
+    maxOutputChars: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export type Configuration = z.infer<typeof schema>;
+export type Provider = z.infer<typeof providerSchema>;
+export type Binding = z.infer<typeof bindingSchema>;
+export declare function parseConfiguration(value: unknown): Configuration;
+export declare function configPath(env?: NodeJS.ProcessEnv): string;
+export declare function readConfiguration(path?: string, env?: NodeJS.ProcessEnv): Promise<Configuration>;
+/** Private user storage, never a workspace .env file; atomic replace with mode 0600. */
+export declare function writePrivateJson(path: string, value: unknown, maxBytes?: number): Promise<void>;
+export declare function resolveSecret(value: string, config: Configuration, env: NodeJS.ProcessEnv): string;
+export declare function providerStatus(id: string, config: Configuration, env: NodeJS.ProcessEnv): Diagnostic;
+export declare function diagnostics(config: Configuration, env?: NodeJS.ProcessEnv): {
+    runtime: string;
+    networkChecked: boolean;
+    providers: {
+        operations: string[];
+        provider: string;
+        code: string;
+        needs?: string[];
+    }[];
+    routes: {
+        defaultIntent: "general" | "semantic" | "research";
+        search: string;
+        read: string;
+        intents: {
+            general?: string | undefined;
+            semantic?: string | undefined;
+            research?: string | undefined;
+        };
+        searchFallback: string[];
+        readFallback: string[];
+    };
+};
+export {};

package/dist/config.js

@@ -0,0 +1,127 @@
+import { readFile, mkdir, writeFile, rename, lstat, chmod, rm } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { z } from 'zod';
+import { SiftpathError } from './errors.js';
+import { intentSchema } from './inputs.js';
+import { defaultProviders, defaultRoutes } from './defaults.js';
+export const configurationMaxBytes = 65536;
+const clean = z.string().min(1).max(4096).regex(/^[^\r\n\0]+$/);
+const bindingSchema = z.strictObject({ name: clean, arguments: z.record(z.string(), z.unknown()).default({}) });
+const connectionSchema = z.discriminatedUnion('transport', [
+    z.strictObject({ transport: z.literal('stdio'), command: clean.refine(value => !value.includes('${')), args: z.array(clean.refine(value => !value.includes('${'))).default([]), env: z.record(z.string(), clean).default({}) }),
+    z.strictObject({ transport: z.literal('http'), url: clean.refine(value => {
+            try {
+                const url = new URL(value);
+                return !url.username && !url.password && !url.hash && !value.includes('${') &&
+                    ![...url.searchParams.keys()].some(key => /api.?key|^key$|^token$|access.?token|auth|secret|credential/i.test(key)) &&
+                    (url.protocol === 'https:' || url.protocol === 'http:' && ['localhost', '127.0.0.1', '[::1]'].includes(url.hostname));
+            }
+            catch {
+                return false;
+            }
+        }), headers: z.record(z.string(), clean).default({}) }),
+]);
+const timeout = z.number().int().min(100).max(120000);
+const providerSchema = z.strictObject({ enabled: z.boolean().default(true), connection: connectionSchema,
+    timeoutMs: timeout.optional(), search: bindingSchema.optional(), read: bindingSchema.optional() });
+const routesSchema = z.strictObject({ defaultIntent: intentSchema.default(defaultRoutes.defaultIntent), search: clean.default(defaultRoutes.search), read: clean.default(defaultRoutes.read),
+    intents: z.strictObject({ general: clean.optional(), semantic: clean.optional(), research: clean.optional() }).default(defaultRoutes.intents),
+    searchFallback: z.array(clean).max(10).default(defaultRoutes.searchFallback), readFallback: z.array(clean).max(10).default(defaultRoutes.readFallback) });
+const schema = z.strictObject({ version: z.literal(2).default(2), credentials: z.record(z.string().regex(/^[A-Z][A-Z0-9_]*$/), clean).default({}),
+    providers: z.record(z.string().regex(/^[a-z][a-z0-9_-]{0,63}$/), providerSchema).default(defaultProviders),
+    routes: routesSchema.default(defaultRoutes), timeoutMs: timeout.default(60000), providerTimeoutMs: timeout.default(20000),
+    maxOutputChars: z.number().int().min(2000).max(50000).default(16000) });
+export function parseConfiguration(value) {
+    const parsed = schema.safeParse(value);
+    if (!parsed.success)
+        throw new SiftpathError('INVALID_CONFIG', 'Invalid configuration (version 2 required). See docs/CONFIGURATION.md; values are never echoed.');
+    const config = structuredClone(parsed.data);
+    for (const id of [config.routes.search, config.routes.read, ...Object.values(config.routes.intents), ...config.routes.searchFallback, ...config.routes.readFallback]) {
+        // Built-in routes may refer to absent optional providers; unknown custom IDs are still diagnosed by doctor.
+        if (id && !/^[a-z][a-z0-9_-]{0,63}$/.test(id))
+            throw new SiftpathError('INVALID_CONFIG', 'Invalid route provider ID.');
+    }
+    return config;
+}
+export function configPath(env = process.env) {
+    const override = env.SIFTPATH_CONFIG ?? env.SMARTSEARCH_CONFIG;
+    if (override)
+        return override;
+    const root = env.XDG_CONFIG_HOME || join(homedir(), '.config');
+    const current = join(root, 'siftpath', 'config.json'), legacy = join(root, 'smartsearch', 'config.json');
+    return existsSync(current) || !existsSync(legacy) ? current : legacy;
+}
+export async function readConfiguration(path = configPath(), env = process.env) {
+    let raw = {};
+    try {
+        const stats = await lstat(path);
+        if (!stats.isFile() || stats.isSymbolicLink() || stats.size > configurationMaxBytes)
+            throw new SiftpathError('INVALID_CONFIG', 'Configuration must be a regular JSON file of at most 64 KiB.');
+        raw = JSON.parse(await readFile(path, 'utf8'));
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT') {
+            if (error instanceof SiftpathError)
+                throw error;
+            throw new SiftpathError('CONFIG_READ_FAILED', 'Cannot read configuration JSON. Check format and permissions.');
+        }
+    }
+    // Old credentials can be reused, but old engine options must never silently change the new routes.
+    if (raw && typeof raw === 'object' && 'version' in raw && raw.version === 1) {
+        const old = raw;
+        raw = { version: 2, credentials: old.credentials ?? {}, providers: Object.fromEntries(Object.entries(defaultProviders).map(([id, provider]) => [id, { ...provider, enabled: provider.enabled && !old.disabled?.includes(id) }])) };
+    }
+    const config = parseConfiguration(raw);
+    const names = new Set([...Object.keys(config.credentials), ...[...JSON.stringify(config.providers).matchAll(/\$\{([A-Z][A-Z0-9_]*)\}/g)].map(match => match[1])]);
+    for (const name of names)
+        if (env[name]?.trim())
+            config.credentials[name] = env[name].trim();
+    return parseConfiguration(config);
+}
+/** Private user storage, never a workspace .env file; atomic replace with mode 0600. */
+export async function writePrivateJson(path, value, maxBytes = Infinity) {
+    const serialized = JSON.stringify(value, null, 2) + '\n';
+    if (Buffer.byteLength(serialized) > maxBytes)
+        throw new SiftpathError('CONFIG_TOO_LARGE', 'Formatted configuration exceeds the size limit; existing file was not changed.');
+    await mkdir(dirname(path), { recursive: true, mode: 0o700 });
+    try {
+        if ((await lstat(path)).isSymbolicLink())
+            throw new SiftpathError('UNSAFE_CONFIG_PATH', 'Refusing to replace a symbolic link.');
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT')
+            throw error;
+    }
+    const temporary = `${path}.${randomUUID()}.tmp`;
+    await writeFile(temporary, serialized, { flag: 'wx', mode: 0o600 });
+    try {
+        await rename(temporary, path);
+        if (process.platform !== 'win32')
+            await chmod(path, 0o600);
+    }
+    finally {
+        await rm(temporary, { force: true });
+    }
+}
+export function resolveSecret(value, config, env) {
+    return value.replace(/\$\{([A-Z][A-Z0-9_]*)\}/g, (_, name) => env[name]?.trim() || config.credentials[name] || '');
+}
+export function providerStatus(id, config, env) {
+    const provider = Object.hasOwn(config.providers, id) ? config.providers[id] : undefined;
+    if (!provider)
+        return { provider: id, code: 'NOT_CONFIGURED' };
+    if (!provider.enabled)
+        return { provider: id, code: 'DISABLED' };
+    const needs = [...new Set([...JSON.stringify(provider.connection).matchAll(/\$\{([A-Z][A-Z0-9_]*)\}/g)].map(m => m[1]))]
+        .filter(name => !env[name]?.trim() && !config.credentials[name]);
+    return { provider: id, code: needs.length ? 'MISSING_CREDENTIALS' : 'READY', ...(needs.length ? { needs } : {}) };
+}
+export function diagnostics(config, env = process.env) {
+    const ids = new Set([...Object.keys(config.providers), config.routes.search, config.routes.read, ...Object.values(config.routes.intents),
+        ...config.routes.searchFallback, ...config.routes.readFallback].filter((id) => !!id));
+    return { runtime: process.version, networkChecked: false, providers: [...ids].map(id => ({ ...providerStatus(id, config, env), operations: ['search', 'read'].filter(kind => !!config.providers[id]?.[kind]) })), routes: config.routes };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACxF,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAmB,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEhE,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAC3C,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;AAChE,MAAM,aAAa,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AAChH,MAAM,gBAAgB,GAAG,CAAC,CAAC,kBAAkB,CAAC,WAAW,EAAE;IACzD,CAAC,CAAC,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;IAC/N,CAAC,CAAC,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;YACvE,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;gBAC3B,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;oBACzE,CAAC,CAAC,GAAG,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,8DAA8D,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBACnH,CAAC,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC1H,CAAC;YAAC,MAAM,CAAC;gBAAC,OAAO,KAAK,CAAC;YAAC,CAAC;QAC3B,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;CACxD,CAAC,CAAC;AACH,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACtD,MAAM,cAAc,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,gBAAgB;IACtG,SAAS,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,aAAa,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,aAAa,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AACrG,MAAM,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,aAAa,EAAE,YAAY,CAAC,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC;IAC1L,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC;IAC7I,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,cAAc,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;AAC5J,MAAM,MAAM,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC/I,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,yBAAyB,CAAC,EAAE,cAAc,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;IAC1G,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,iBAAiB,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;IACzH,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAI1E,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,MAAM,IAAI,aAAa,CAAC,gBAAgB,EAAE,iGAAiG,CAAC,CAAC;IAClK,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5C,KAAK,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QACrK,4GAA4G;QAC5G,IAAI,EAAE,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,aAAa,CAAC,gBAAgB,EAAE,4BAA4B,CAAC,CAAC;IACzH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AACD,MAAM,UAAU,UAAU,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC7D,MAAM,QAAQ,GAAG,GAAG,CAAC,eAAe,IAAI,GAAG,CAAC,kBAAkB,CAAC;IAC/D,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,IAAI,GAAG,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;IACzG,OAAO,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;AACvE,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAI,GAAG,UAAU,EAAE,EAAE,MAAyB,OAAO,CAAC,GAAG;IAC/F,IAAI,GAAG,GAAY,EAAE,CAAC;IACtB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,cAAc,EAAE,IAAI,KAAK,CAAC,IAAI,GAAG,qBAAqB;YAAE,MAAM,IAAI,aAAa,CAAC,gBAAgB,EAAE,8DAA8D,CAAC,CAAC;QAC/L,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,IAAI,KAAK,YAAY,aAAa;gBAAE,MAAM,KAAK,CAAC;YAChD,MAAM,IAAI,aAAa,CAAC,oBAAoB,EAAE,+DAA+D,CAAC,CAAC;QACjH,CAAC;IACH,CAAC;IACD,mGAAmG;IACnG,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,SAAS,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;QAC5E,MAAM,GAAG,GAAG,GAAoE,CAAC;QACjF,GAAG,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,WAAW,CACnF,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACjJ,CAAC;IACD,MAAM,MAAM,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC;IACnK,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,IAAI,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE;YAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,CAAE,CAAC,IAAI,EAAE,CAAC;IAC9F,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC;AACD,wFAAwF;AACxF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAY,EAAE,KAAc,EAAE,QAAQ,GAAG,QAAQ;IACtF,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IACzD,IAAI,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,QAAQ;QAAE,MAAM,IAAI,aAAa,CAAC,kBAAkB,EAAE,gFAAgF,CAAC,CAAC;IAC5K,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7D,IAAI,CAAC;QAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,EAAE;YAAE,MAAM,IAAI,aAAa,CAAC,oBAAoB,EAAE,sCAAsC,CAAC,CAAC;IAAC,CAAC;IACxI,OAAO,KAAK,EAAE,CAAC;QAAC,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,KAAK,CAAC;IAAC,CAAC;IACtF,MAAM,SAAS,GAAG,GAAG,IAAI,IAAI,UAAU,EAAE,MAAM,CAAC;IAChD,MAAM,SAAS,CAAC,SAAS,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACpE,IAAI,CAAC;QAAC,MAAM,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAAC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;YAAE,MAAM,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAAC,CAAC;YAC1F,CAAC;QAAC,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAAC,CAAC;AACnD,CAAC;AACD,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,MAAqB,EAAE,GAAsB;IACxF,OAAO,KAAK,CAAC,OAAO,CAAC,0BAA0B,EAAE,CAAC,CAAC,EAAE,IAAY,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;AAC7H,CAAC;AACD,MAAM,UAAU,cAAc,CAAC,EAAU,EAAE,MAAqB,EAAE,GAAsB;IACtF,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACxF,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;IAC/D,IAAI,CAAC,QAAQ,CAAC,OAAO;QAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IACjE,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC;SACtH,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IACnE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AACpH,CAAC;AACD,MAAM,UAAU,WAAW,CAAC,MAAqB,EAAE,MAAyB,OAAO,CAAC,GAAG;IACrF,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;QACtI,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACtG,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,IAAyB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;AACjQ,CAAC"}

package/dist/defaults.d.ts

@@ -0,0 +1,38 @@
+import type { Provider } from './config.js';
+export declare const providerPresets: Record<string, Provider>;
+export declare const anonymousPresets: Record<string, Provider>;
+export declare const defaultProviders: {
+    [k: string]: {
+        enabled: boolean;
+        connection: {
+            transport: "stdio";
+            command: string;
+            args: string[];
+            env: Record<string, string>;
+        } | {
+            transport: "http";
+            url: string;
+            headers: Record<string, string>;
+        };
+        timeoutMs?: number | undefined;
+        search?: {
+            name: string;
+            arguments: Record<string, unknown>;
+        } | undefined;
+        read?: {
+            name: string;
+            arguments: Record<string, unknown>;
+        } | undefined;
+    };
+};
+export declare const defaultRoutes: {
+    defaultIntent: "general";
+    search: string;
+    read: string;
+    intents: {
+        semantic: string;
+        research: string;
+    };
+    searchFallback: string[];
+    readFallback: never[];
+};

package/dist/defaults.js

@@ -0,0 +1,31 @@
+// Official tool names/arguments were checked against upstream definitions; see docs/PROVIDERS.md.
+export const providerPresets = {
+    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}', BRAVE_MCP_ENABLED_TOOLS: 'brave_web_search' } },
+        search: { name: 'brave_web_search', arguments: { query: '$query', count: '$maxResults' } } },
+    exa: { enabled: true,
+        connection: { transport: 'stdio', command: 'npx', args: ['-y', 'exa-mcp-server@3.4.2'], env: { EXA_API_KEY: '${EXA_API_KEY}' } },
+        search: { name: 'web_search_exa', arguments: { query: '$query', numResults: '$maxResults' } } },
+    tavily: { enabled: true, timeoutMs: 60000,
+        connection: { transport: 'stdio', command: 'npx', args: ['-y', 'tavily-mcp@0.2.22'], env: { TAVILY_API_KEY: '${TAVILY_API_KEY}' } },
+        search: { name: 'tavily_search', arguments: { query: '$query', max_results: '$maxResults', search_depth: 'basic' } } },
+    jina: { enabled: true,
+        connection: { transport: 'http', url: 'https://mcp.jina.ai/v1', headers: { Authorization: 'Bearer ${JINA_API_KEY}' } },
+        read: { name: 'read_url', arguments: { url: '$url', question: '$focus' } } },
+    firecrawl: { enabled: true, timeoutMs: 60000,
+        connection: { transport: 'stdio', command: 'npx', args: ['-y', 'firecrawl-mcp@3.33.4'], env: { FIRECRAWL_API_KEY: '${FIRECRAWL_API_KEY}' } },
+        read: { name: 'firecrawl_scrape', arguments: { url: '$url', formats: ['markdown'] } } },
+};
+export const anonymousPresets = {
+    exa: { ...providerPresets.exa, connection: { transport: 'http', url: 'https://mcp.exa.ai/mcp', headers: {} },
+        search: { name: 'web_search_exa', arguments: { query: '$query', objective: '$query', numResults: '$maxResults' } } },
+    jina: { ...providerPresets.jina, connection: { transport: 'http', url: 'https://mcp.jina.ai/v1', headers: {} } },
+    tavily: { ...providerPresets.tavily, connection: { transport: 'stdio', command: 'npx', args: ['-y', 'tavily-mcp@0.2.22'], env: {} } },
+    firecrawl: { ...providerPresets.firecrawl, connection: { transport: 'http', url: 'https://mcp.firecrawl.dev/v2/mcp', headers: {} },
+        read: { name: 'firecrawl_scrape', arguments: { url: '$url', formats: ['markdown'], onlyMainContent: true, objective: 'Read the supplied public webpage as Markdown.' } } },
+};
+export const defaultProviders = Object.fromEntries(Object.entries(providerPresets).map(([id, provider]) => [id, { ...provider, enabled: !['tavily', 'firecrawl'].includes(id) }]));
+export const defaultRoutes = { defaultIntent: 'general', search: 'brave', read: 'jina',
+    intents: { semantic: 'exa', research: 'tavily' }, searchFallback: ['brave', 'exa'], readFallback: [] };
+//# sourceMappingURL=defaults.js.map

package/dist/defaults.js.map

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

package/dist/diagnostics.d.ts

@@ -0,0 +1,158 @@
+import { z } from 'zod';
+import { type Configuration } from './config.js';
+declare const testSchema: z.ZodObject<{
+    provider: z.ZodString;
+    testedAt: z.ZodISODateTime;
+    durationMs: z.ZodNumber;
+    outcome: z.ZodEnum<{
+        failed: "failed";
+        passed: "passed";
+        skipped: "skipped";
+    }>;
+    code: z.ZodOptional<z.ZodEnum<{
+        NOT_CONFIGURED: "NOT_CONFIGURED";
+        DISABLED: "DISABLED";
+        MISSING_CREDENTIALS: "MISSING_CREDENTIALS";
+        PROVIDER_TIMEOUT: "PROVIDER_TIMEOUT";
+        AUTH_FAILED: "AUTH_FAILED";
+        RATE_LIMITED: "RATE_LIMITED";
+        CONNECTION_FAILED: "CONNECTION_FAILED";
+        UPSTREAM_ERROR: "UPSTREAM_ERROR";
+        EMPTY_RESPONSE: "EMPTY_RESPONSE";
+        NO_SOURCES: "NO_SOURCES";
+        OUTPUT_LIMIT: "OUTPUT_LIMIT";
+        UNSUPPORTED_OPERATION: "UNSUPPORTED_OPERATION";
+        ABORTED: "ABORTED";
+        DISCOVERY_FAILED: "DISCOVERY_FAILED";
+        TOOL_NOT_FOUND: "TOOL_NOT_FOUND";
+        INVALID_UPSTREAM_ARGUMENTS: "INVALID_UPSTREAM_ARGUMENTS";
+        INVALID_UPSTREAM_RESPONSE: "INVALID_UPSTREAM_RESPONSE";
+        TASK_REQUIRED: "TASK_REQUIRED";
+    }>>;
+    stages: z.ZodObject<{
+        connection: z.ZodEnum<{
+            failed: "failed";
+            not_tested: "not_tested";
+            passed: "passed";
+        }>;
+        discovery: z.ZodEnum<{
+            failed: "failed";
+            not_tested: "not_tested";
+            passed: "passed";
+        }>;
+        request: z.ZodEnum<{
+            failed: "failed";
+            not_tested: "not_tested";
+            passed: "passed";
+        }>;
+    }, z.core.$strict>;
+    operations: z.ZodArray<z.ZodObject<{
+        operation: z.ZodEnum<{
+            search: "search";
+            read: "read";
+        }>;
+        state: z.ZodEnum<{
+            failed: "failed";
+            not_tested: "not_tested";
+            passed: "passed";
+        }>;
+        durationMs: z.ZodNumber;
+        code: z.ZodOptional<z.ZodEnum<{
+            NOT_CONFIGURED: "NOT_CONFIGURED";
+            DISABLED: "DISABLED";
+            MISSING_CREDENTIALS: "MISSING_CREDENTIALS";
+            PROVIDER_TIMEOUT: "PROVIDER_TIMEOUT";
+            AUTH_FAILED: "AUTH_FAILED";
+            RATE_LIMITED: "RATE_LIMITED";
+            CONNECTION_FAILED: "CONNECTION_FAILED";
+            UPSTREAM_ERROR: "UPSTREAM_ERROR";
+            EMPTY_RESPONSE: "EMPTY_RESPONSE";
+            NO_SOURCES: "NO_SOURCES";
+            OUTPUT_LIMIT: "OUTPUT_LIMIT";
+            UNSUPPORTED_OPERATION: "UNSUPPORTED_OPERATION";
+            ABORTED: "ABORTED";
+            DISCOVERY_FAILED: "DISCOVERY_FAILED";
+            TOOL_NOT_FOUND: "TOOL_NOT_FOUND";
+            INVALID_UPSTREAM_ARGUMENTS: "INVALID_UPSTREAM_ARGUMENTS";
+            INVALID_UPSTREAM_RESPONSE: "INVALID_UPSTREAM_RESPONSE";
+            TASK_REQUIRED: "TASK_REQUIRED";
+        }>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ProviderTest = z.infer<typeof testSchema>;
+export declare function testHistoryPath(path?: string): string;
+/** A strict provider contract probe, not an equivalent execution of Router selection, fallback or focus. */
+export declare function providerTest(id: string, config: Configuration, env?: NodeJS.ProcessEnv, caller?: AbortSignal): Promise<ProviderTest>;
+export declare function statusReport(config: Configuration, path?: string, env?: NodeJS.ProcessEnv): Promise<{
+    warnings: string[];
+    providers: {
+        configured: boolean;
+        lastTest: {
+            provider: string;
+            testedAt: string;
+            durationMs: number;
+            outcome: "failed" | "passed" | "skipped";
+            stages: {
+                connection: "failed" | "not_tested" | "passed";
+                discovery: "failed" | "not_tested" | "passed";
+                request: "failed" | "not_tested" | "passed";
+            };
+            operations: {
+                operation: "search" | "read";
+                state: "failed" | "not_tested" | "passed";
+                durationMs: number;
+                code?: "NOT_CONFIGURED" | "DISABLED" | "MISSING_CREDENTIALS" | "PROVIDER_TIMEOUT" | "AUTH_FAILED" | "RATE_LIMITED" | "CONNECTION_FAILED" | "UPSTREAM_ERROR" | "EMPTY_RESPONSE" | "NO_SOURCES" | "OUTPUT_LIMIT" | "UNSUPPORTED_OPERATION" | "ABORTED" | "DISCOVERY_FAILED" | "TOOL_NOT_FOUND" | "INVALID_UPSTREAM_ARGUMENTS" | "INVALID_UPSTREAM_RESPONSE" | "TASK_REQUIRED" | undefined;
+            }[];
+            code?: "NOT_CONFIGURED" | "DISABLED" | "MISSING_CREDENTIALS" | "PROVIDER_TIMEOUT" | "AUTH_FAILED" | "RATE_LIMITED" | "CONNECTION_FAILED" | "UPSTREAM_ERROR" | "EMPTY_RESPONSE" | "NO_SOURCES" | "OUTPUT_LIMIT" | "UNSUPPORTED_OPERATION" | "ABORTED" | "DISCOVERY_FAILED" | "TOOL_NOT_FOUND" | "INVALID_UPSTREAM_ARGUMENTS" | "INVALID_UPSTREAM_RESPONSE" | "TASK_REQUIRED" | undefined;
+        } | null;
+        lastTestStale: boolean;
+        operations: string[];
+        provider: string;
+        code: string;
+        needs?: string[];
+    }[];
+    runtime: string;
+    networkChecked: boolean;
+    routes: {
+        defaultIntent: "general" | "semantic" | "research";
+        search: string;
+        read: string;
+        intents: {
+            general?: string | undefined;
+            semantic?: string | undefined;
+            research?: string | undefined;
+        };
+        searchFallback: string[];
+        readFallback: string[];
+    };
+    version: string;
+    ok: boolean;
+}>;
+export declare function testReport(config: Configuration, target: string, path?: string, env?: NodeJS.ProcessEnv, signal?: AbortSignal): Promise<{
+    version: string;
+    ok: boolean;
+    networkChecked: boolean;
+    results: {
+        configuration: string;
+        provider: string;
+        testedAt: string;
+        durationMs: number;
+        outcome: "failed" | "passed" | "skipped";
+        stages: {
+            connection: "failed" | "not_tested" | "passed";
+            discovery: "failed" | "not_tested" | "passed";
+            request: "failed" | "not_tested" | "passed";
+        };
+        operations: {
+            operation: "search" | "read";
+            state: "failed" | "not_tested" | "passed";
+            durationMs: number;
+            code?: "NOT_CONFIGURED" | "DISABLED" | "MISSING_CREDENTIALS" | "PROVIDER_TIMEOUT" | "AUTH_FAILED" | "RATE_LIMITED" | "CONNECTION_FAILED" | "UPSTREAM_ERROR" | "EMPTY_RESPONSE" | "NO_SOURCES" | "OUTPUT_LIMIT" | "UNSUPPORTED_OPERATION" | "ABORTED" | "DISCOVERY_FAILED" | "TOOL_NOT_FOUND" | "INVALID_UPSTREAM_ARGUMENTS" | "INVALID_UPSTREAM_RESPONSE" | "TASK_REQUIRED" | undefined;
+        }[];
+        code?: "NOT_CONFIGURED" | "DISABLED" | "MISSING_CREDENTIALS" | "PROVIDER_TIMEOUT" | "AUTH_FAILED" | "RATE_LIMITED" | "CONNECTION_FAILED" | "UPSTREAM_ERROR" | "EMPTY_RESPONSE" | "NO_SOURCES" | "OUTPUT_LIMIT" | "UNSUPPORTED_OPERATION" | "ABORTED" | "DISCOVERY_FAILED" | "TOOL_NOT_FOUND" | "INVALID_UPSTREAM_ARGUMENTS" | "INVALID_UPSTREAM_RESPONSE" | "TASK_REQUIRED" | undefined;
+    }[];
+    warnings: string[];
+}>;
+export declare function formatStatus(report: Awaited<ReturnType<typeof statusReport>>): string;
+export declare function formatTests(report: Awaited<ReturnType<typeof testReport>>): string;
+export {};