gitcode-api 1.2.10__py3-none-any.whl → 1.2.11__py3-none-any.whl

gitcode_api/llm/__init__.py

@@ -3,6 +3,8 @@
 from importlib import import_module
 from typing import TYPE_CHECKING, Any, Dict
 
+from ._tool import GitCodeLLMTool
+
 if TYPE_CHECKING:
     from .jiuwen import create_openjiuwen_gitcode_api_tool
     from .mcp import (
@@ -25,7 +27,7 @@ _IMPORT_MAP = {
     "create_openjiuwen_gitcode_api_tool": ".jiuwen",
 }
 
-_IMPORT_CACHE: Dict[str, Any] = {}
+_IMPORT_CACHE: Dict[str, Any] = {"GitCodeLLMTool": GitCodeLLMTool}
 
 
 def __getattr__(name: str) -> object:
@@ -50,6 +52,7 @@ def __dir__() -> list[str]:
 
 
 __all__ = [
+    "GitCodeLLMTool",
     "GitCodeOpenAITool",
     "GitCodeMCP",
     "create_mcp_gitcode_api_tool",

gitcode_api/llm/_tool.py

@@ -227,11 +227,11 @@ class GitCodeLLMTool:
     :param client: Optional synchronous GitCode client.
     :param async_client: Optional asynchronous GitCode client.
     :param api_key: Personal access token used when clients are not supplied.
-    :param owner: Default repository owner for generated clients.
-    :param repo: Default repository name for generated clients.
     :param base_url: Base URL for generated clients.
     :param timeout: Request timeout for generated clients.
     :param decrypt: Optional decryption function for encrypted access tokens.
+    :param owner: Default repository owner for generated clients.
+    :param repo: Default repository name for generated clients.
     """
 
     def __init__(
@@ -240,11 +240,11 @@ class GitCodeLLMTool:
         client: Optional[GitCode] = None,
         async_client: Optional[AsyncGitCode] = None,
         api_key: Optional[str] = None,
-        owner: Optional[str] = None,
-        repo: Optional[str] = None,
         base_url: str = DEFAULT_BASE_URL,
         timeout: Optional[float] = None,
         decrypt: Optional[Callable] = None,
+        owner: Optional[str] = None,
+        repo: Optional[str] = None,
     ) -> None:
         """Create a reusable tool with lazy sync and async clients."""
         self._client = client

gitcode_api/llm/jiuwen.py

@@ -30,8 +30,30 @@ def _openjiuwen_tool_decorator() -> Callable[..., Any]:
 class _GitCodeJiuwenTool(GitCodeLLMTool):
     """Build an openJiuwen ``LocalFunction`` bound to :class:`GitCodeLLMTool` (async invoke only)."""
 
-    def __init__(self, *, name: Optional[str] = None, description: Optional[str] = None, **kwargs) -> None:
-        super().__init__(**kwargs)
+    def __init__(
+        self,
+        *,
+        name: Optional[str] = None,
+        description: Optional[str] = None,
+        client: Optional[GitCode] = None,
+        async_client: Optional[AsyncGitCode] = None,
+        api_key: Optional[str] = None,
+        base_url: str = DEFAULT_BASE_URL,
+        timeout: Optional[float] = None,
+        decrypt: Optional[Callable[..., Any]] = None,
+        owner: Optional[str] = None,
+        repo: Optional[str] = None,
+    ) -> None:
+        super().__init__(
+            client=client,
+            async_client=async_client,
+            api_key=api_key,
+            owner=owner,
+            repo=repo,
+            base_url=base_url,
+            timeout=timeout,
+            decrypt=decrypt,
+        )
         tool_name = name if name is not None else TOOL_NAME
         tool_description = description if description is not None else TOOL_DESCRIPTION
         oj_tool = _openjiuwen_tool_decorator()
@@ -60,11 +82,11 @@ def create_openjiuwen_gitcode_api_tool(
     client: Optional[GitCode] = None,
     async_client: Optional[AsyncGitCode] = None,
     api_key: Optional[str] = None,
-    owner: Optional[str] = None,
-    repo: Optional[str] = None,
     base_url: str = DEFAULT_BASE_URL,
     timeout: Optional[float] = None,
     decrypt: Optional[Callable[..., Any]] = None,
+    owner: Optional[str] = None,
+    repo: Optional[str] = None,
 ) -> "LocalFunction":
     """Create an openJiuwen ``LocalFunction`` for the GitCode API tool.
 
@@ -73,11 +95,11 @@ def create_openjiuwen_gitcode_api_tool(
     :param client: Optional synchronous GitCode client.
     :param async_client: Optional asynchronous GitCode client.
     :param api_key: Personal access token when clients are not supplied.
-    :param owner: Default repository owner for generated clients.
-    :param repo: Default repository name for generated clients.
     :param base_url: Base URL for generated clients.
     :param timeout: Request timeout for generated clients.
     :param decrypt: Optional decryption function for encrypted access tokens.
+    :param owner: Default repository owner for generated clients.
+    :param repo: Default repository name for generated clients.
     :returns: openJiuwen ``LocalFunction`` with the standard parameter schema.
     """
     adapter = _GitCodeJiuwenTool(

gitcode_api/llm/openai.py

@@ -2,7 +2,10 @@
 
 import json
 from functools import cached_property
-from typing import Any, Coroutine, Dict, Union
+from typing import Any, Callable, Coroutine, Dict, Optional, Union
+
+from gitcode_api import AsyncGitCode, GitCode
+from gitcode_api._base_client import DEFAULT_BASE_URL
 
 from ._tool import TOOL_DESCRIPTION, TOOL_NAME, TOOL_PARAMETERS, GitCodeLLMTool
 
@@ -13,19 +16,47 @@ class GitCodeOpenAITool(GitCodeLLMTool):
     :param async_mode: When true, calling the instance returns the async tool coroutine.
     :param indent: ``indent`` argument passed to :func:`json.dumps` when serializing
         invocation results (default ``2``).
-    :param kwargs: Passed to :class:`gitcode_api.llm.GitCodeLLMTool` ---
-        ``client``, ``async_client``, ``api_key``, ``owner``, ``repo``, ``base_url``, ``timeout``, ``decrypt``.
+    :param client: Optional synchronous GitCode client.
+    :param async_client: Optional asynchronous GitCode client.
+    :param api_key: Personal access token used when clients are not supplied.
+    :param base_url: Base URL for generated clients.
+    :param timeout: Request timeout for generated clients.
+    :param decrypt: Optional decryption function for encrypted access tokens.
+    :param owner: Default repository owner for generated clients.
+    :param repo: Default repository name for generated clients.
     """
 
     name = TOOL_NAME
     description = TOOL_DESCRIPTION
     parameters = TOOL_PARAMETERS
 
-    def __init__(self, async_mode: bool = False, indent: int = 2, **kwargs) -> None:
+    def __init__(
+        self,
+        async_mode: bool = False,
+        indent: int = 2,
+        *,
+        client: Optional[GitCode] = None,
+        async_client: Optional[AsyncGitCode] = None,
+        api_key: Optional[str] = None,
+        base_url: str = DEFAULT_BASE_URL,
+        timeout: Optional[float] = None,
+        decrypt: Optional[Callable] = None,
+        owner: Optional[str] = None,
+        repo: Optional[str] = None,
+    ) -> None:
         """Create an OpenAI tool wrapper."""
         self.indent = indent
         self.async_mode = bool(async_mode)
-        super().__init__(**kwargs)
+        super().__init__(
+            client=client,
+            async_client=async_client,
+            api_key=api_key,
+            owner=owner,
+            repo=repo,
+            base_url=base_url,
+            timeout=timeout,
+            decrypt=decrypt,
+        )
 
     @cached_property
     def tool(self) -> Dict[str, Any]:

gitcode_api/version.txt

@@ -1 +1 @@
-1.2.10
+1.2.11

{gitcode_api-1.2.10.dist-info → gitcode_api-1.2.11.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitcode-api
-Version: 1.2.10
+Version: 1.2.11
 Summary: Easy to use Python SDK for the GitCode REST API. Providing builtin CLI tool, and optional LLM integration (MCP, OpenAI tool, and openJiuwen tool) for agents. Community-maintained.
 Author-email: Hugo Huang <hugo@hugohuang.com>
 License-Expression: MIT
@@ -231,7 +231,7 @@ Every resource group inherits a cached `methods` property from the shared resour
 
 ## LLM tools, MCP, and openJiuwen
 
-The `gitcode_api.llm` module exposes a single logical tool, **`gitcode_api_tool`**, that routes calls to sync or async SDK resources. Model-facing parameters match the JSON schema used by OpenAI-style function tools:
+The `gitcode_api.llm` module exposes a single unified tool, **`gitcode_api_tool`**, that routes calls to respective sync or async SDK resource groups. Model-facing parameters match the JSON schema used by OpenAI-style function tools:
 
 | Parameter | Role |
 | --- | --- |

{gitcode_api-1.2.10.dist-info → gitcode_api-1.2.11.dist-info}/RECORD

@@ -9,21 +9,21 @@ gitcode_api/_models.py,sha256=v-GZzCGAb3_frY6wFiQww9m271U5MigivpEHDHnoDcI,109030
 gitcode_api/cli.py,sha256=7LLDRCKJg7avaLgIwckZZC5LewSpMPWNQFFDRhAQkEs,16616
 gitcode_api/py.typed,sha256=mDShSrm8qg9qjacQc2F-rI8ATllqP6EdgHuEYxuCXZ0,7
 gitcode_api/run_mcp.py,sha256=a7zNrcAooGovzokJwTHQGj6iT4g7iltaUoD_E1KLvMg,130
-gitcode_api/version.txt,sha256=QwQnXzDgdsdqvcDygPD91VN_GscAlTuhkI4ppk1TGRk,7
-gitcode_api/llm/__init__.py,sha256=7xD9jHpk0eE12J8SQ3G0SB-8A0wEUoAsdx6SOBW6OUI,1604
-gitcode_api/llm/_tool.py,sha256=mBQPYzQ-SuSWgumapcjv3pjGQfcPYt-IxUXBT5un2Lk,16239
-gitcode_api/llm/jiuwen.py,sha256=lR3uhW67ER2KdalK9NNCOVtqFFQ1o4N5ylzWM1LkA1o,3638
+gitcode_api/version.txt,sha256=NzEMfzSBZRIsy59KhUwpSFOVuzrwZZulp3vgZsFRFnk,7
+gitcode_api/llm/__init__.py,sha256=rU75ZlJvTWNVxBLc3QzdfWmSjqVc9z6hfQ8z6jVVKOk,1693
+gitcode_api/llm/_tool.py,sha256=b65iUiHo1H29uA6mFM3WlD0zZlISsENx1tpEqlkiUoA,16239
+gitcode_api/llm/jiuwen.py,sha256=axwAcoG86XkPkN37PTh47Cdzwh3yACUpe4bTjlaAFDc,4244
 gitcode_api/llm/mcp.py,sha256=eeAuEETZ4THw31wbcnQaTlZQJ-9ZolvsejQY630OqHs,5702
-gitcode_api/llm/openai.py,sha256=cie6qmS3YzT4j-KelBgi0MNr6Cedh2uBPib8Bpje59M,2148
+gitcode_api/llm/openai.py,sha256=r8LZi3oK9D80dfiPpv1TpP-PwKUXpAGqgNGE3hOIAaA,3200
 gitcode_api/resources/__init__.py,sha256=nsCKW0bFDZ5ombJZxLThmO82sOuF7o4OKUMRkAmwbwk,1725
 gitcode_api/resources/_shared.py,sha256=7bCym8bIfs818SiYYrBGI7-ZtiYlxECSDG3RduInu10,5387
 gitcode_api/resources/account.py,sha256=mnc2p7wI-nBnHFNdWPNiHfmZpT6d3RDQC777gewtm4M,38801
 gitcode_api/resources/collaboration.py,sha256=8lyk78GTjVXddiE9fieutsMGovRjteGfTJcAhwLoR0M,101607
 gitcode_api/resources/misc.py,sha256=guDwh4cxbTVsSa7EivaYM3bKMJ8_Op4KucGbKEoayKE,22412
 gitcode_api/resources/repositories.py,sha256=EAK2znZhEsgVUu-NDEQslSEEYJzvb-kHuh4mW57y6sc,78178
-gitcode_api-1.2.10.dist-info/licenses/LICENSE,sha256=gOACXuWhMu6PJKVLr9RQbxX3HULnZIGNXCaMFJIXhoA,1067
-gitcode_api-1.2.10.dist-info/METADATA,sha256=-RsrbiBw8GpiKvLmbmA42hJ7k45Rw6OlFdlq8n94oPc,22037
-gitcode_api-1.2.10.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-gitcode_api-1.2.10.dist-info/entry_points.txt,sha256=dIPylJcgohIE2RRIlt3In2WzcwDK8TOdkL_ReKuij4o,53
-gitcode_api-1.2.10.dist-info/top_level.txt,sha256=gIlg0ptyOUHJT64ajOjWIhRPYgIQnMIvnhhnesw9fxU,12
-gitcode_api-1.2.10.dist-info/RECORD,,
+gitcode_api-1.2.11.dist-info/licenses/LICENSE,sha256=gOACXuWhMu6PJKVLr9RQbxX3HULnZIGNXCaMFJIXhoA,1067
+gitcode_api-1.2.11.dist-info/METADATA,sha256=3VOsMVB8v0K7pMtOetkpLGH4UJjeF9R_QsEmF9GbZrs,22054
+gitcode_api-1.2.11.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+gitcode_api-1.2.11.dist-info/entry_points.txt,sha256=dIPylJcgohIE2RRIlt3In2WzcwDK8TOdkL_ReKuij4o,53
+gitcode_api-1.2.11.dist-info/top_level.txt,sha256=gIlg0ptyOUHJT64ajOjWIhRPYgIQnMIvnhhnesw9fxU,12
+gitcode_api-1.2.11.dist-info/RECORD,,