connectkit 0.1.2__tar.gz → 0.1.4__tar.gz

{connectkit-0.1.2 → connectkit-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: connectkit
-Version: 0.1.2
+Version: 0.1.4
 Summary: Connect AI agents to SaaS — one YAML file per service. OAuth, token vault, tool discovery.
 Author: Eddy Xu
 License: MIT
@@ -118,7 +118,28 @@ tool_sources:
 | `api_key` | API keys (Firecrawl, Stripe, Twilio, 288+ services) | Paste key into form → vaulted |
 | `none` | No auth needed (local tools) | Auto-connected |
 
-### Tool source backends
+### Tool descriptions (JSON Schema)
+
+Each tool can define its parameters as a JSON Schema:
+
+```yaml
+tool_descriptions:
+  - name: google_workspace__gmail_messages_list
+    description: "List recent emails from the user's Gmail inbox."
+    parameters:
+      type: object
+      properties:
+        max_results:
+          type: integer
+          description: "Maximum number of emails to return (default: 10)"
+          default: 10
+        query:
+          type: string
+          description: "Gmail search query (e.g. 'from:example@gmail.com', 'is:unread')"
+      required: []
+```
+
+Legacy `parameter_descriptions` (flat string map) is still supported for backward compatibility, but `parameters` (full JSON Schema) is preferred — it gives the LLM better type hints, defaults, and enum constraints.
 
 | Backend | Count | Best for |
 |---------|-------|----------|

{connectkit-0.1.2 → connectkit-0.1.4}/README.md

@@ -89,7 +89,28 @@ tool_sources:
 | `api_key` | API keys (Firecrawl, Stripe, Twilio, 288+ services) | Paste key into form → vaulted |
 | `none` | No auth needed (local tools) | Auto-connected |
 
-### Tool source backends
+### Tool descriptions (JSON Schema)
+
+Each tool can define its parameters as a JSON Schema:
+
+```yaml
+tool_descriptions:
+  - name: google_workspace__gmail_messages_list
+    description: "List recent emails from the user's Gmail inbox."
+    parameters:
+      type: object
+      properties:
+        max_results:
+          type: integer
+          description: "Maximum number of emails to return (default: 10)"
+          default: 10
+        query:
+          type: string
+          description: "Gmail search query (e.g. 'from:example@gmail.com', 'is:unread')"
+      required: []
+```
+
+Legacy `parameter_descriptions` (flat string map) is still supported for backward compatibility, but `parameters` (full JSON Schema) is preferred — it gives the LLM better type hints, defaults, and enum constraints.
 
 | Backend | Count | Best for |
 |---------|-------|----------|

{connectkit-0.1.2 → connectkit-0.1.4}/connectkit/__init__.py

@@ -3,7 +3,7 @@
 One YAML file per service. OAuth, token vault, and tool discovery handled automatically.
 """
 
-__version__ = "0.1.0"
+__version__ = "0.1.4"
 
 from connectkit.bridge import ConnectKitBridge
 from connectkit.meta_tools import TOOL_SPECS

{connectkit-0.1.2 → connectkit-0.1.4}/connectkit/backends/cli.py

@@ -118,14 +118,16 @@ class CLIAdapter:
                 else f"{self.spec.display}: {cmd}"
             )
 
-            parameter_descriptions = td.parameter_descriptions if td else {}
+            params = td.build_parameters() if td else {
+                "type": "object", "properties": {},
+            }
 
             tool_def = _build_connector_tool(
                 name=tool_name,
                 description=description,
                 adapter=self,
                 args=args_from_command(cmd),
-                parameter_descriptions=parameter_descriptions,
+                parameters=params,
             )
             tools.append(tool_def)
 
@@ -153,7 +155,7 @@ def _build_connector_tool(
     description: str,
     adapter: CLIAdapter,
     args: list[str],
-    parameter_descriptions: dict[str, str] | None = None,
+    parameters: dict[str, Any] | None = None,
 ) -> Any:
     """Build a ToolDefinition-compatible object for a connector tool.
 
@@ -197,12 +199,9 @@ def _build_connector_tool(
         import asyncio
         return await asyncio.to_thread(_sync_invoke, **kwargs)
 
-    params: dict[str, Any] = {
+    params: dict[str, Any] = parameters or {
         "type": "object",
-        "properties": {
-            k: {"type": "string", "description": v}
-            for k, v in (parameter_descriptions or {}).items()
-        },
+        "properties": {},
     }
 
     return {

{connectkit-0.1.2 → connectkit-0.1.4}/connectkit/spec.py

@@ -9,7 +9,7 @@ A connector is a YAML file that describes:
 
 from enum import Enum
 from pathlib import Path
-from typing import Literal
+from typing import Any, Literal
 
 import yaml
 from pydantic import BaseModel, Field, field_validator
@@ -101,8 +101,37 @@ ToolSource = CLIToolSource | MCPToolSource | HTTPToolSource
 
 class ToolDescription(BaseModel):
     name: str
-    description: str
-    parameter_descriptions: dict[str, str] = Field(default_factory=dict)
+    description: str = ""
+    parameters: dict[str, Any] = Field(default_factory=lambda: {
+        "type": "object",
+        "properties": {},
+    })
+    parameter_descriptions: dict[str, str] = Field(
+        default_factory=dict,
+        description="Deprecated — use 'parameters' (JSON Schema) instead.",
+    )
+
+    @field_validator("parameters")
+    @classmethod
+    def validate_parameters(cls, v: dict[str, Any]) -> dict[str, Any]:
+        if "type" not in v:
+            v["type"] = "object"
+        if "properties" not in v:
+            v["properties"] = {}
+        return v
+
+    def build_parameters(self) -> dict[str, Any]:
+        """Return a complete JSON Schema for this tool.
+
+        Prefers the explicit 'parameters' field. Falls back to building
+        a minimal schema from 'parameter_descriptions' for backward compat.
+        """
+        if self.parameter_descriptions and not self.parameters.get("properties"):
+            props = {}
+            for name, desc in self.parameter_descriptions.items():
+                props[name] = {"type": "string", "description": desc}
+            return {"type": "object", "properties": props}
+        return self.parameters
 
 
 class ConnectorSpec(BaseModel):

{connectkit-0.1.2 → connectkit-0.1.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "connectkit"
-version = "0.1.2"
+version = "0.1.4"
 description = "Connect AI agents to SaaS — one YAML file per service. OAuth, token vault, tool discovery."
 requires-python = ">=3.11"
 readme = "README.md"

{connectkit-0.1.2 → connectkit-0.1.4}/uv.lock

@@ -144,7 +144,7 @@ wheels = [
 
 [[package]]
 name = "connectkit"
-version = "0.1.1"
+version = "0.1.3"
 source = { editable = "." }
 dependencies = [
     { name = "cryptography" },