forge-cpp-mcp 0.2.1__py3-none-any.whl

forgemcp/assets.py

@@ -0,0 +1,62 @@
+"""Small helpers for files shipped inside the ForgeMCP package."""
+
+from __future__ import annotations
+
+import base64
+import mimetypes
+from dataclasses import dataclass
+from importlib.resources import files
+from importlib.resources.abc import Traversable
+from pathlib import PurePosixPath
+
+from mcp.types import Icon
+
+PACKAGE = "forgemcp"
+
+
+def package_file(relative_path: str) -> Traversable:
+    """Resolve a safe path relative to the ForgeMCP package."""
+    path = PurePosixPath(relative_path.replace("\\", "/"))
+    if path.is_absolute() or ".." in path.parts:
+        raise ValueError(
+            f"Package path must be relative and cannot contain '..': {relative_path}"
+        )
+
+    resource = files(PACKAGE)
+    for part in path.parts:
+        resource = resource.joinpath(part)
+    return resource
+
+
+@dataclass(frozen=True)
+class Widget:
+    """A generated single-file MCP App stored relative to the package root."""
+
+    path: str
+
+    @property
+    def uri(self) -> str:
+        return f"ui://forgemcp/{PurePosixPath(self.path).name}"
+
+    @property
+    def content(self) -> str:
+        return package_file(self.path).read_text(encoding="utf-8")
+
+
+@dataclass(frozen=True)
+class IconFile:
+    """An icon source file converted to portable MCP icon metadata."""
+
+    path: str
+    sizes: tuple[str, ...] = ("any",)
+
+    @property
+    def icon(self) -> Icon:
+        resource = package_file(self.path)
+        mime_type = mimetypes.guess_type(self.path)[0] or "application/octet-stream"
+        encoded = base64.b64encode(resource.read_bytes()).decode("ascii")
+        return Icon(
+            src=f"data:{mime_type};base64,{encoded}",
+            mime_type=mime_type,
+            sizes=list(self.sizes),
+        )

forgemcp/clangd/__init__.py

@@ -0,0 +1 @@
+"""C/C++ language analysis business services."""

forgemcp/clangd/errors.py

@@ -0,0 +1,29 @@
+"""Expected language analysis failures, without protocol or transcript dumps."""
+
+
+class ClangdError(Exception):
+    """Base error for an unavailable or unsuccessful analysis."""
+
+
+class ClangdSessionError(ClangdError):
+    """A language-server session could not be established or was lost."""
+
+
+class ClangdTimeoutError(ClangdError):
+    """A request or version-specific diagnostic exceeded its deadline."""
+
+
+class ClangdProtocolError(ClangdError):
+    """The language server returned an unsupported or malformed result."""
+
+
+class ClangdRequestError(ClangdError):
+    """The language server rejected an operation."""
+
+    def __init__(self, method: str, code: int, message: str) -> None:
+        super().__init__(f"{method} failed ({code}): {message}")
+        self.code = code
+
+
+class ClangdStaleResultError(ClangdError):
+    """Workspace content changed while an analysis snapshot was being produced."""

forgemcp/clangd/models.py

@@ -0,0 +1,94 @@
+"""Language values shared by session decoding and service results."""
+
+from __future__ import annotations
+
+from typing import Literal
+
+from pydantic import BaseModel, Field, model_validator
+
+from forgemcp.workspace.path import WorkspacePath
+
+
+class Position(BaseModel):
+    line: int = Field(ge=1)
+    character: int = Field(ge=0, description="Zero-based Unicode code point offset.")
+
+
+class SourceRange(BaseModel):
+    start: Position
+    end: Position
+
+    @model_validator(mode="after")
+    def ordered(self) -> SourceRange:
+        if (self.end.line, self.end.character) < (self.start.line, self.start.character):
+            raise ValueError("Source range end precedes its start.")
+        return self
+
+
+class Location(BaseModel):
+    path: WorkspacePath
+    range: SourceRange
+
+
+class SourceExcerpt(BaseModel):
+    """Immutable source context captured with a navigation answer."""
+
+    start_line: int = Field(ge=1)
+    text: str
+
+
+class NavigationLocation(Location):
+    preview: SourceExcerpt | None = Field(
+        default=None,
+        description="Up to seven saved source lines near the target. External or unreadable files have no preview.",
+    )
+
+
+class RelatedDiagnostic(BaseModel):
+    location: Location
+    message: str
+
+
+class Diagnostic(BaseModel):
+    range: SourceRange
+    severity: Literal["error", "warning", "information", "hint"] | None = None
+    message: str
+    code: int | str | None = None
+    source: str | None = None
+    tags: list[int] = Field(default_factory=list)
+    related: list[RelatedDiagnostic] = Field(default_factory=list)
+
+
+class HoverText(BaseModel):
+    kind: Literal["plaintext", "markdown", "code"]
+    text: str
+    language: str | None = None
+
+
+class Hover(BaseModel):
+    contents: list[HoverText]
+    range: SourceRange | None = None
+
+
+class DocumentSymbol(BaseModel):
+    name: str
+    kind: int
+    range: SourceRange
+    selection_range: SourceRange
+    detail: str | None = None
+    tags: list[int] = Field(default_factory=list)
+    children: list[DocumentSymbol] = Field(default_factory=list)
+
+
+class WorkspaceSymbol(BaseModel):
+    name: str
+    kind: int
+    location: NavigationLocation
+    container_name: str | None = None
+    tags: list[int] = Field(default_factory=list)
+
+
+class HighlightSpan(BaseModel):
+    range: SourceRange
+    kind: str
+    modifiers: list[str] = Field(default_factory=list)