infobroker 2026.8.23

package/dist/providers/yep.js

@@ -0,0 +1,104 @@
+import { normalize } from "../normalizer.js";
+import { RetryableError } from "../retry.js";
+import { getEnvVar } from "../config.js";
+import { infobrokerFetch } from "../http.js";
+const YEP_API = "https://platform.yep.com/api/search";
+let _yepApiKey;
+function yepApiKey() {
+    if (_yepApiKey === undefined)
+        _yepApiKey = getEnvVar("yep", "_API_KEY");
+    return _yepApiKey;
+}
+async function search(query, options) {
+    const apiKey = yepApiKey();
+    if (!apiKey)
+        throw new Error("INFOBROKER_YEP_API_KEY not set");
+    const body = {
+        query,
+        type: "highlights",
+        limit: options?.max_results ?? 10,
+    };
+    if (options?.region)
+        body.location = options.region;
+    if (options?.safe_search === "strict")
+        body.safe_search = true;
+    if (options?.content_type && options.content_type !== "all") {
+        body.content_type = mapContentType(options.content_type);
+    }
+    if (options?.time_range) {
+        body.start_published_date = mapTimeRange(options.time_range);
+    }
+    const resp = await infobrokerFetch(YEP_API, {
+        providerSlug: "yep",
+        method: "POST",
+        headers: {
+            "Authorization": `Bearer ${apiKey}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(body),
+    });
+    if (resp.status === 402)
+        throw new RetryableError("Yep returned HTTP 402 (insufficient balance)", 402);
+    if (!resp.ok)
+        throw new RetryableError(`Yep returned HTTP ${resp.status}`, resp.status);
+    const data = (await resp.json());
+    const raw = (data.results || []).map((item) => ({
+        title: item.title,
+        url: item.url,
+        snippet: item.description || item.highlights?.join(" ") || "",
+        published_date: item.published_date,
+        source_type: "web_search",
+    }));
+    return normalize(raw, "yep");
+}
+async function health() {
+    const apiKey = yepApiKey();
+    if (!apiKey)
+        return { status: "inactive", avgLatencyMs: 0 };
+    const start = Date.now();
+    try {
+        const resp = await infobrokerFetch(YEP_API, {
+            providerSlug: "yep",
+            method: "POST",
+            headers: {
+                "Authorization": `Bearer ${apiKey}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({ query: "test", type: "basic", limit: 1 }),
+        });
+        const elapsed = Date.now() - start;
+        if (resp.ok)
+            return { status: "active", avgLatencyMs: elapsed };
+        return { status: "degraded", avgLatencyMs: elapsed };
+    }
+    catch {
+        return { status: "inactive", avgLatencyMs: Date.now() - start };
+    }
+}
+const YEP_CONTENT_TYPES = {
+    docs: "Document",
+    blog: "Article",
+    issue: "User_Generated_Content",
+    spec: "Document",
+    changelog: "Article",
+};
+function mapContentType(ct) {
+    return YEP_CONTENT_TYPES[ct] ?? "Article";
+}
+function mapTimeRange(range) {
+    const map = {
+        day: new Date(Date.now() - 86400000).toISOString().slice(0, 10),
+        week: new Date(Date.now() - 7 * 86400000).toISOString().slice(0, 10),
+        month: new Date(Date.now() - 30 * 86400000).toISOString().slice(0, 10),
+        year: new Date(Date.now() - 365 * 86400000).toISOString().slice(0, 10),
+    };
+    return map[range] || "";
+}
+export const provider = {
+    slug: "yep",
+    tier: "keyed_http",
+    capabilities: ["web_search", "semantic", "synthesis"],
+    search,
+    health,
+};
+//# sourceMappingURL=yep.js.map

package/dist/providers/yep.js.map

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

package/dist/quota.d.ts

@@ -0,0 +1,37 @@
+interface QuotaCounter {
+    daily: {
+        count: number;
+        resetAt: string;
+    };
+    monthly: {
+        count: number;
+        resetAt: string;
+    };
+}
+export declare function loadQuotaState(): void;
+export declare function getOrCreateCounter(slug: string): QuotaCounter;
+export interface QuotaReport {
+    exhausted: boolean;
+    warning: boolean;
+    daily: {
+        used: number;
+        remaining: number;
+        resetAt: string;
+    };
+    monthly: {
+        used: number;
+        remaining: number;
+        resetAt: string;
+    };
+}
+export declare function increment(slug: string, limits?: {
+    per_day?: number;
+    per_month?: number;
+}): QuotaReport;
+export declare function checkQuota(slug: string, limits?: {
+    per_day?: number;
+    per_month?: number;
+}): QuotaReport;
+export declare function getQuotaStatePath(): string;
+export declare function getCounter(slug: string): QuotaCounter | undefined;
+export {};

package/dist/quota.js

@@ -0,0 +1,116 @@
+// @implements REQ-033 REQ-034
+import { mkdirSync, readFileSync, writeFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+const QUOTA_DIR = join(tmpdir(), "infobroker");
+const QUOTA_FILE = join(QUOTA_DIR, "quota.json");
+let quotaState = { providers: {} };
+let writeTimer = null;
+const WRITE_INTERVAL_MS = 30_000;
+function ensureDir() {
+    if (!existsSync(QUOTA_DIR)) {
+        mkdirSync(QUOTA_DIR, { recursive: true });
+    }
+}
+function scheduleWrite() {
+    if (writeTimer)
+        return;
+    writeTimer = setTimeout(() => {
+        writeTimer = null;
+        saveQuotaState();
+    }, WRITE_INTERVAL_MS);
+}
+function flushWrite() {
+    if (writeTimer) {
+        clearTimeout(writeTimer);
+        writeTimer = null;
+        saveQuotaState();
+    }
+}
+process.on("beforeExit", () => flushWrite());
+function getDailyReset() {
+    const now = new Date();
+    const reset = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate() + 1));
+    return reset.toISOString();
+}
+function getMonthlyReset() {
+    const now = new Date();
+    const reset = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth() + 1, 1));
+    return reset.toISOString();
+}
+function isExpired(resetAt) {
+    return new Date(resetAt) < new Date(Date.now() - 30_000);
+}
+export function loadQuotaState() {
+    ensureDir();
+    try {
+        if (existsSync(QUOTA_FILE)) {
+            const raw = readFileSync(QUOTA_FILE, "utf-8");
+            quotaState = JSON.parse(raw);
+        }
+    }
+    catch {
+        quotaState = { providers: {} };
+    }
+}
+function saveQuotaState() {
+    ensureDir();
+    writeFileSync(QUOTA_FILE, JSON.stringify(quotaState, null, 2));
+}
+export function getOrCreateCounter(slug) {
+    let counter = quotaState.providers[slug];
+    if (!counter) {
+        counter = {
+            daily: { count: 0, resetAt: getDailyReset() },
+            monthly: { count: 0, resetAt: getMonthlyReset() },
+        };
+        quotaState.providers[slug] = counter;
+    }
+    if (isExpired(counter.daily.resetAt)) {
+        counter.daily = { count: 0, resetAt: getDailyReset() };
+    }
+    if (isExpired(counter.monthly.resetAt)) {
+        counter.monthly = { count: 0, resetAt: getMonthlyReset() };
+    }
+    return counter;
+}
+function buildReport(counter, limits) {
+    const dailyCap = limits?.per_day ?? Infinity;
+    const monthlyCap = limits?.per_month ?? Infinity;
+    const dailyUsed = counter.daily.count;
+    const monthlyUsed = counter.monthly.count;
+    const dailyPct = dailyUsed / dailyCap;
+    const monthlyPct = monthlyUsed / monthlyCap;
+    return {
+        exhausted: dailyUsed >= dailyCap || monthlyUsed >= monthlyCap,
+        warning: dailyPct >= 0.8 || monthlyPct >= 0.8,
+        daily: {
+            used: dailyUsed,
+            remaining: dailyCap < Infinity ? dailyCap - dailyUsed : Infinity,
+            resetAt: counter.daily.resetAt,
+        },
+        monthly: {
+            used: monthlyUsed,
+            remaining: monthlyCap < Infinity ? monthlyCap - monthlyUsed : Infinity,
+            resetAt: counter.monthly.resetAt,
+        },
+    };
+}
+export function increment(slug, limits) {
+    const counter = getOrCreateCounter(slug);
+    counter.daily.count++;
+    counter.monthly.count++;
+    scheduleWrite();
+    return buildReport(counter, limits);
+}
+export function checkQuota(slug, limits) {
+    const counter = getOrCreateCounter(slug);
+    return buildReport(counter, limits);
+}
+export function getQuotaStatePath() {
+    return QUOTA_FILE;
+}
+export function getCounter(slug) {
+    return quotaState.providers[slug];
+}
+//# sourceMappingURL=quota.js.map

package/dist/quota.js.map

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

package/dist/rate-limiter.d.ts

@@ -0,0 +1,7 @@
+import type { Config } from "./types.js";
+export declare function configureProviderRateLimit(slug: string, config: {
+    per_second?: number;
+}): void;
+export declare function configureAllProviders(config: Config): void;
+export declare function throttle(slug: string): Promise<void>;
+export declare function removeProvider(slug: string): void;

package/dist/rate-limiter.js

@@ -0,0 +1,37 @@
+const limits = new Map();
+export function configureProviderRateLimit(slug, config) {
+    const perSecond = config.per_second;
+    if (!perSecond || perSecond <= 0)
+        return;
+    limits.set(slug, {
+        perSecond,
+        lastCall: 0,
+    });
+}
+export function configureAllProviders(config) {
+    for (const [slug, provider] of Object.entries(config.providers)) {
+        if (provider.enabled) {
+            configureProviderRateLimit(slug, provider.rate_limit);
+        }
+    }
+}
+export async function throttle(slug) {
+    const limit = limits.get(slug);
+    if (!limit || limit.perSecond <= 0)
+        return;
+    const now = Date.now();
+    const elapsed = now - limit.lastCall;
+    const minInterval = 1000 / limit.perSecond;
+    if (elapsed < minInterval) {
+        const delay = minInterval - elapsed;
+        await sleep(delay);
+    }
+    limits.set(slug, { ...limit, lastCall: now });
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export function removeProvider(slug) {
+    limits.delete(slug);
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../src/rate-limiter.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,GAA2B,IAAI,GAAG,EAAE,CAAC;AAEjD,MAAM,UAAU,0BAA0B,CACxC,IAAY,EACZ,MAA+B;IAE/B,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC;IACpC,IAAI,CAAC,SAAS,IAAI,SAAS,IAAI,CAAC;QAAE,OAAO;IACzC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE;QACf,SAAS;QACT,QAAQ,EAAE,CAAC;KACZ,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAAc;IAClD,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QAChE,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACrB,0BAA0B,CAAC,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAY;IACzC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC;QAAE,OAAO;IAE3C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,OAAO,GAAG,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC;IACrC,MAAM,WAAW,GAAG,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC;IAE3C,IAAI,OAAO,GAAG,WAAW,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,WAAW,GAAG,OAAO,CAAC;QACpC,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC"}

package/dist/retry.d.ts

@@ -0,0 +1,11 @@
+export declare class RetryableError extends Error {
+    status: number;
+    constructor(message: string, status: number);
+}
+export declare class ParseError extends Error {
+    constructor(message: string);
+}
+export declare function retryWithBackoff<T>(fn: () => Promise<T>, retryConfig?: {
+    retry_count?: number;
+    retry_backoff_ms?: number;
+}): Promise<T>;

package/dist/retry.js

@@ -0,0 +1,51 @@
+// @implements REQ-032
+const DEFAULT_BASE_DELAY = 1000;
+const DEFAULT_RETRY_COUNT = 3;
+export class RetryableError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.status = status;
+        this.name = "RetryableError";
+    }
+}
+export class ParseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ParseError";
+    }
+}
+export async function retryWithBackoff(fn, retryConfig) {
+    const baseDelay = retryConfig?.retry_backoff_ms ?? DEFAULT_BASE_DELAY;
+    const maxRetries = retryConfig?.retry_count ?? DEFAULT_RETRY_COUNT;
+    const delays = [];
+    for (let i = 0; i < maxRetries; i++) {
+        delays.push(baseDelay * Math.pow(2, i));
+    }
+    let lastError = null;
+    for (let attempt = 0; attempt <= delays.length; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (e) {
+            lastError = e instanceof Error ? e : new Error(String(e));
+            if (!isRetryable(lastError))
+                throw lastError;
+            if (attempt < delays.length) {
+                await sleep(delays[attempt] * (0.5 + Math.random() * 0.5));
+            }
+        }
+    }
+    throw lastError;
+}
+function isRetryable(e) {
+    if (e instanceof RetryableError) {
+        return e.status === 429 || e.status === 503;
+    }
+    const msg = e.message;
+    return /\b429\b|\b503\b|rate.?limit|too many requests|service unavailable/i.test(msg);
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+//# sourceMappingURL=retry.js.map

package/dist/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA,sBAAsB;AAEtB,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAChC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAE9B,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,MAAM,CAAS;IACf,YAAY,OAAe,EAAE,MAAc;QACzC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,EAAoB,EACpB,WAAiE;IAEjE,MAAM,SAAS,GAAG,WAAW,EAAE,gBAAgB,IAAI,kBAAkB,CAAC;IACtE,MAAM,UAAU,GAAG,WAAW,EAAE,WAAW,IAAI,mBAAmB,CAAC;IACnE,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,SAAS,GAAiB,IAAI,CAAC;IAEnC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC;QAC1D,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,SAAS,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1D,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC;gBAAE,MAAM,SAAS,CAAC;YAC7C,IAAI,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;gBAC5B,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,SAAU,CAAC;AACnB,CAAC;AAED,SAAS,WAAW,CAAC,CAAQ;IAC3B,IAAI,CAAC,YAAY,cAAc,EAAE,CAAC;QAChC,OAAO,CAAC,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC;IAC9C,CAAC;IACD,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC;IACtB,OAAO,oEAAoE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACxF,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,231 @@
+export interface SearchResult {
+    title: string;
+    url: string;
+    snippet: string;
+    published_date?: string;
+    source_type?: string;
+    original_source?: string;
+}
+export interface ProviderConfig {
+    tier: "builtin" | "free_http" | "self_hosted_http" | "keyed_http" | "generic_http";
+    capabilities: string[];
+    rate_limit: {
+        per_second?: number;
+        per_day?: number;
+        per_month?: number;
+    };
+    auth_env?: string;
+    url_env?: string;
+    enabled: boolean;
+    priority: number;
+    timeout?: number;
+    retry_count?: number;
+    retry_backoff_ms?: number;
+    endpoint?: string;
+    query_param?: string;
+    results_path?: string;
+    field_map?: {
+        title?: string;
+        url?: string;
+        snippet?: string;
+        published_date?: string;
+        source_type?: string;
+        original_source?: string;
+    };
+}
+export interface Config {
+    providers: Record<string, ProviderConfig>;
+    dispatch: Record<string, string[]>;
+    defaults?: {
+        timeout?: number;
+        retry_count?: number;
+        retry_backoff_ms?: number;
+    };
+    corroboration: {
+        max_iterations: number;
+        max_http_calls: number;
+        confidence_threshold: number;
+        first_pass_max_results: number;
+        similarity_threshold: number;
+        authority_weights?: Record<string, number>;
+        archive_sources?: boolean;
+    };
+    output: {
+        max_chars: number;
+        latency_window_size: number;
+        verbose?: boolean;
+        fallback_depth: number;
+        max_redirect_hops: number;
+    };
+    fetch?: {
+        allow_private_urls?: boolean;
+    };
+    kb?: KbConfig;
+}
+export interface HealthReport {
+    status: "active" | "inactive" | "degraded" | "exhausted";
+    slug: string;
+    tier: string;
+    capabilities: string[];
+    quota_used?: number;
+    quota_remaining?: number;
+    quota_reset_at?: string;
+    avg_latency_ms?: number;
+    last_error?: string;
+    last_success?: string;
+    auth_ok: boolean;
+}
+export interface ToolMeta {
+    query_time_ms: number;
+    fallback_used: boolean;
+    quota_remaining?: number;
+}
+export interface ToolOkResponse {
+    status: "ok";
+    provider: string;
+    results: SearchResult[];
+    meta?: ToolMeta;
+    truncated?: boolean;
+    output_path?: string;
+}
+export interface ToolErrorResponse {
+    status: "error";
+    provider: string;
+    error: {
+        code: string;
+        message: string;
+        remediation: string;
+        details?: Record<string, unknown>;
+    };
+}
+export type ToolResponse = ToolOkResponse | ToolErrorResponse;
+export interface CorroborationFinding {
+    topic: string;
+    claim: string;
+    confidence: number;
+    verdict: "confirmed" | "contested" | "unverified";
+    sources: Array<{
+        title: string;
+        url: string;
+        snippet: string;
+        claim: string;
+        source_type?: string;
+        archived_url?: string;
+        original_source?: string;
+    }>;
+    perspectives?: string[];
+}
+export interface CorroborationResult {
+    findings: CorroborationFinding[];
+    agreement_map: {
+        green: string[];
+        yellow: string[];
+        red: string[];
+    };
+    synthesis: string;
+    iteration_count: number;
+    providers_used: string[];
+    total_sources: number;
+    corroboration: "complete" | "partial";
+    provenance?: CorroborationProvenance;
+}
+export interface CorroborationProvenance {
+    tool: string;
+    version: string;
+    max_iterations: number;
+    confidence_threshold: number;
+    source_types: Record<string, number>;
+}
+export interface Provider {
+    slug: string;
+    tier: "builtin" | "free_http" | "self_hosted_http" | "keyed_http" | "generic_http";
+    capabilities: string[];
+    health(): Promise<{
+        status: string;
+        avgLatencyMs: number;
+    }>;
+    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+    fetchPage?(url: string): Promise<string>;
+    suggest?(query: string): Promise<string[]>;
+}
+export interface SearchOptions {
+    max_results?: number;
+    safe_search?: "on" | "off" | "strict";
+    time_range?: "day" | "week" | "month" | "year";
+    page?: number;
+    content_type?: string;
+    region?: string;
+}
+export interface KbConfig {
+    storage_path: string;
+    embedding_model: string;
+    chunk_size: number;
+    chunk_overlap: number;
+    auto_index: boolean;
+    default_collection: string;
+    max_results: number;
+    expiry?: Record<string, number>;
+    reports_dir?: string;
+    default_save_destination?: "kb" | "disk" | "both";
+    freshness?: {
+        tiers: Record<string, {
+            decay_hours: number;
+            expiry_hours: number;
+        }>;
+        auto_classify: boolean;
+        default_tier: string;
+    };
+    kb_first_relevance_threshold: number;
+    kb_first_confidence_threshold: number;
+    maintenance_interval_minutes: number;
+    encryption?: KbEncryptionConfig;
+}
+export interface KbEncryptionConfig {
+    enabled: boolean;
+    key_file?: string;
+}
+export interface KbChunk {
+    id: string;
+    text: string;
+    embedding: number[];
+    source_url: string;
+    chunk_index: number;
+    title: string;
+    provider: string;
+    collection: string;
+    source_type: string;
+    freshness_tier: string;
+    ingested_at: number;
+}
+export interface KbSearchResult {
+    score: number;
+    freshness_score: number;
+    freshness_tier: string;
+    source_url: string;
+    title: string;
+    snippet: string;
+    collection: string;
+    provider: string;
+    source_type: string;
+    ingested_at: number;
+}
+export interface KbListEntry {
+    source_url: string;
+    title: string;
+    collection: string;
+    source_type: string;
+    freshness_tier: string;
+    chunk_count: number;
+    ingested_at: number;
+}
+export interface KbStats {
+    chunk_count: number;
+    collections: Record<string, number>;
+    freshness_tiers?: Record<string, number>;
+    storage_size_bytes: number;
+    last_ingestion: string | null;
+    model_available: boolean;
+    model_name: string;
+    events: string[];
+    encryption?: "enabled" | "disabled" | "locked";
+}

package/dist/types.js

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

package/dist/types.js.map

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