File size: 2,698 Bytes
6ca8e48
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
"""Pydantic models for DocForge API request/response schemas."""

from datetime import date
from enum import Enum
from typing import Any
from uuid import UUID

from pydantic import BaseModel, Field


class InputType(str, Enum):
    npm = "npm"
    pypi = "pypi"
    url = "url"
    github = "github"
    paste = "paste"
    crates = "crates"
    rubygems = "rubygems"
    pubdev = "pubdev"
    nuget = "nuget"
    maven = "maven"
    hex = "hex"
    cran = "cran"


class OutputFormat(str, Enum):
    context_md = "context_md"
    json = "json"
    mcp = "mcp"


class JobStatus(str, Enum):
    queued = "queued"
    processing = "processing"
    complete = "complete"
    failed = "failed"


class ContextRequest(BaseModel):
    input: str = Field(..., description="Package name, URL, or GitHub repo")
    input_type: InputType = Field(InputType.npm, description="Type of input")
    components: list[str] | None = Field(None, description="Specific components to extract")
    output_format: OutputFormat = Field(OutputFormat.context_md, description="Output format")
    content: str | None = Field(None, description="Raw content for paste input type")
    # Client-supplied API keys (used when no Bearer token is present)
    gemini_key: str | None = Field(None, description="Gemini API key (CLI local-key mode)")
    groq_key: str | None = Field(None, description="Groq API key (CLI local-key mode)")


class JobCreatedResponse(BaseModel):
    job_id: str
    status: JobStatus = JobStatus.queued


class PropSchema(BaseModel):
    name: str
    type: str
    required: bool = False
    default: str | None = None


class ComponentSchema(BaseModel):
    name: str
    import_path: str | None = None
    install_command: str | None = None
    props: list[PropSchema] = Field(default_factory=list)
    gotchas: list[str] = Field(default_factory=list)
    peer_dependencies: list[str] = Field(default_factory=list)
    usage_example: str | None = None
    last_verified: str = Field(default_factory=lambda: date.today().isoformat())


class StructuredLibrary(BaseModel):
    library: str
    version: str
    description: str | None = None
    components: list[ComponentSchema] = Field(default_factory=list)


class ContextJobResult(BaseModel):
    status: JobStatus
    job_id: str
    library: str | None = None
    version: str | None = None
    output: str | None = None
    components: list[dict[str, Any]] = Field(default_factory=list)
    error: str | None = None


class SearchResult(BaseModel):
    name: str
    version: str
    cached_at: str


class SearchResponse(BaseModel):
    results: list[SearchResult]


class VersionsResponse(BaseModel):
    package: str
    versions: list[str]