@defai.digital/contracts 13.3.0 → 13.4.0

package/dist/research/v1/schema.d.ts

@@ -0,0 +1,844 @@
+/**
+ * Research Domain Contracts v1
+ *
+ * Zod schemas for deep research agent with live documentation fetching.
+ */
+import { z } from 'zod';
+/**
+ * Research source types
+ */
+export declare const ResearchSourceTypeSchema: z.ZodEnum<["web", "docs", "github", "stackoverflow", "arxiv"]>;
+export type ResearchSourceType = z.infer<typeof ResearchSourceTypeSchema>;
+/**
+ * Source reliability levels
+ */
+export declare const SourceReliabilitySchema: z.ZodEnum<["official", "community", "generated", "unknown"]>;
+export type SourceReliability = z.infer<typeof SourceReliabilitySchema>;
+/**
+ * Research request schema
+ */
+export declare const ResearchRequestSchema: z.ZodObject<{
+    query: z.ZodString;
+    sources: z.ZodDefault<z.ZodArray<z.ZodEnum<["web", "docs", "github", "stackoverflow", "arxiv"]>, "many">>;
+    maxSources: z.ZodDefault<z.ZodNumber>;
+    synthesize: z.ZodDefault<z.ZodBoolean>;
+    includeCode: z.ZodDefault<z.ZodBoolean>;
+    language: z.ZodOptional<z.ZodString>;
+    timeout: z.ZodDefault<z.ZodNumber>;
+    freshness: z.ZodDefault<z.ZodEnum<["any", "recent", "latest"]>>;
+}, "strip", z.ZodTypeAny, {
+    timeout: number;
+    query: string;
+    sources: ("web" | "docs" | "github" | "stackoverflow" | "arxiv")[];
+    maxSources: number;
+    synthesize: boolean;
+    includeCode: boolean;
+    freshness: "any" | "recent" | "latest";
+    language?: string | undefined;
+}, {
+    query: string;
+    timeout?: number | undefined;
+    language?: string | undefined;
+    sources?: ("web" | "docs" | "github" | "stackoverflow" | "arxiv")[] | undefined;
+    maxSources?: number | undefined;
+    synthesize?: boolean | undefined;
+    includeCode?: boolean | undefined;
+    freshness?: "any" | "recent" | "latest" | undefined;
+}>;
+export type ResearchRequest = z.infer<typeof ResearchRequestSchema>;
+/**
+ * Create default research request
+ */
+export declare function createDefaultResearchRequest(query: string): ResearchRequest;
+/**
+ * Individual research source
+ */
+export declare const ResearchSourceSchema: z.ZodObject<{
+    sourceId: z.ZodString;
+    type: z.ZodEnum<["web", "docs", "github", "stackoverflow", "arxiv"]>;
+    url: z.ZodString;
+    title: z.ZodString;
+    snippet: z.ZodString;
+    content: z.ZodOptional<z.ZodString>;
+    reliability: z.ZodEnum<["official", "community", "generated", "unknown"]>;
+    publishedAt: z.ZodOptional<z.ZodString>;
+    fetchedAt: z.ZodString;
+    relevanceScore: z.ZodNumber;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    type: "web" | "docs" | "github" | "stackoverflow" | "arxiv";
+    url: string;
+    title: string;
+    snippet: string;
+    sourceId: string;
+    reliability: "unknown" | "official" | "community" | "generated";
+    fetchedAt: string;
+    relevanceScore: number;
+    metadata?: Record<string, unknown> | undefined;
+    content?: string | undefined;
+    publishedAt?: string | undefined;
+}, {
+    type: "web" | "docs" | "github" | "stackoverflow" | "arxiv";
+    url: string;
+    title: string;
+    snippet: string;
+    sourceId: string;
+    reliability: "unknown" | "official" | "community" | "generated";
+    fetchedAt: string;
+    relevanceScore: number;
+    metadata?: Record<string, unknown> | undefined;
+    content?: string | undefined;
+    publishedAt?: string | undefined;
+}>;
+export type ResearchSource = z.infer<typeof ResearchSourceSchema>;
+/**
+ * Code example from research
+ */
+export declare const CodeExampleSchema: z.ZodObject<{
+    code: z.ZodString;
+    language: z.ZodString;
+    source: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    tested: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    language: string;
+    tested: boolean;
+    description?: string | undefined;
+    source?: string | undefined;
+}, {
+    code: string;
+    language: string;
+    description?: string | undefined;
+    source?: string | undefined;
+    tested?: boolean | undefined;
+}>;
+export type CodeExample = z.infer<typeof CodeExampleSchema>;
+/**
+ * Research result schema
+ */
+export declare const ResearchResultSchema: z.ZodObject<{
+    resultId: z.ZodString;
+    query: z.ZodString;
+    sources: z.ZodArray<z.ZodObject<{
+        sourceId: z.ZodString;
+        type: z.ZodEnum<["web", "docs", "github", "stackoverflow", "arxiv"]>;
+        url: z.ZodString;
+        title: z.ZodString;
+        snippet: z.ZodString;
+        content: z.ZodOptional<z.ZodString>;
+        reliability: z.ZodEnum<["official", "community", "generated", "unknown"]>;
+        publishedAt: z.ZodOptional<z.ZodString>;
+        fetchedAt: z.ZodString;
+        relevanceScore: z.ZodNumber;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "web" | "docs" | "github" | "stackoverflow" | "arxiv";
+        url: string;
+        title: string;
+        snippet: string;
+        sourceId: string;
+        reliability: "unknown" | "official" | "community" | "generated";
+        fetchedAt: string;
+        relevanceScore: number;
+        metadata?: Record<string, unknown> | undefined;
+        content?: string | undefined;
+        publishedAt?: string | undefined;
+    }, {
+        type: "web" | "docs" | "github" | "stackoverflow" | "arxiv";
+        url: string;
+        title: string;
+        snippet: string;
+        sourceId: string;
+        reliability: "unknown" | "official" | "community" | "generated";
+        fetchedAt: string;
+        relevanceScore: number;
+        metadata?: Record<string, unknown> | undefined;
+        content?: string | undefined;
+        publishedAt?: string | undefined;
+    }>, "many">;
+    synthesis: z.ZodString;
+    codeExamples: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        language: z.ZodString;
+        source: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        tested: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        language: string;
+        tested: boolean;
+        description?: string | undefined;
+        source?: string | undefined;
+    }, {
+        code: string;
+        language: string;
+        description?: string | undefined;
+        source?: string | undefined;
+        tested?: boolean | undefined;
+    }>, "many">>;
+    confidence: z.ZodNumber;
+    warnings: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    durationMs: z.ZodNumber;
+    completedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    durationMs: number;
+    completedAt: string;
+    query: string;
+    confidence: number;
+    resultId: string;
+    warnings: string[];
+    synthesis: string;
+    sources: {
+        type: "web" | "docs" | "github" | "stackoverflow" | "arxiv";
+        url: string;
+        title: string;
+        snippet: string;
+        sourceId: string;
+        reliability: "unknown" | "official" | "community" | "generated";
+        fetchedAt: string;
+        relevanceScore: number;
+        metadata?: Record<string, unknown> | undefined;
+        content?: string | undefined;
+        publishedAt?: string | undefined;
+    }[];
+    codeExamples: {
+        code: string;
+        language: string;
+        tested: boolean;
+        description?: string | undefined;
+        source?: string | undefined;
+    }[];
+}, {
+    durationMs: number;
+    completedAt: string;
+    query: string;
+    confidence: number;
+    resultId: string;
+    synthesis: string;
+    sources: {
+        type: "web" | "docs" | "github" | "stackoverflow" | "arxiv";
+        url: string;
+        title: string;
+        snippet: string;
+        sourceId: string;
+        reliability: "unknown" | "official" | "community" | "generated";
+        fetchedAt: string;
+        relevanceScore: number;
+        metadata?: Record<string, unknown> | undefined;
+        content?: string | undefined;
+        publishedAt?: string | undefined;
+    }[];
+    warnings?: string[] | undefined;
+    codeExamples?: {
+        code: string;
+        language: string;
+        description?: string | undefined;
+        source?: string | undefined;
+        tested?: boolean | undefined;
+    }[] | undefined;
+}>;
+export type ResearchResult = z.infer<typeof ResearchResultSchema>;
+/**
+ * Research session for tracking multi-query research
+ */
+export declare const ResearchSessionSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    queries: z.ZodArray<z.ZodString, "many">;
+    results: z.ZodArray<z.ZodObject<{
+        resultId: z.ZodString;
+        query: z.ZodString;
+        sources: z.ZodArray<z.ZodObject<{
+            sourceId: z.ZodString;
+            type: z.ZodEnum<["web", "docs", "github", "stackoverflow", "arxiv"]>;
+            url: z.ZodString;
+            title: z.ZodString;
+            snippet: z.ZodString;
+            content: z.ZodOptional<z.ZodString>;
+            reliability: z.ZodEnum<["official", "community", "generated", "unknown"]>;
+            publishedAt: z.ZodOptional<z.ZodString>;
+            fetchedAt: z.ZodString;
+            relevanceScore: z.ZodNumber;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            type: "web" | "docs" | "github" | "stackoverflow" | "arxiv";
+            url: string;
+            title: string;
+            snippet: string;
+            sourceId: string;
+            reliability: "unknown" | "official" | "community" | "generated";
+            fetchedAt: string;
+            relevanceScore: number;
+            metadata?: Record<string, unknown> | undefined;
+            content?: string | undefined;
+            publishedAt?: string | undefined;
+        }, {
+            type: "web" | "docs" | "github" | "stackoverflow" | "arxiv";
+            url: string;
+            title: string;
+            snippet: string;
+            sourceId: string;
+            reliability: "unknown" | "official" | "community" | "generated";
+            fetchedAt: string;
+            relevanceScore: number;
+            metadata?: Record<string, unknown> | undefined;
+            content?: string | undefined;
+            publishedAt?: string | undefined;
+        }>, "many">;
+        synthesis: z.ZodString;
+        codeExamples: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            language: z.ZodString;
+            source: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            tested: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            language: string;
+            tested: boolean;
+            description?: string | undefined;
+            source?: string | undefined;
+        }, {
+            code: string;
+            language: string;
+            description?: string | undefined;
+            source?: string | undefined;
+            tested?: boolean | undefined;
+        }>, "many">>;
+        confidence: z.ZodNumber;
+        warnings: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        durationMs: z.ZodNumber;
+        completedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        durationMs: number;
+        completedAt: string;
+        query: string;
+        confidence: number;
+        resultId: string;
+        warnings: string[];
+        synthesis: string;
+        sources: {
+            type: "web" | "docs" | "github" | "stackoverflow" | "arxiv";
+            url: string;
+            title: string;
+            snippet: string;
+            sourceId: string;
+            reliability: "unknown" | "official" | "community" | "generated";
+            fetchedAt: string;
+            relevanceScore: number;
+            metadata?: Record<string, unknown> | undefined;
+            content?: string | undefined;
+            publishedAt?: string | undefined;
+        }[];
+        codeExamples: {
+            code: string;
+            language: string;
+            tested: boolean;
+            description?: string | undefined;
+            source?: string | undefined;
+        }[];
+    }, {
+        durationMs: number;
+        completedAt: string;
+        query: string;
+        confidence: number;
+        resultId: string;
+        synthesis: string;
+        sources: {
+            type: "web" | "docs" | "github" | "stackoverflow" | "arxiv";
+            url: string;
+            title: string;
+            snippet: string;
+            sourceId: string;
+            reliability: "unknown" | "official" | "community" | "generated";
+            fetchedAt: string;
+            relevanceScore: number;
+            metadata?: Record<string, unknown> | undefined;
+            content?: string | undefined;
+            publishedAt?: string | undefined;
+        }[];
+        warnings?: string[] | undefined;
+        codeExamples?: {
+            code: string;
+            language: string;
+            description?: string | undefined;
+            source?: string | undefined;
+            tested?: boolean | undefined;
+        }[] | undefined;
+    }>, "many">;
+    context: z.ZodOptional<z.ZodString>;
+    startedAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    sessionId: string;
+    updatedAt: string;
+    results: {
+        durationMs: number;
+        completedAt: string;
+        query: string;
+        confidence: number;
+        resultId: string;
+        warnings: string[];
+        synthesis: string;
+        sources: {
+            type: "web" | "docs" | "github" | "stackoverflow" | "arxiv";
+            url: string;
+            title: string;
+            snippet: string;
+            sourceId: string;
+            reliability: "unknown" | "official" | "community" | "generated";
+            fetchedAt: string;
+            relevanceScore: number;
+            metadata?: Record<string, unknown> | undefined;
+            content?: string | undefined;
+            publishedAt?: string | undefined;
+        }[];
+        codeExamples: {
+            code: string;
+            language: string;
+            tested: boolean;
+            description?: string | undefined;
+            source?: string | undefined;
+        }[];
+    }[];
+    startedAt: string;
+    queries: string[];
+    context?: string | undefined;
+}, {
+    sessionId: string;
+    updatedAt: string;
+    results: {
+        durationMs: number;
+        completedAt: string;
+        query: string;
+        confidence: number;
+        resultId: string;
+        synthesis: string;
+        sources: {
+            type: "web" | "docs" | "github" | "stackoverflow" | "arxiv";
+            url: string;
+            title: string;
+            snippet: string;
+            sourceId: string;
+            reliability: "unknown" | "official" | "community" | "generated";
+            fetchedAt: string;
+            relevanceScore: number;
+            metadata?: Record<string, unknown> | undefined;
+            content?: string | undefined;
+            publishedAt?: string | undefined;
+        }[];
+        warnings?: string[] | undefined;
+        codeExamples?: {
+            code: string;
+            language: string;
+            description?: string | undefined;
+            source?: string | undefined;
+            tested?: boolean | undefined;
+        }[] | undefined;
+    }[];
+    startedAt: string;
+    queries: string[];
+    context?: string | undefined;
+}>;
+export type ResearchSession = z.infer<typeof ResearchSessionSchema>;
+/**
+ * Single URL fetch request
+ */
+export declare const FetchRequestSchema: z.ZodObject<{
+    url: z.ZodString;
+    extractCode: z.ZodDefault<z.ZodBoolean>;
+    maxLength: z.ZodDefault<z.ZodNumber>;
+    timeout: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    timeout: number;
+    url: string;
+    maxLength: number;
+    extractCode: boolean;
+}, {
+    url: string;
+    timeout?: number | undefined;
+    maxLength?: number | undefined;
+    extractCode?: boolean | undefined;
+}>;
+export type FetchRequest = z.infer<typeof FetchRequestSchema>;
+/**
+ * Single URL fetch response
+ */
+export declare const FetchResponseSchema: z.ZodObject<{
+    url: z.ZodString;
+    title: z.ZodString;
+    content: z.ZodString;
+    codeBlocks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        language: z.ZodString;
+        source: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        tested: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        language: string;
+        tested: boolean;
+        description?: string | undefined;
+        source?: string | undefined;
+    }, {
+        code: string;
+        language: string;
+        description?: string | undefined;
+        source?: string | undefined;
+        tested?: boolean | undefined;
+    }>, "many">>;
+    reliability: z.ZodEnum<["official", "community", "generated", "unknown"]>;
+    fetchedAt: z.ZodString;
+    success: z.ZodBoolean;
+    error: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    success: boolean;
+    content: string;
+    url: string;
+    title: string;
+    reliability: "unknown" | "official" | "community" | "generated";
+    fetchedAt: string;
+    codeBlocks: {
+        code: string;
+        language: string;
+        tested: boolean;
+        description?: string | undefined;
+        source?: string | undefined;
+    }[];
+    error?: string | undefined;
+}, {
+    success: boolean;
+    content: string;
+    url: string;
+    title: string;
+    reliability: "unknown" | "official" | "community" | "generated";
+    fetchedAt: string;
+    error?: string | undefined;
+    codeBlocks?: {
+        code: string;
+        language: string;
+        description?: string | undefined;
+        source?: string | undefined;
+        tested?: boolean | undefined;
+    }[] | undefined;
+}>;
+export type FetchResponse = z.infer<typeof FetchResponseSchema>;
+/**
+ * Synthesis request schema
+ */
+export declare const SynthesisRequestSchema: z.ZodObject<{
+    query: z.ZodString;
+    sources: z.ZodArray<z.ZodObject<{
+        sourceId: z.ZodString;
+        type: z.ZodEnum<["web", "docs", "github", "stackoverflow", "arxiv"]>;
+        url: z.ZodString;
+        title: z.ZodString;
+        snippet: z.ZodString;
+        content: z.ZodOptional<z.ZodString>;
+        reliability: z.ZodEnum<["official", "community", "generated", "unknown"]>;
+        publishedAt: z.ZodOptional<z.ZodString>;
+        fetchedAt: z.ZodString;
+        relevanceScore: z.ZodNumber;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "web" | "docs" | "github" | "stackoverflow" | "arxiv";
+        url: string;
+        title: string;
+        snippet: string;
+        sourceId: string;
+        reliability: "unknown" | "official" | "community" | "generated";
+        fetchedAt: string;
+        relevanceScore: number;
+        metadata?: Record<string, unknown> | undefined;
+        content?: string | undefined;
+        publishedAt?: string | undefined;
+    }, {
+        type: "web" | "docs" | "github" | "stackoverflow" | "arxiv";
+        url: string;
+        title: string;
+        snippet: string;
+        sourceId: string;
+        reliability: "unknown" | "official" | "community" | "generated";
+        fetchedAt: string;
+        relevanceScore: number;
+        metadata?: Record<string, unknown> | undefined;
+        content?: string | undefined;
+        publishedAt?: string | undefined;
+    }>, "many">;
+    style: z.ZodDefault<z.ZodEnum<["concise", "detailed", "tutorial"]>>;
+    includeCode: z.ZodDefault<z.ZodBoolean>;
+    maxLength: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    maxLength: number;
+    sources: {
+        type: "web" | "docs" | "github" | "stackoverflow" | "arxiv";
+        url: string;
+        title: string;
+        snippet: string;
+        sourceId: string;
+        reliability: "unknown" | "official" | "community" | "generated";
+        fetchedAt: string;
+        relevanceScore: number;
+        metadata?: Record<string, unknown> | undefined;
+        content?: string | undefined;
+        publishedAt?: string | undefined;
+    }[];
+    includeCode: boolean;
+    style: "detailed" | "concise" | "tutorial";
+}, {
+    query: string;
+    sources: {
+        type: "web" | "docs" | "github" | "stackoverflow" | "arxiv";
+        url: string;
+        title: string;
+        snippet: string;
+        sourceId: string;
+        reliability: "unknown" | "official" | "community" | "generated";
+        fetchedAt: string;
+        relevanceScore: number;
+        metadata?: Record<string, unknown> | undefined;
+        content?: string | undefined;
+        publishedAt?: string | undefined;
+    }[];
+    maxLength?: number | undefined;
+    includeCode?: boolean | undefined;
+    style?: "detailed" | "concise" | "tutorial" | undefined;
+}>;
+export type SynthesisRequest = z.infer<typeof SynthesisRequestSchema>;
+/**
+ * Cached research entry
+ */
+export declare const ResearchCacheEntrySchema: z.ZodObject<{
+    query: z.ZodString;
+    queryHash: z.ZodString;
+    result: z.ZodObject<{
+        resultId: z.ZodString;
+        query: z.ZodString;
+        sources: z.ZodArray<z.ZodObject<{
+            sourceId: z.ZodString;
+            type: z.ZodEnum<["web", "docs", "github", "stackoverflow", "arxiv"]>;
+            url: z.ZodString;
+            title: z.ZodString;
+            snippet: z.ZodString;
+            content: z.ZodOptional<z.ZodString>;
+            reliability: z.ZodEnum<["official", "community", "generated", "unknown"]>;
+            publishedAt: z.ZodOptional<z.ZodString>;
+            fetchedAt: z.ZodString;
+            relevanceScore: z.ZodNumber;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            type: "web" | "docs" | "github" | "stackoverflow" | "arxiv";
+            url: string;
+            title: string;
+            snippet: string;
+            sourceId: string;
+            reliability: "unknown" | "official" | "community" | "generated";
+            fetchedAt: string;
+            relevanceScore: number;
+            metadata?: Record<string, unknown> | undefined;
+            content?: string | undefined;
+            publishedAt?: string | undefined;
+        }, {
+            type: "web" | "docs" | "github" | "stackoverflow" | "arxiv";
+            url: string;
+            title: string;
+            snippet: string;
+            sourceId: string;
+            reliability: "unknown" | "official" | "community" | "generated";
+            fetchedAt: string;
+            relevanceScore: number;
+            metadata?: Record<string, unknown> | undefined;
+            content?: string | undefined;
+            publishedAt?: string | undefined;
+        }>, "many">;
+        synthesis: z.ZodString;
+        codeExamples: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            language: z.ZodString;
+            source: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            tested: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            language: string;
+            tested: boolean;
+            description?: string | undefined;
+            source?: string | undefined;
+        }, {
+            code: string;
+            language: string;
+            description?: string | undefined;
+            source?: string | undefined;
+            tested?: boolean | undefined;
+        }>, "many">>;
+        confidence: z.ZodNumber;
+        warnings: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        durationMs: z.ZodNumber;
+        completedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        durationMs: number;
+        completedAt: string;
+        query: string;
+        confidence: number;
+        resultId: string;
+        warnings: string[];
+        synthesis: string;
+        sources: {
+            type: "web" | "docs" | "github" | "stackoverflow" | "arxiv";
+            url: string;
+            title: string;
+            snippet: string;
+            sourceId: string;
+            reliability: "unknown" | "official" | "community" | "generated";
+            fetchedAt: string;
+            relevanceScore: number;
+            metadata?: Record<string, unknown> | undefined;
+            content?: string | undefined;
+            publishedAt?: string | undefined;
+        }[];
+        codeExamples: {
+            code: string;
+            language: string;
+            tested: boolean;
+            description?: string | undefined;
+            source?: string | undefined;
+        }[];
+    }, {
+        durationMs: number;
+        completedAt: string;
+        query: string;
+        confidence: number;
+        resultId: string;
+        synthesis: string;
+        sources: {
+            type: "web" | "docs" | "github" | "stackoverflow" | "arxiv";
+            url: string;
+            title: string;
+            snippet: string;
+            sourceId: string;
+            reliability: "unknown" | "official" | "community" | "generated";
+            fetchedAt: string;
+            relevanceScore: number;
+            metadata?: Record<string, unknown> | undefined;
+            content?: string | undefined;
+            publishedAt?: string | undefined;
+        }[];
+        warnings?: string[] | undefined;
+        codeExamples?: {
+            code: string;
+            language: string;
+            description?: string | undefined;
+            source?: string | undefined;
+            tested?: boolean | undefined;
+        }[] | undefined;
+    }>;
+    cachedAt: z.ZodString;
+    expiresAt: z.ZodString;
+    hitCount: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    hitCount: number;
+    result: {
+        durationMs: number;
+        completedAt: string;
+        query: string;
+        confidence: number;
+        resultId: string;
+        warnings: string[];
+        synthesis: string;
+        sources: {
+            type: "web" | "docs" | "github" | "stackoverflow" | "arxiv";
+            url: string;
+            title: string;
+            snippet: string;
+            sourceId: string;
+            reliability: "unknown" | "official" | "community" | "generated";
+            fetchedAt: string;
+            relevanceScore: number;
+            metadata?: Record<string, unknown> | undefined;
+            content?: string | undefined;
+            publishedAt?: string | undefined;
+        }[];
+        codeExamples: {
+            code: string;
+            language: string;
+            tested: boolean;
+            description?: string | undefined;
+            source?: string | undefined;
+        }[];
+    };
+    expiresAt: string;
+    cachedAt: string;
+    queryHash: string;
+}, {
+    query: string;
+    result: {
+        durationMs: number;
+        completedAt: string;
+        query: string;
+        confidence: number;
+        resultId: string;
+        synthesis: string;
+        sources: {
+            type: "web" | "docs" | "github" | "stackoverflow" | "arxiv";
+            url: string;
+            title: string;
+            snippet: string;
+            sourceId: string;
+            reliability: "unknown" | "official" | "community" | "generated";
+            fetchedAt: string;
+            relevanceScore: number;
+            metadata?: Record<string, unknown> | undefined;
+            content?: string | undefined;
+            publishedAt?: string | undefined;
+        }[];
+        warnings?: string[] | undefined;
+        codeExamples?: {
+            code: string;
+            language: string;
+            description?: string | undefined;
+            source?: string | undefined;
+            tested?: boolean | undefined;
+        }[] | undefined;
+    };
+    expiresAt: string;
+    cachedAt: string;
+    queryHash: string;
+    hitCount?: number | undefined;
+}>;
+export type ResearchCacheEntry = z.infer<typeof ResearchCacheEntrySchema>;
+/**
+ * Research error codes
+ */
+export declare const ResearchErrorCodes: {
+    readonly FETCH_FAILED: "RSH_FETCH_FAILED";
+    readonly SYNTHESIS_FAILED: "RSH_SYNTHESIS_FAILED";
+    readonly NO_SOURCES_FOUND: "RSH_NO_SOURCES_FOUND";
+    readonly TIMEOUT: "RSH_TIMEOUT";
+    readonly RATE_LIMITED: "RSH_RATE_LIMITED";
+    readonly INVALID_URL: "RSH_INVALID_URL";
+    readonly CACHE_MISS: "RSH_CACHE_MISS";
+};
+export type ResearchErrorCode = (typeof ResearchErrorCodes)[keyof typeof ResearchErrorCodes];
+/**
+ * Validate research request
+ */
+export declare function validateResearchRequest(data: unknown): ResearchRequest;
+/**
+ * Validate research result
+ */
+export declare function validateResearchResult(data: unknown): ResearchResult;
+/**
+ * Validate fetch request
+ */
+export declare function validateFetchRequest(data: unknown): FetchRequest;
+/**
+ * Calculate confidence based on source reliability
+ */
+export declare function calculateConfidence(sources: ResearchSource[]): number;
+/**
+ * Check if result has stale data warning
+ */
+export declare function hasStaleDataWarning(result: ResearchResult): boolean;
+//# sourceMappingURL=schema.d.ts.map