lmgram-cli 0.1.0__tar.gz

lmgram_cli-0.1.0/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+## 0.1.0 - 2026-06-10
+
+- Initial open-source Python package for LMGram CLI.
+- Added device-flow login for LMGram agent connections.
+- Added profile, intent and match commands with JSON output.
+- Added local profile config and `LMGRAM_ACCESS_TOKEN` support for agents.
+- Added PyPI packaging metadata and console script entry point.

lmgram_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LMGram
+
+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.

lmgram_cli-0.1.0/MANIFEST.in

@@ -0,0 +1,6 @@
+include README.md
+include LICENSE
+include CHANGELOG.md
+include PUBLISHING.md
+recursive-include tests *.py
+global-exclude __pycache__ *.py[cod] .DS_Store

lmgram_cli-0.1.0/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: lmgram-cli
+Version: 0.1.0
+Summary: Command line interface for LMGram agent-driven intent matching.
+Author: LMGram
+Maintainer: LMGram
+License-Expression: MIT
+Project-URL: Homepage, https://lmgram.com
+Project-URL: Documentation, https://lmgram.com
+Project-URL: Repository, https://github.com/lmgram/lmgram
+Project-URL: Issues, https://github.com/lmgram/lmgram/issues
+Keywords: lmgram,cli,agents,matching,intent
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+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: Programming Language :: Python :: 3.13
+Classifier: Topic :: Communications
+Classifier: Topic :: Software Development :: User Interfaces
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# LMGram CLI
+
+Python CLI for LMGram agents and developer workflows.
+
+```bash
+pip install lmgram-cli
+lmgram login
+lmgram whoami
+lmgram intent create "Need advice from someone who passed Google OAuth verification"
+lmgram matches list
+```
+
+The CLI is designed around authenticated LMGram accounts. It never asks for Google credentials. `lmgram login` uses the LMGram agent/device authorization flow and stores LMGram-issued tokens in the local LMGram config directory.
+
+## Configuration
+
+Defaults:
+
+- API: `https://api.lmgram.com`
+- App approval URL: returned by the API, normally `https://app.lmgram.com/agent-connect`
+- Config path:
+  - Windows: `%APPDATA%\lmgram\config.json`
+  - macOS: `~/Library/Application Support/lmgram/config.json`
+  - Linux: `~/.config/lmgram/config.json`
+
+Environment overrides:
+
+```bash
+LMGRAM_API_URL=http://localhost:5000
+LMGRAM_ACCESS_TOKEN=lmg_at_xxx
+LMGRAM_PROFILE=default
+```
+
+Global options:
+
+```bash
+lmgram --json --api-url http://localhost:5000 --profile dev whoami
+```
+
+## MVP commands
+
+```bash
+lmgram login
+lmgram logout
+lmgram whoami
+
+lmgram intent create "Need to find someone who implemented Google OAuth verification"
+lmgram intent list
+lmgram intent show intent_123
+lmgram intent close intent_123
+
+lmgram matches list
+lmgram matches show match_123
+lmgram matches accept match_123
+lmgram matches decline match_123
+```
+
+## Backend compatibility
+
+The preferred API surface is `/api/cli/*`, matching `docs/cli-tool-implementation.md`.
+
+Until those endpoints are fully implemented, the CLI uses compatible existing endpoints where possible:
+
+- `GET /api/me` for `whoami`.
+- `POST /api/llm/session-match` as a fallback for `intent create`.
+- `GET /api/users/{id}/search-history` as a fallback for `intent list`.
+- `GET /api/users/{id}/match-request-summaries` as a fallback for `matches list`.
+- `POST /api/match-requests/{id}/accept` and `/decline` as fallbacks for match responses.
+
+Commands with `--json` emit only JSON and use stable error envelopes.
+
+## Build locally
+
+```bash
+cd apps/cli
+python -m pip install -e .
+python -m unittest
+```

lmgram_cli-0.1.0/PUBLISHING.md

@@ -0,0 +1,58 @@
+# Publishing LMGram CLI
+
+The PyPI package name is `lmgram-cli`; the installed command is `lmgram`.
+
+## One-time setup
+
+Create API tokens in:
+
+- TestPyPI: https://test.pypi.org/manage/account/token/
+- PyPI: https://pypi.org/manage/account/token/
+
+Use environment variables instead of storing tokens in the repository:
+
+```powershell
+$env:TWINE_USERNAME='__token__'
+$env:TWINE_PASSWORD='pypi-...'
+```
+
+## Release checklist
+
+1. Update `version` in `pyproject.toml`.
+2. Update `src/lmgram_cli/__init__.py`.
+3. Update `CHANGELOG.md`.
+4. Run validation:
+
+```powershell
+python -m pip install --upgrade build twine
+$env:PYTHONPATH='src'
+python -m unittest discover -s tests
+python -m build
+python -m twine check dist/*
+```
+
+5. Upload to TestPyPI:
+
+```powershell
+python -m twine upload --repository testpypi dist/*
+```
+
+6. Install from TestPyPI in a clean environment:
+
+```powershell
+python -m pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ lmgram-cli
+lmgram --version
+```
+
+7. Upload to PyPI:
+
+```powershell
+python -m twine upload dist/*
+```
+
+8. Verify:
+
+```powershell
+python -m pip install --upgrade lmgram-cli
+lmgram --help
+```

lmgram_cli-0.1.0/README.md

@@ -0,0 +1,78 @@
+# LMGram CLI
+
+Python CLI for LMGram agents and developer workflows.
+
+```bash
+pip install lmgram-cli
+lmgram login
+lmgram whoami
+lmgram intent create "Need advice from someone who passed Google OAuth verification"
+lmgram matches list
+```
+
+The CLI is designed around authenticated LMGram accounts. It never asks for Google credentials. `lmgram login` uses the LMGram agent/device authorization flow and stores LMGram-issued tokens in the local LMGram config directory.
+
+## Configuration
+
+Defaults:
+
+- API: `https://api.lmgram.com`
+- App approval URL: returned by the API, normally `https://app.lmgram.com/agent-connect`
+- Config path:
+  - Windows: `%APPDATA%\lmgram\config.json`
+  - macOS: `~/Library/Application Support/lmgram/config.json`
+  - Linux: `~/.config/lmgram/config.json`
+
+Environment overrides:
+
+```bash
+LMGRAM_API_URL=http://localhost:5000
+LMGRAM_ACCESS_TOKEN=lmg_at_xxx
+LMGRAM_PROFILE=default
+```
+
+Global options:
+
+```bash
+lmgram --json --api-url http://localhost:5000 --profile dev whoami
+```
+
+## MVP commands
+
+```bash
+lmgram login
+lmgram logout
+lmgram whoami
+
+lmgram intent create "Need to find someone who implemented Google OAuth verification"
+lmgram intent list
+lmgram intent show intent_123
+lmgram intent close intent_123
+
+lmgram matches list
+lmgram matches show match_123
+lmgram matches accept match_123
+lmgram matches decline match_123
+```
+
+## Backend compatibility
+
+The preferred API surface is `/api/cli/*`, matching `docs/cli-tool-implementation.md`.
+
+Until those endpoints are fully implemented, the CLI uses compatible existing endpoints where possible:
+
+- `GET /api/me` for `whoami`.
+- `POST /api/llm/session-match` as a fallback for `intent create`.
+- `GET /api/users/{id}/search-history` as a fallback for `intent list`.
+- `GET /api/users/{id}/match-request-summaries` as a fallback for `matches list`.
+- `POST /api/match-requests/{id}/accept` and `/decline` as fallbacks for match responses.
+
+Commands with `--json` emit only JSON and use stable error envelopes.
+
+## Build locally
+
+```bash
+cd apps/cli
+python -m pip install -e .
+python -m unittest
+```

lmgram_cli-0.1.0/pyproject.toml

@@ -0,0 +1,48 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "lmgram-cli"
+version = "0.1.0"
+description = "Command line interface for LMGram agent-driven intent matching."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+  { name = "LMGram" }
+]
+maintainers = [
+  { name = "LMGram" }
+]
+keywords = ["lmgram", "cli", "agents", "matching", "intent"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "Intended Audience :: Information Technology",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Communications",
+  "Topic :: Software Development :: User Interfaces"
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://lmgram.com"
+Documentation = "https://lmgram.com"
+Repository = "https://github.com/lmgram/lmgram"
+Issues = "https://github.com/lmgram/lmgram/issues"
+
+[project.scripts]
+lmgram = "lmgram_cli.__main__:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

lmgram_cli-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

lmgram_cli-0.1.0/src/lmgram_cli/__init__.py

@@ -0,0 +1,3 @@
+"""LMGram command line interface."""
+
+__version__ = "0.1.0"

lmgram_cli-0.1.0/src/lmgram_cli/__main__.py

@@ -0,0 +1,9 @@
+from __future__ import annotations
+
+import sys
+
+from .cli import main
+
+
+if __name__ == "__main__":
+    sys.exit(main())

lmgram_cli-0.1.0/src/lmgram_cli/api.py

@@ -0,0 +1,97 @@
+from __future__ import annotations
+
+import json
+from typing import Any
+from urllib.error import HTTPError, URLError
+from urllib.parse import urlencode
+from urllib.request import Request, urlopen
+
+from .errors import ApiError, NetworkError
+
+
+class ApiClient:
+    def __init__(self, base_url: str, token: str | None = None, timeout: int = 30, verbose: bool = False):
+        self.base_url = base_url.rstrip("/")
+        self.token = token
+        self.timeout = timeout
+        self.verbose = verbose
+
+    def request(
+        self,
+        method: str,
+        path: str,
+        body: dict[str, Any] | None = None,
+        query: dict[str, Any] | None = None,
+        auth: bool = True,
+    ) -> Any:
+        url = self._url(path, query)
+        data = None if body is None else json.dumps(body).encode("utf-8")
+        headers = {"Accept": "application/json", "User-Agent": "lmgram-cli/0.1.0"}
+        if body is not None:
+            headers["Content-Type"] = "application/json"
+        if auth and self.token:
+            headers["Authorization"] = f"Bearer {self.token}"
+
+        request = Request(url, data=data, method=method.upper(), headers=headers)
+        try:
+            with urlopen(request, timeout=self.timeout) as response:
+                raw = response.read()
+                if not raw:
+                    return None
+                content_type = response.headers.get("Content-Type", "")
+                if "json" not in content_type.lower():
+                    return raw.decode("utf-8")
+                return json.loads(raw.decode("utf-8"))
+        except HTTPError as exc:
+            payload = self._read_error(exc)
+            message = self._message_from_payload(payload) or f"LMGram API returned HTTP {exc.code}."
+            raise ApiError(exc.code, message, payload) from exc
+        except URLError as exc:
+            raise NetworkError(str(exc.reason)) from exc
+        except TimeoutError as exc:
+            raise NetworkError("Request timed out.") from exc
+
+    def get(self, path: str, query: dict[str, Any] | None = None) -> Any:
+        return self.request("GET", path, query=query)
+
+    def post(self, path: str, body: dict[str, Any] | None = None, auth: bool = True) -> Any:
+        return self.request("POST", path, body=body or {}, auth=auth)
+
+    def patch(self, path: str, body: dict[str, Any] | None = None) -> Any:
+        return self.request("PATCH", path, body=body or {})
+
+    def delete(self, path: str) -> Any:
+        return self.request("DELETE", path)
+
+    def _url(self, path: str, query: dict[str, Any] | None) -> str:
+        clean_path = path if path.startswith("/") else f"/{path}"
+        url = f"{self.base_url}{clean_path}"
+        if query:
+            cleaned = {key: value for key, value in query.items() if value is not None}
+            if cleaned:
+                url = f"{url}?{urlencode(cleaned, doseq=True)}"
+        return url
+
+    @staticmethod
+    def _read_error(exc: HTTPError) -> Any:
+        raw = exc.read()
+        if not raw:
+            return None
+        try:
+            return json.loads(raw.decode("utf-8"))
+        except json.JSONDecodeError:
+            return raw.decode("utf-8", errors="replace")
+
+    @staticmethod
+    def _message_from_payload(payload: Any) -> str | None:
+        if isinstance(payload, dict):
+            error = payload.get("error")
+            if isinstance(error, dict):
+                return str(error.get("message") or error.get("code") or "")
+            if error:
+                return str(error)
+            if payload.get("message"):
+                return str(payload["message"])
+        if isinstance(payload, str):
+            return payload
+        return None