moss-cli 0.1.1__tar.gz → 0.2.1__tar.gz

{moss_cli-0.1.1/src/moss_cli.egg-info → moss_cli-0.2.1}/PKG-INFO

@@ -1,8 +1,9 @@
 Metadata-Version: 2.4
 Name: moss-cli
-Version: 0.1.1
+Version: 0.2.1
 Summary: Command-line interface for Moss semantic search
 Author-email: "InferEdge Inc." <contact@usemoss.dev>
+License-Expression: LicenseRef-PolyForm-Shield-1.0.0
 Keywords: search,semantic,cli,moss
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
@@ -16,23 +17,23 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: moss>=1.0.0
-Requires-Dist: typer>=0.9.0
-Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.26.8
+Requires-Dist: rich>=15.0.0
 Provides-Extra: dev
-Requires-Dist: pytest>=8.0.0; extra == "dev"
-Requires-Dist: black>=24.0.0; extra == "dev"
-Requires-Dist: isort>=5.0.0; extra == "dev"
-Requires-Dist: flake8>=7.0.0; extra == "dev"
-Requires-Dist: mypy>=1.0.0; extra == "dev"
-Requires-Dist: build>=1.0.0; extra == "dev"
-Requires-Dist: twine>=5.0.0; extra == "dev"
+Requires-Dist: pytest>=9.1.1; extra == "dev"
+Requires-Dist: black<26,>=25.9.0; extra == "dev"
+Requires-Dist: isort<8,>=7.0.0; extra == "dev"
+Requires-Dist: flake8>=7.3.0; extra == "dev"
+Requires-Dist: mypy>=2.1.0; extra == "dev"
+Requires-Dist: build>=1.5.0; extra == "dev"
+Requires-Dist: twine>=6.2.0; extra == "dev"
 Dynamic: license-file
 
 # Moss CLI
 
 **Command-line interface for Moss semantic search** — manage indexes, documents, and queries directly from your terminal.
 
-Moss CLI wraps the [Moss Python SDK](https://docs.usemoss.dev/) so you can build and query semantic search indexes without writing any code. Ideal for quick prototyping, scripting, CI/CD pipelines, and data workflows.
+Moss CLI wraps the [Moss Python SDK](https://docs.moss.dev/) so you can build and query semantic search indexes without writing any code. Ideal for quick prototyping, scripting, CI/CD pipelines, and data workflows.
 
 ## Features
 
@@ -40,8 +41,9 @@ Moss CLI wraps the [Moss Python SDK](https://docs.usemoss.dev/) so you can build
 - **Semantic search** — query indexes with configurable hybrid search (semantic + keyword)
 - **Index management** — create, list, inspect, and delete indexes
 - **Document management** — add, update, retrieve, and delete documents
-- **Local by default** — downloads indexes for on-device queries, `--cloud` to skip
+- **Local by default** — downloads indexes and queries them on-device
 - **Flexible auth** — CLI flags, environment variables, or config file
+- **Log in from the terminal** — `moss login`, then create project keys with `moss keys create`
 - **Multiple output formats** — rich tables for humans, `--json` for scripts
 - **Job tracking** — poll background jobs with live progress display
 - **Pipe-friendly** — stdin/stdout support for composing with other tools
@@ -66,9 +68,6 @@ moss index create my-index -f docs.json --wait
 
 # 4. Search it
 moss query my-index "what is machine learning"
-
-# 5. Search via cloud API (skips local download)
-moss query my-index "neural networks" --cloud
 ```
 
 ## Authentication
@@ -88,9 +87,56 @@ export MOSS_PROJECT_ID="your-project-id"
 export MOSS_PROJECT_KEY="your-project-key"
 
 # Option 3: Inline flags
-moss index list --project-id "..." --project-key "..."
+moss --project-id "..." --project-key "..." index list
+```
+
+## Log in and create keys
+
+`moss login` connects the CLI to your Moss account, so you can create project keys without opening the dashboard.
+
+```bash
+# Opens the browser. Check the code matches, then click Approve.
+moss login
+
+moss whoami
+moss projects list
+
+# Prints the key once, plus MOSS_PROJECT_ID / MOSS_PROJECT_KEY lines
+moss keys create --project <project-id> --name "prod server"
+moss keys list --project <project-id>
+moss keys delete --project <project-id> <key-id>
+
+# Revoke the token and remove it from ~/.moss/config.json
+moss logout
+```
+
+The token is saved to `~/.moss/config.json`. It lives until you run `moss logout` or revoke it in Settings > API Keys. It acts as you: only workspace owners, admins and a project's owner can create or delete its keys. `--project` defaults to the project saved by `moss init`.
+
+Use `moss login --no-browser` on a machine without a browser (for example over SSH) and open the printed link anywhere.
+
+## Agents and CI
+
+CI that only queries or uploads to one project needs a project key, not a login. Create one with `moss keys create` and store it as `MOSS_PROJECT_ID` / `MOSS_PROJECT_KEY`.
+
+Agents that create or delete keys need a CLI token. Make a separate one for each agent, so logging in or out on your machine doesn't break it:
+
+```bash
+# Approve in the browser; the token is printed, not saved
+moss login --print-token --name "deploy agent"
+```
+
+Store it as `MOSS_TOKEN` in your secret store, then:
+
+```bash
+export MOSS_TOKEN="mossc_..."
+moss keys create --project <project-id> --json
+# {"project_id": "...", "key_id": "...", "secret": "moss_..."}
 ```
 
+The token acts as you, so it loses access to a workspace when you do. Revoke it in Settings > API Keys.
+
+The token is resolved from `--token`, then `MOSS_TOKEN`, then the config file. The saved token is only sent to the dashboard that issued it, so with `--api-url` pointing elsewhere, log in there or pass `--token`. A `--token` or `MOSS_TOKEN` goes to production unless `--api-url` / `MOSS_API_URL` says otherwise.
+
 ## Commands
 
 ### Index Management
@@ -141,9 +187,6 @@ moss query my-index "what is deep learning"
 # Tune results: more results, keyword-heavy
 moss query my-index "neural networks" --top-k 20 --alpha 0.3
 
-# Cloud mode (skip download, query via cloud API)
-moss query my-index "transformers" --cloud
-
 # With metadata filter (local only)
 moss query my-index "shoes" --filter '{"field": "category", "condition": {"$eq": "footwear"}}'
 
@@ -151,7 +194,7 @@ moss query my-index "shoes" --filter '{"field": "category", "condition": {"$eq":
 echo "what is AI" | moss query my-index
 
 # JSON output for scripting
-moss query my-index "query" --json | jq '.docs[0].text'
+moss --json query my-index "query" | jq '.docs[0].text'
 ```
 
 ### Job Tracking
@@ -170,9 +213,9 @@ moss job status <job-id> --wait
 # Print version info
 moss version
 
-# Global JSON output
-moss index list --json
-moss doc get my-index --json
+# Global JSON output, before the command
+moss --json index list
+moss --json doc get my-index
 ```
 
 ## Document File Format
@@ -211,6 +254,8 @@ cat docs.json | moss doc add my-index -f -
 |---|---|---|
 | `--project-id` | `-p` | Project ID (overrides env/config) |
 | `--project-key` | | Project key (overrides env/config) |
+| `--token` | | CLI token from `moss login` (or `MOSS_TOKEN`) |
+| `--api-url` | | Dashboard URL, for staging or local testing (or `MOSS_API_URL`) |
 | `--json` | | Machine-readable JSON output |
 | `--verbose` | `-v` | Enable debug logging |
 
@@ -226,4 +271,4 @@ cat docs.json | moss doc add my-index -f -
 
 Copyright (c) 2026 InferEdge Inc. — PolyForm Shield License 1.0.0.
 
-See [LICENSE](LICENSE) for full terms. For commercial licensing, contact contact@usemoss.dev.
+See [LICENSE](LICENSE) for full terms. For commercial licensing, contact contact@moss.dev.

{moss_cli-0.1.1 → moss_cli-0.2.1}/README.md

@@ -2,7 +2,7 @@
 
 **Command-line interface for Moss semantic search** — manage indexes, documents, and queries directly from your terminal.
 
-Moss CLI wraps the [Moss Python SDK](https://docs.usemoss.dev/) so you can build and query semantic search indexes without writing any code. Ideal for quick prototyping, scripting, CI/CD pipelines, and data workflows.
+Moss CLI wraps the [Moss Python SDK](https://docs.moss.dev/) so you can build and query semantic search indexes without writing any code. Ideal for quick prototyping, scripting, CI/CD pipelines, and data workflows.
 
 ## Features
 
@@ -10,8 +10,9 @@ Moss CLI wraps the [Moss Python SDK](https://docs.usemoss.dev/) so you can build
 - **Semantic search** — query indexes with configurable hybrid search (semantic + keyword)
 - **Index management** — create, list, inspect, and delete indexes
 - **Document management** — add, update, retrieve, and delete documents
-- **Local by default** — downloads indexes for on-device queries, `--cloud` to skip
+- **Local by default** — downloads indexes and queries them on-device
 - **Flexible auth** — CLI flags, environment variables, or config file
+- **Log in from the terminal** — `moss login`, then create project keys with `moss keys create`
 - **Multiple output formats** — rich tables for humans, `--json` for scripts
 - **Job tracking** — poll background jobs with live progress display
 - **Pipe-friendly** — stdin/stdout support for composing with other tools
@@ -36,9 +37,6 @@ moss index create my-index -f docs.json --wait
 
 # 4. Search it
 moss query my-index "what is machine learning"
-
-# 5. Search via cloud API (skips local download)
-moss query my-index "neural networks" --cloud
 ```
 
 ## Authentication
@@ -58,9 +56,56 @@ export MOSS_PROJECT_ID="your-project-id"
 export MOSS_PROJECT_KEY="your-project-key"
 
 # Option 3: Inline flags
-moss index list --project-id "..." --project-key "..."
+moss --project-id "..." --project-key "..." index list
+```
+
+## Log in and create keys
+
+`moss login` connects the CLI to your Moss account, so you can create project keys without opening the dashboard.
+
+```bash
+# Opens the browser. Check the code matches, then click Approve.
+moss login
+
+moss whoami
+moss projects list
+
+# Prints the key once, plus MOSS_PROJECT_ID / MOSS_PROJECT_KEY lines
+moss keys create --project <project-id> --name "prod server"
+moss keys list --project <project-id>
+moss keys delete --project <project-id> <key-id>
+
+# Revoke the token and remove it from ~/.moss/config.json
+moss logout
+```
+
+The token is saved to `~/.moss/config.json`. It lives until you run `moss logout` or revoke it in Settings > API Keys. It acts as you: only workspace owners, admins and a project's owner can create or delete its keys. `--project` defaults to the project saved by `moss init`.
+
+Use `moss login --no-browser` on a machine without a browser (for example over SSH) and open the printed link anywhere.
+
+## Agents and CI
+
+CI that only queries or uploads to one project needs a project key, not a login. Create one with `moss keys create` and store it as `MOSS_PROJECT_ID` / `MOSS_PROJECT_KEY`.
+
+Agents that create or delete keys need a CLI token. Make a separate one for each agent, so logging in or out on your machine doesn't break it:
+
+```bash
+# Approve in the browser; the token is printed, not saved
+moss login --print-token --name "deploy agent"
+```
+
+Store it as `MOSS_TOKEN` in your secret store, then:
+
+```bash
+export MOSS_TOKEN="mossc_..."
+moss keys create --project <project-id> --json
+# {"project_id": "...", "key_id": "...", "secret": "moss_..."}
 ```
 
+The token acts as you, so it loses access to a workspace when you do. Revoke it in Settings > API Keys.
+
+The token is resolved from `--token`, then `MOSS_TOKEN`, then the config file. The saved token is only sent to the dashboard that issued it, so with `--api-url` pointing elsewhere, log in there or pass `--token`. A `--token` or `MOSS_TOKEN` goes to production unless `--api-url` / `MOSS_API_URL` says otherwise.
+
 ## Commands
 
 ### Index Management
@@ -111,9 +156,6 @@ moss query my-index "what is deep learning"
 # Tune results: more results, keyword-heavy
 moss query my-index "neural networks" --top-k 20 --alpha 0.3
 
-# Cloud mode (skip download, query via cloud API)
-moss query my-index "transformers" --cloud
-
 # With metadata filter (local only)
 moss query my-index "shoes" --filter '{"field": "category", "condition": {"$eq": "footwear"}}'
 
@@ -121,7 +163,7 @@ moss query my-index "shoes" --filter '{"field": "category", "condition": {"$eq":
 echo "what is AI" | moss query my-index
 
 # JSON output for scripting
-moss query my-index "query" --json | jq '.docs[0].text'
+moss --json query my-index "query" | jq '.docs[0].text'
 ```
 
 ### Job Tracking
@@ -140,9 +182,9 @@ moss job status <job-id> --wait
 # Print version info
 moss version
 
-# Global JSON output
-moss index list --json
-moss doc get my-index --json
+# Global JSON output, before the command
+moss --json index list
+moss --json doc get my-index
 ```
 
 ## Document File Format
@@ -181,6 +223,8 @@ cat docs.json | moss doc add my-index -f -
 |---|---|---|
 | `--project-id` | `-p` | Project ID (overrides env/config) |
 | `--project-key` | | Project key (overrides env/config) |
+| `--token` | | CLI token from `moss login` (or `MOSS_TOKEN`) |
+| `--api-url` | | Dashboard URL, for staging or local testing (or `MOSS_API_URL`) |
 | `--json` | | Machine-readable JSON output |
 | `--verbose` | `-v` | Enable debug logging |
 
@@ -196,4 +240,4 @@ cat docs.json | moss doc add my-index -f -
 
 Copyright (c) 2026 InferEdge Inc. — PolyForm Shield License 1.0.0.
 
-See [LICENSE](LICENSE) for full terms. For commercial licensing, contact contact@usemoss.dev.
+See [LICENSE](LICENSE) for full terms. For commercial licensing, contact contact@moss.dev.

{moss_cli-0.1.1 → moss_cli-0.2.1}/pyproject.toml

@@ -1,13 +1,14 @@
 [build-system]
-requires = ["setuptools>=61.0", "wheel"]
+requires = ["setuptools>=77.0", "wheel"]
 build-backend = "setuptools.build_meta"
 
 [project]
 name = "moss-cli"
-version = "0.1.1"
+version = "0.2.1"
 description = "Command-line interface for Moss semantic search"
 readme = "README.md"
 requires-python = ">=3.10"
+license = "LicenseRef-PolyForm-Shield-1.0.0"
 license-files = ["LICENSE"]
 authors = [
     { name = "InferEdge Inc.", email = "contact@usemoss.dev" }
@@ -25,19 +26,19 @@ classifiers = [
 ]
 dependencies = [
     "moss>=1.0.0",
-    "typer>=0.9.0",
-    "rich>=13.0.0",
+    "typer>=0.26.8",
+    "rich>=15.0.0",
 ]
 
 [project.optional-dependencies]
 dev = [
-    "pytest>=8.0.0",
-    "black>=24.0.0",
-    "isort>=5.0.0",
-    "flake8>=7.0.0",
-    "mypy>=1.0.0",
-    "build>=1.0.0",
-    "twine>=5.0.0",
+    "pytest>=9.1.1",
+    "black>=25.9.0,<26",
+    "isort>=7.0.0,<8",
+    "flake8>=7.3.0",
+    "mypy>=2.1.0",
+    "build>=1.5.0",
+    "twine>=6.2.0",
 ]
 
 [project.scripts]

{moss_cli-0.1.1 → moss_cli-0.2.1}/src/moss_cli/__init__.py

@@ -1,3 +1,3 @@
 """Moss CLI - Command-line interface for Moss semantic search."""
 
-__version__ = "0.1.1"
+__version__ = "0.2.1"

moss_cli-0.2.1/src/moss_cli/api.py

@@ -0,0 +1,106 @@
+"""HTTP client for the dashboard's CLI routes (login, projects, keys)."""
+
+from __future__ import annotations
+
+import json
+import urllib.error
+import urllib.request
+from typing import Any, Dict, Optional, Tuple
+
+import moss_cli
+
+
+class ApiError(Exception):
+    def __init__(self, status: int, message: str, code: Optional[str] = None) -> None:
+        super().__init__(message)
+        self.status = status
+        self.code = code
+
+
+class _NoRedirect(urllib.request.HTTPRedirectHandler):
+    # urllib copies the Authorization header onto a redirect, even to another host.
+    def redirect_request(self, *args: Any, **kwargs: Any) -> None:
+        return None
+
+
+_opener = urllib.request.build_opener(_NoRedirect)
+
+
+def request(
+    api_url: str,
+    method: str,
+    path: str,
+    token: Optional[str] = None,
+    body: Optional[Dict[str, Any]] = None,
+) -> Tuple[int, Dict[str, Any]]:
+    """Send a request and return (status, json body). Never raises on an HTTP error status.
+
+    Raises ApiError only when the server doesn't answer like a Moss dashboard with CLI
+    login: a redirect or an HTML page. That's the sign of an old dashboard or a wrong
+    --api-url, not a transient failure, so a retry loop must not swallow it.
+    """
+    data = json.dumps(body).encode() if body is not None else None
+    headers = {
+        "Accept": "application/json",
+        "User-Agent": f"moss-cli/{moss_cli.__version__}",
+    }
+    if data is not None:
+        headers["Content-Type"] = "application/json"
+    if token:
+        headers["Authorization"] = f"Bearer {token}"
+    req = urllib.request.Request(
+        api_url.rstrip("/") + path, data=data, headers=headers, method=method
+    )
+    try:
+        with _opener.open(req, timeout=30) as res:
+            status, content_type, raw = (
+                res.status,
+                res.headers.get("Content-Type"),
+                res.read(),
+            )
+    except urllib.error.HTTPError as e:
+        status, content_type, raw = e.code, e.headers.get("Content-Type"), e.read()
+
+    # An old dashboard answers these routes with a redirect to the login page, and a wrong
+    # --api-url may answer with HTML. A 5xx or 429 may be a gateway page, which callers
+    # retry, so it stays a plain status.
+    retryable = status >= 500 or status == 429
+    if 300 <= status < 400 or (not retryable and raw and not _is_json(content_type)):
+        raise ApiError(
+            status,
+            f"{api_url} did not answer like a Moss dashboard with CLI login (HTTP {status}). "
+            "Check --api-url / MOSS_API_URL, or ask for the dashboard to be updated.",
+        )
+    return status, _parse(raw)
+
+
+def call(
+    api_url: str,
+    method: str,
+    path: str,
+    token: Optional[str] = None,
+    body: Optional[Dict[str, Any]] = None,
+) -> Dict[str, Any]:
+    """Like request(), but raises ApiError for any non-2xx status."""
+    status, payload = request(api_url, method, path, token, body)
+    if status >= 400:
+        message = payload.get("error") or f"Request failed ({status})"
+        if status == 401 and token:
+            message = (
+                "Your CLI token is invalid or revoked. Run 'moss login' again, or replace "
+                "MOSS_TOKEN / --token with a new one from 'moss login --print-token'."
+            )
+        raise ApiError(status, message, payload.get("code"))
+    return payload
+
+
+def _is_json(content_type: Optional[str]) -> bool:
+    return "json" in (content_type or "").lower()
+
+
+def _parse(raw: bytes) -> Dict[str, Any]:
+    try:
+        parsed = json.loads(raw or b"{}")
+    except json.JSONDecodeError:
+        return {}
+    return parsed if isinstance(parsed, dict) else {}