semanticapi-cli 0.1.0__tar.gz

semanticapi_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Peter Thompson / Cove AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

semanticapi_cli-0.1.0/PKG-INFO

@@ -0,0 +1,115 @@
+Metadata-Version: 2.4
+Name: semanticapi-cli
+Version: 0.1.0
+Summary: CLI for Semantic API — discover and query 700+ APIs with natural language
+Author-email: Peter Thompson <peter@coveai.dev>
+License: MIT
+Project-URL: Homepage, https://semanticapi.dev
+Project-URL: Documentation, https://semanticapi.dev/docs
+Project-URL: Repository, https://github.com/peter-j-thompson/semanticapi-cli
+Project-URL: Issues, https://github.com/peter-j-thompson/semanticapi-cli/issues
+Keywords: api,cli,semantic,discovery,mcp,ai-agents
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Internet :: WWW/HTTP
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Semantic API CLI
+
+Query 700+ APIs with natural language from your terminal. Zero dependencies.
+
+```bash
+pip install semanticapi
+```
+
+## Quick Start
+
+```bash
+# Save your API key
+semanticapi config set-key sapi_your_key
+
+# Query any API
+semanticapi query "send an SMS via Twilio"
+
+# Pre-check what you'll need (free, no LLM cost)
+semanticapi preflight "send an email"
+
+# Discover a provider
+semanticapi discover stripe
+
+# Batch queries
+semanticapi batch "send email" "upload file" "translate text"
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `query` | Natural language API query |
+| `batch` | Multiple queries in one call |
+| `preflight` | Pre-check (free, identifies needed auth) |
+| `discover` | Look up a provider by name |
+| `discover-url` | Discover provider from docs URL |
+| `status` | Show config and API health |
+| `config` | Manage API key and settings |
+
+## Authentication
+
+API key priority (first found wins):
+
+1. `--key sapi_xxx` flag
+2. `SEMANTICAPI_KEY` environment variable
+3. `~/.semanticapi/config.json` (saved via `config set-key`)
+
+Get your key at [semanticapi.dev](https://semanticapi.dev).
+
+## Output Modes
+
+```bash
+# Pretty-printed (default)
+semanticapi query "get weather"
+
+# Raw JSON (for piping)
+semanticapi --raw query "get weather"
+
+# Minimal output
+semanticapi --quiet query "get weather"
+```
+
+## Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| 0 | Success |
+| 1 | Error |
+| 2 | Auth required |
+
+## What You Get Back
+
+Every query returns:
+- **Provider** and endpoint details
+- **Code snippets** (curl + Python) ready to copy-paste
+- **Auth requirements** and setup instructions
+- **Alternative providers** ranked by relevance
+
+## Related
+
+- [Semantic API](https://semanticapi.dev) — The API
+- [MCP Server](https://pypi.org/project/semanticapi-mcp/) — For Claude Desktop / ChatGPT
+- [Agent Skill](https://pypi.org/project/semantic-api-skill/) — For autonomous agents
+- [Open Source Engine](https://github.com/peter-j-thompson/semanticapi-engine) — AGPL-3.0
+
+## License
+
+MIT

semanticapi_cli-0.1.0/README.md

@@ -0,0 +1,88 @@
+# Semantic API CLI
+
+Query 700+ APIs with natural language from your terminal. Zero dependencies.
+
+```bash
+pip install semanticapi
+```
+
+## Quick Start
+
+```bash
+# Save your API key
+semanticapi config set-key sapi_your_key
+
+# Query any API
+semanticapi query "send an SMS via Twilio"
+
+# Pre-check what you'll need (free, no LLM cost)
+semanticapi preflight "send an email"
+
+# Discover a provider
+semanticapi discover stripe
+
+# Batch queries
+semanticapi batch "send email" "upload file" "translate text"
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `query` | Natural language API query |
+| `batch` | Multiple queries in one call |
+| `preflight` | Pre-check (free, identifies needed auth) |
+| `discover` | Look up a provider by name |
+| `discover-url` | Discover provider from docs URL |
+| `status` | Show config and API health |
+| `config` | Manage API key and settings |
+
+## Authentication
+
+API key priority (first found wins):
+
+1. `--key sapi_xxx` flag
+2. `SEMANTICAPI_KEY` environment variable
+3. `~/.semanticapi/config.json` (saved via `config set-key`)
+
+Get your key at [semanticapi.dev](https://semanticapi.dev).
+
+## Output Modes
+
+```bash
+# Pretty-printed (default)
+semanticapi query "get weather"
+
+# Raw JSON (for piping)
+semanticapi --raw query "get weather"
+
+# Minimal output
+semanticapi --quiet query "get weather"
+```
+
+## Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| 0 | Success |
+| 1 | Error |
+| 2 | Auth required |
+
+## What You Get Back
+
+Every query returns:
+- **Provider** and endpoint details
+- **Code snippets** (curl + Python) ready to copy-paste
+- **Auth requirements** and setup instructions
+- **Alternative providers** ranked by relevance
+
+## Related
+
+- [Semantic API](https://semanticapi.dev) — The API
+- [MCP Server](https://pypi.org/project/semanticapi-mcp/) — For Claude Desktop / ChatGPT
+- [Agent Skill](https://pypi.org/project/semantic-api-skill/) — For autonomous agents
+- [Open Source Engine](https://github.com/peter-j-thompson/semanticapi-engine) — AGPL-3.0
+
+## License
+
+MIT

semanticapi_cli-0.1.0/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "semanticapi-cli"
+version = "0.1.0"
+description = "CLI for Semantic API — discover and query 700+ APIs with natural language"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.9"
+authors = [
+    {name = "Peter Thompson", email = "peter@coveai.dev"},
+]
+keywords = ["api", "cli", "semantic", "discovery", "mcp", "ai-agents"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Internet :: WWW/HTTP",
+]
+
+dependencies = []
+
+[project.scripts]
+semanticapi = "semanticapi_cli.cli:main"
+
+[project.urls]
+Homepage = "https://semanticapi.dev"
+Documentation = "https://semanticapi.dev/docs"
+Repository = "https://github.com/peter-j-thompson/semanticapi-cli"
+Issues = "https://github.com/peter-j-thompson/semanticapi-cli/issues"
+
+[tool.setuptools.packages.find]
+include = ["semanticapi_cli*"]

semanticapi_cli-0.1.0/semanticapi_cli/__init__.py

@@ -0,0 +1,12 @@
+"""
+Semantic API CLI
+================
+
+A command-line interface for Semantic API - discover and query APIs with natural language.
+
+Usage:
+    python -m semanticapi_cli query "send an SMS"
+    semanticapi query "send an SMS" --key sapi_your_key
+"""
+
+__version__ = "0.1.0"

semanticapi_cli-0.1.0/semanticapi_cli/__main__.py

@@ -0,0 +1,9 @@
+"""
+Entry point for python -m semanticapi_cli
+"""
+
+import sys
+from .cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())

semanticapi_cli-0.1.0/semanticapi_cli/api.py

@@ -0,0 +1,129 @@
+"""
+API client for Semantic API CLI.
+
+Uses stdlib urllib only - no external dependencies.
+"""
+
+import json
+import urllib.request
+import urllib.error
+import urllib.parse
+from typing import Optional, Dict, Any, Tuple
+
+
+class APIError(Exception):
+    """Error from Semantic API."""
+    def __init__(self, message: str, status_code: int = 0, details: Optional[Dict] = None):
+        super().__init__(message)
+        self.status_code = status_code
+        self.details = details or {}
+
+
+class APIClient:
+    """HTTP client for Semantic API."""
+    
+    def __init__(self, base_url: str, api_key: Optional[str] = None):
+        self.base_url = base_url.rstrip("/")
+        self.api_key = api_key
+    
+    def _request(
+        self, 
+        method: str, 
+        path: str, 
+        data: Optional[Dict] = None,
+        timeout: int = 60,
+    ) -> Tuple[int, Dict[str, Any]]:
+        """
+        Make HTTP request to API.
+        
+        Returns (status_code, response_json).
+        Raises APIError on failure.
+        """
+        url = f"{self.base_url}{path}"
+        
+        headers = {
+            "Content-Type": "application/json",
+            "Accept": "application/json",
+            "User-Agent": "semanticapi-cli/0.1.0",
+        }
+        
+        if self.api_key:
+            headers["Authorization"] = f"Bearer {self.api_key}"
+        
+        body = json.dumps(data).encode("utf-8") if data else None
+        
+        req = urllib.request.Request(url, data=body, headers=headers, method=method)
+        
+        try:
+            with urllib.request.urlopen(req, timeout=timeout) as response:
+                response_body = response.read().decode("utf-8")
+                try:
+                    return response.status, json.loads(response_body)
+                except json.JSONDecodeError:
+                    return response.status, {"raw": response_body}
+                    
+        except urllib.error.HTTPError as e:
+            body = e.read().decode("utf-8") if e.fp else ""
+            try:
+                error_data = json.loads(body)
+                detail = error_data.get("detail", str(e))
+            except json.JSONDecodeError:
+                detail = body or str(e)
+            
+            raise APIError(detail, status_code=e.code, details={"body": body})
+            
+        except urllib.error.URLError as e:
+            raise APIError(f"Connection failed: {e.reason}")
+        except TimeoutError:
+            raise APIError("Request timed out")
+    
+    def query(self, query: str, auto_discover: bool = True) -> Dict[str, Any]:
+        """Execute a natural language query."""
+        status, data = self._request("POST", "/api/query", {
+            "query": query,
+            "auto_discover": auto_discover,
+        })
+        return data
+    
+    def query_batch(self, queries: list) -> Dict[str, Any]:
+        """Execute multiple queries in one call."""
+        status, data = self._request("POST", "/api/query/batch", {
+            "queries": queries,
+        })
+        return data
+    
+    def preflight(self, query: str) -> Dict[str, Any]:
+        """Pre-analyze a query to identify needed providers."""
+        status, data = self._request("POST", "/api/query/preflight", {
+            "query": query,
+        })
+        return data
+    
+    def agentic(self, query: str, execution_id: Optional[str] = None) -> Dict[str, Any]:
+        """Execute a query with agentic (execution) mode."""
+        payload = {"query": query}
+        if execution_id:
+            payload["execution_id"] = execution_id
+        status, data = self._request("POST", "/api/query/agentic", payload, timeout=120)
+        return data
+    
+    def discover(self, provider_name: str, user_intent: Optional[str] = None) -> Dict[str, Any]:
+        """Discover a provider by name."""
+        payload = {"provider_name": provider_name}
+        if user_intent:
+            payload["user_intent"] = user_intent
+        status, data = self._request("POST", "/api/discover/search", payload, timeout=60)
+        return data
+    
+    def discover_url(self, url: str, user_intent: Optional[str] = None) -> Dict[str, Any]:
+        """Discover a provider from documentation URL."""
+        payload = {"url": url}
+        if user_intent:
+            payload["user_intent"] = user_intent
+        status, data = self._request("POST", "/api/discover/from-url", payload, timeout=60)
+        return data
+    
+    def health(self) -> Dict[str, Any]:
+        """Get API health status."""
+        status, data = self._request("GET", "/api/health")
+        return data