kotharcomputing 0.80.1__tar.gz → 0.82.0__tar.gz

{kotharcomputing-0.80.1/src/kotharcomputing.egg-info → kotharcomputing-0.82.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kotharcomputing
-Version: 0.80.1
+Version: 0.82.0
 Summary: Python SDK for the Kothar API
 Author: Kothar Computing
 License-Expression: Apache-2.0

{kotharcomputing-0.80.1 → kotharcomputing-0.82.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "kotharcomputing"
-version = "0.80.1"
+version = "0.82.0"
 description = "Python SDK for the Kothar API"
 readme = "README.md"
 requires-python = ">=3.11"

kotharcomputing-0.82.0/src/kotharcomputing/__init__.py

@@ -0,0 +1,246 @@
+from .aleph_language_server import (
+    AlephLanguageServerClient,
+    AlephLanguageServerClientOptions,
+    AnalyzeResult,
+    AnalyzeResultWithAst,
+    AstNode,
+    AstNodeLocation,
+    AstNodeType,
+    Diagnostic,
+    DiagnosticSeverity,
+    Position,
+    Range,
+)
+from .agents import (
+    Activity,
+    ActivityExecution,
+    ActivityJob,
+    Agent,
+    AgentCapabilities,
+    AgentCloud,
+    AgentKind,
+    AgentPersonal,
+    AgentStatus,
+    CreateAgentArgs,
+    CreateAgentResult,
+    DeleteAgentResult,
+    ResetAgentTokenResult,
+    WithAgent,
+)
+from .ai import (
+    AbbreviatedAIChat,
+    AIChat,
+    AIChatContentEditorContext,
+    AIChatContentEditorContextFile,
+    AIChatContentText,
+    AIChatFileLocation,
+    AIChatMessage,
+    AIChatMessageApi,
+    AIChatMessageAssistant,
+    AIChatMessageAssistantContent,
+    AIChatMessageAssistantDelta,
+    AIChatMessageError,
+    AIChatMessageTool,
+    AIChatMessageUser,
+    AIChatMessageUserAppend,
+    AIChatMessageUserContent,
+    AIChatMessageUserContentEdition,
+    AIChatMessageUserCreate,
+    AIChatMessageWithStreaming,
+    AIChatToolCall,
+    AIChatToolCallFunction,
+    AIChatToolDescription,
+    AIChatToolDescriptionFunction,
+    AIModelInfo,
+)
+from .api_tokens import (
+    ApiToken,
+    ApiTokenPermissionAction,
+    ApiTokenPermissions,
+    ApiTokenPermissionSubject,
+    CreateApiTokenArgs,
+    CreateApiTokenResult,
+)
+from .client import (
+    KotharClient,
+    KotharClientOptions,
+    RawResponse,
+)
+from .credits import (
+    CreditBalance,
+    CreditTransaction,
+)
+from .errors import KOTHAR_ERROR_TYPE_BASE_URL, KotharApiError
+from .executions import (
+    ExecuteArgs,
+    ExecuteResult,
+    Execution,
+    ExecutionControl,
+    ExecutionEnded,
+    ExecutionError,
+    ExecutionMessage,
+    ExecutionOutput,
+    ExecutionScriptArgs,
+    ExecutionStarted,
+    SystemMetrics,
+    SystemMetricSample,
+    SystemMetricSeries,
+)
+from .files import (
+    FileContent,
+    FileHistoryEntry,
+    FileListItem,
+    FileSearchResultItem,
+)
+from .jobs import (
+    CreateJobArgs,
+    Job,
+    JobStatus,
+    UpdateJobArgs,
+)
+from .service_prices import ServicePrice
+from .subscribe_user import (
+    KotharApiUserEvent,
+    KotharApiUserEventCreditBalancesUpdated,
+)
+from .subscribe_workspace import (
+    KotharApiWorkspaceEvent,
+    KotharApiWorkspaceFileCreatedEvent,
+    KotharApiWorkspaceFileDeletedEvent,
+    KotharApiWorkspaceFileMovedEvent,
+    KotharApiWorkspaceFileUpdatedEvent,
+    KotharApiWorkspaceJobUpdatedEvent,
+)
+from .subscriptions import (
+    Subscription,
+    SubscriptionInterval,
+    SubscriptionOption,
+    SubscriptionStatus,
+)
+from .users import (
+    UserProfile,
+    WithUser,
+)
+from .workspaces import (
+    Workspace,
+    WorkspaceStorageStats,
+)
+
+__all__ = [
+    # Aleph Language Server
+    "AlephLanguageServerClient",
+    "AlephLanguageServerClientOptions",
+    "AnalyzeResult",
+    "AnalyzeResultWithAst",
+    "AstNode",
+    "AstNodeLocation",
+    "AstNodeType",
+    "Diagnostic",
+    "DiagnosticSeverity",
+    "Position",
+    "Range",
+    # Agents
+    "Activity",
+    "ActivityExecution",
+    "ActivityJob",
+    "Agent",
+    "AgentCapabilities",
+    "AgentCloud",
+    "AgentKind",
+    "AgentPersonal",
+    "AgentStatus",
+    "CreateAgentArgs",
+    "CreateAgentResult",
+    "DeleteAgentResult",
+    "ResetAgentTokenResult",
+    "WithAgent",
+    # AI
+    "AbbreviatedAIChat",
+    "AIChat",
+    "AIChatContentEditorContext",
+    "AIChatContentEditorContextFile",
+    "AIChatContentText",
+    "AIChatFileLocation",
+    "AIChatMessage",
+    "AIChatMessageApi",
+    "AIChatMessageAssistant",
+    "AIChatMessageAssistantContent",
+    "AIChatMessageAssistantDelta",
+    "AIChatMessageError",
+    "AIChatMessageTool",
+    "AIChatMessageUser",
+    "AIChatMessageUserAppend",
+    "AIChatMessageUserContent",
+    "AIChatMessageUserContentEdition",
+    "AIChatMessageUserCreate",
+    "AIChatMessageWithStreaming",
+    "AIChatToolCall",
+    "AIChatToolCallFunction",
+    "AIChatToolDescription",
+    "AIChatToolDescriptionFunction",
+    "AIModelInfo",
+    # API Tokens
+    "ApiToken",
+    "ApiTokenPermissionAction",
+    "ApiTokenPermissions",
+    "ApiTokenPermissionSubject",
+    "CreateApiTokenArgs",
+    "CreateApiTokenResult",
+    # Client
+    "KotharClient",
+    "KotharClientOptions",
+    "RawResponse",
+    # Credits
+    "CreditBalance",
+    "CreditTransaction",
+    # Errors
+    "KOTHAR_ERROR_TYPE_BASE_URL",
+    "KotharApiError",
+    # Executions
+    "ExecuteArgs",
+    "ExecuteResult",
+    "Execution",
+    "ExecutionControl",
+    "ExecutionEnded",
+    "ExecutionError",
+    "ExecutionMessage",
+    "ExecutionOutput",
+    "ExecutionScriptArgs",
+    "ExecutionStarted",
+    "SystemMetrics",
+    "SystemMetricSample",
+    "SystemMetricSeries",
+    # Files
+    "FileContent",
+    "FileHistoryEntry",
+    "FileListItem",
+    "FileSearchResultItem",
+    # Jobs
+    "CreateJobArgs",
+    "Job",
+    "JobStatus",
+    "UpdateJobArgs",
+    # Service Prices
+    "ServicePrice",
+    # Subscribe User
+    "KotharApiUserEvent",
+    "KotharApiUserEventCreditBalancesUpdated",
+    # Subscribe Workspace
+    "KotharApiWorkspaceEvent",
+    "KotharApiWorkspaceFileCreatedEvent",
+    "KotharApiWorkspaceFileDeletedEvent",
+    "KotharApiWorkspaceFileMovedEvent",
+    "KotharApiWorkspaceFileUpdatedEvent",
+    "KotharApiWorkspaceJobUpdatedEvent",
+    # Subscriptions
+    "Subscription",
+    "SubscriptionInterval",
+    "SubscriptionOption",
+    "SubscriptionStatus",
+    # Users
+    "UserProfile",
+    "WithUser",
+    # Workspaces
+    "Workspace",
+    "WorkspaceStorageStats",
+]

kotharcomputing-0.82.0/src/kotharcomputing/aleph_language_server.py

@@ -0,0 +1,162 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from enum import IntEnum
+from typing import Literal, NotRequired, TypedDict, cast, overload
+
+from .fetch import ApiTransport
+
+DEFAULT_BASE_URL = "https://lsp.kotharcomputing.com"
+
+
+@dataclass(slots=True)
+class AlephLanguageServerClientOptions:
+    base_url: str = DEFAULT_BASE_URL
+    timeout: float = 30.0
+
+
+class AlephLanguageServerClient:
+    def __init__(
+        self,
+        options: AlephLanguageServerClientOptions | None = None,
+        *,
+        base_url: str = DEFAULT_BASE_URL,
+        timeout: float = 30.0,
+    ) -> None:
+        if options is None:
+            options = AlephLanguageServerClientOptions(
+                base_url=base_url,
+                timeout=timeout,
+            )
+
+        self._transport = ApiTransport(
+            base_url=options.base_url,
+            access_token=None,
+            timeout=options.timeout,
+        )
+
+    def version(self) -> dict[str, str]:
+        return self._transport.get_json("version")
+
+    @overload
+    def analyze(
+        self, code: str, *, include_ast: Literal[True]
+    ) -> AnalyzeResultWithAst: ...
+    @overload
+    def analyze(self, code: str, *, include_ast: bool = ...) -> AnalyzeResult: ...
+
+    def analyze(
+        self, code: str, *, include_ast: bool = False
+    ) -> AnalyzeResult | AnalyzeResultWithAst:
+        response = self._transport.raw(
+            "post",
+            "analyze",
+            headers={"Content-Type": "application/x-aleph"},
+            search_params={"include_ast": "true"} if include_ast else None,
+            body=code,
+        )
+        return cast(
+            AnalyzeResultWithAst if include_ast else AnalyzeResult, response.json()
+        )
+
+
+# -- LSP Diagnostic types (based on LSP 3.17 specification) --
+
+
+class DiagnosticSeverity(IntEnum):
+    Error = 1
+    Warning = 2
+    Information = 3
+    Hint = 4
+
+
+class Position(TypedDict):
+    line: int
+    character: int
+
+
+class Range(TypedDict):
+    start: Position
+    end: Position
+
+
+class Diagnostic(TypedDict):
+    range: Range
+    message: str
+    severity: NotRequired[DiagnosticSeverity]
+    code: NotRequired[str | int]
+    source: NotRequired[str]
+
+
+class AnalyzeResult(TypedDict):
+    diagnostics: list[Diagnostic]
+
+
+class AnalyzeResultWithAst(AnalyzeResult):
+    ast: list[AstNode]
+
+
+class AstNode(TypedDict):
+    type: AstNodeType
+    text: NotRequired[str]
+    isSynthetic: NotRequired[Literal[True]]
+    location: NotRequired[AstNodeLocation]
+    children: NotRequired[list[AstNode]]
+
+
+class AstNodeLocation(TypedDict):
+    uri: NotRequired[str]
+    range: Range
+
+
+AstNodeType = Literal[
+    "Id",
+    "Fun_Call",
+    "Unused_Return_Fun_Call",
+    "Arg_List",
+    "Slice_List",
+    "Slice",
+    "Equation",
+    "Var_Decl",
+    "Assign_Decl",
+    "Array_Call",
+    "Dot_Access",
+    "Lambda",
+    "Block",
+    "Scopeless_Block",
+    "Include",
+    "Def",
+    "While",
+    "If",
+    "For",
+    "Ranged_For",
+    "Inline_Array",
+    "Inline_Map",
+    "Return",
+    "File",
+    "Prefix",
+    "Break",
+    "Continue",
+    "Map_Pair",
+    "Value_Range",
+    "Inline_Range",
+    "Try",
+    "Catch",
+    "Finally",
+    "Method",
+    "Attr_Decl",
+    "Logical_And",
+    "Logical_Or",
+    "Reference",
+    "Switch",
+    "Case",
+    "Default",
+    "Noop",
+    "Class",
+    "Binary",
+    "Arg",
+    "Global_Decl",
+    "Constant",
+    "Compiled",
+    "Error",
+]

{kotharcomputing-0.80.1 → kotharcomputing-0.82.0/src/kotharcomputing.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kotharcomputing
-Version: 0.80.1
+Version: 0.82.0
 Summary: Python SDK for the Kothar API
 Author: Kothar Computing
 License-Expression: Apache-2.0

{kotharcomputing-0.80.1 → kotharcomputing-0.82.0}/src/kotharcomputing.egg-info/SOURCES.txt

@@ -4,6 +4,7 @@ pyproject.toml
 src/kotharcomputing/__init__.py
 src/kotharcomputing/agents.py
 src/kotharcomputing/ai.py
+src/kotharcomputing/aleph_language_server.py
 src/kotharcomputing/api_tokens.py
 src/kotharcomputing/client.py
 src/kotharcomputing/common.py

kotharcomputing-0.82.0/tests/test_public_api.py

@@ -0,0 +1,145 @@
+from __future__ import annotations
+
+import importlib
+from pathlib import Path
+import sys
+
+
+SRC_DIR = Path(__file__).resolve().parents[1] / "src"
+if str(SRC_DIR) not in sys.path:
+    sys.path.insert(0, str(SRC_DIR))
+
+
+def test_package_import_and_public_exports() -> None:
+    module = importlib.import_module("kotharcomputing")
+
+    expected_exports = {
+        # Aleph Language Server
+        "AlephLanguageServerClient",
+        "AlephLanguageServerClientOptions",
+        "AnalyzeResult",
+        "AnalyzeResultWithAst",
+        "AstNode",
+        "AstNodeLocation",
+        "AstNodeType",
+        "Diagnostic",
+        "DiagnosticSeverity",
+        "Position",
+        "Range",
+        # Agents
+        "Activity",
+        "ActivityExecution",
+        "ActivityJob",
+        "Agent",
+        "AgentCapabilities",
+        "AgentCloud",
+        "AgentKind",
+        "AgentPersonal",
+        "AgentStatus",
+        "CreateAgentArgs",
+        "CreateAgentResult",
+        "DeleteAgentResult",
+        "ResetAgentTokenResult",
+        "WithAgent",
+        # AI
+        "AbbreviatedAIChat",
+        "AIChat",
+        "AIChatContentEditorContext",
+        "AIChatContentEditorContextFile",
+        "AIChatContentText",
+        "AIChatFileLocation",
+        "AIChatMessage",
+        "AIChatMessageApi",
+        "AIChatMessageAssistant",
+        "AIChatMessageAssistantContent",
+        "AIChatMessageAssistantDelta",
+        "AIChatMessageError",
+        "AIChatMessageTool",
+        "AIChatMessageUser",
+        "AIChatMessageUserAppend",
+        "AIChatMessageUserContent",
+        "AIChatMessageUserContentEdition",
+        "AIChatMessageUserCreate",
+        "AIChatMessageWithStreaming",
+        "AIChatToolCall",
+        "AIChatToolCallFunction",
+        "AIChatToolDescription",
+        "AIChatToolDescriptionFunction",
+        "AIModelInfo",
+        # API Tokens
+        "ApiToken",
+        "ApiTokenPermissionAction",
+        "ApiTokenPermissions",
+        "ApiTokenPermissionSubject",
+        "CreateApiTokenArgs",
+        "CreateApiTokenResult",
+        # Client
+        "KotharClient",
+        "KotharClientOptions",
+        "RawResponse",
+        # Credits
+        "CreditBalance",
+        "CreditTransaction",
+        # Errors
+        "KOTHAR_ERROR_TYPE_BASE_URL",
+        "KotharApiError",
+        # Executions
+        "ExecuteArgs",
+        "ExecuteResult",
+        "Execution",
+        "ExecutionControl",
+        "ExecutionEnded",
+        "ExecutionError",
+        "ExecutionMessage",
+        "ExecutionOutput",
+        "ExecutionScriptArgs",
+        "ExecutionStarted",
+        "SystemMetrics",
+        "SystemMetricSample",
+        "SystemMetricSeries",
+        # Files
+        "FileContent",
+        "FileHistoryEntry",
+        "FileListItem",
+        "FileSearchResultItem",
+        # Jobs
+        "CreateJobArgs",
+        "Job",
+        "JobStatus",
+        "UpdateJobArgs",
+        # Service Prices
+        "ServicePrice",
+        # Subscribe User
+        "KotharApiUserEvent",
+        "KotharApiUserEventCreditBalancesUpdated",
+        # Subscribe Workspace
+        "KotharApiWorkspaceEvent",
+        "KotharApiWorkspaceFileCreatedEvent",
+        "KotharApiWorkspaceFileDeletedEvent",
+        "KotharApiWorkspaceFileMovedEvent",
+        "KotharApiWorkspaceFileUpdatedEvent",
+        "KotharApiWorkspaceJobUpdatedEvent",
+        # Subscriptions
+        "Subscription",
+        "SubscriptionInterval",
+        "SubscriptionOption",
+        "SubscriptionStatus",
+        # Users
+        "UserProfile",
+        "WithUser",
+        # Workspaces
+        "Workspace",
+        "WorkspaceStorageStats",
+    }
+
+    assert set(module.__all__) == expected_exports
+    for name in expected_exports:
+        assert hasattr(module, name)
+
+
+def test_kothar_client_uses_default_base_url() -> None:
+    module = importlib.import_module("kotharcomputing")
+
+    client = module.KotharClient()
+
+    assert client._transport.base_url == "https://api.kotharcomputing.com/"

kotharcomputing-0.80.1/src/kotharcomputing/__init__.py

@@ -1,16 +0,0 @@
-from .client import (
-    KotharClient,
-    KotharClientOptions,
-    RawResponse,
-)
-from .executions import ExecuteResult
-from .errors import KOTHAR_ERROR_TYPE_BASE_URL, KotharApiError
-
-__all__ = [
-    "KOTHAR_ERROR_TYPE_BASE_URL",
-    "KotharApiError",
-    "KotharClient",
-    "KotharClientOptions",
-    "RawResponse",
-    "ExecuteResult",
-]

kotharcomputing-0.80.1/tests/test_public_api.py

@@ -1,35 +0,0 @@
-from __future__ import annotations
-
-import importlib
-from pathlib import Path
-import sys
-
-
-SRC_DIR = Path(__file__).resolve().parents[1] / "src"
-if str(SRC_DIR) not in sys.path:
-    sys.path.insert(0, str(SRC_DIR))
-
-
-def test_package_import_and_public_exports() -> None:
-    module = importlib.import_module("kotharcomputing")
-
-    expected_exports = {
-        "KOTHAR_ERROR_TYPE_BASE_URL",
-        "KotharApiError",
-        "KotharClient",
-        "KotharClientOptions",
-        "RawResponse",
-        "ExecuteResult",
-    }
-
-    assert set(module.__all__) == expected_exports
-    for name in expected_exports:
-        assert hasattr(module, name)
-
-
-def test_kothar_client_uses_default_base_url() -> None:
-    module = importlib.import_module("kotharcomputing")
-
-    client = module.KotharClient()
-
-    assert client._transport.base_url == "https://api.kotharcomputing.com/"