ai-agent-gateway-cli 0.1.0__tar.gz

ai_agent_gateway_cli-0.1.0/PKG-INFO

@@ -0,0 +1,43 @@
+Metadata-Version: 2.4
+Name: ai-agent-gateway-cli
+Version: 0.1.0
+Summary: Canonical dev CLI client for ai-agent-gateway
+License-Expression: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.27.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Requires-Dist: httpx>=0.27.0; extra == "dev"
+
+# ai-agent-gateway-cli
+
+Canonical Python dev CLI for the `ai-agent-gateway` HTTP/SSE protocol.
+
+## Usage
+
+```bash
+python -m agent_gateway_cli login
+python -m agent_gateway_cli chat "hello"
+python -m agent_gateway_cli --config-namespace cashnerd login
+python -m agent_gateway_cli --config-namespace cashnerd chat --session default "hello"
+```
+
+The default config namespace is `agent-gateway`, which writes:
+
+- `~/.cache/agent-gateway/cli_config.json`
+- `~/.cache/agent-gateway/sessions/<name>.json`
+
+`--config-namespace cashnerd` writes under `~/.cache/cashnerd/` instead.
+
+## Contract
+
+The CLI sends `context.channel = "cli"` on every chat request. When `user_id`
+is configured, it is sent as a top-level field on both `/api/chat/init` and
+`/api/chat`. Tool approvals post `tool_call_id`, `nonce`, `approved`, and
+`allow_tool_type`.
+
+The default `BaseUrlPolicy` is intentionally strict: `http://127.0.0.1` only,
+with no path, query, or fragment. Products that need a wider local policy can
+inject `BaseUrlPolicy(allowed_schemes=..., allowed_hostnames=...)`.

ai_agent_gateway_cli-0.1.0/README.md

@@ -0,0 +1,30 @@
+# ai-agent-gateway-cli
+
+Canonical Python dev CLI for the `ai-agent-gateway` HTTP/SSE protocol.
+
+## Usage
+
+```bash
+python -m agent_gateway_cli login
+python -m agent_gateway_cli chat "hello"
+python -m agent_gateway_cli --config-namespace cashnerd login
+python -m agent_gateway_cli --config-namespace cashnerd chat --session default "hello"
+```
+
+The default config namespace is `agent-gateway`, which writes:
+
+- `~/.cache/agent-gateway/cli_config.json`
+- `~/.cache/agent-gateway/sessions/<name>.json`
+
+`--config-namespace cashnerd` writes under `~/.cache/cashnerd/` instead.
+
+## Contract
+
+The CLI sends `context.channel = "cli"` on every chat request. When `user_id`
+is configured, it is sent as a top-level field on both `/api/chat/init` and
+`/api/chat`. Tool approvals post `tool_call_id`, `nonce`, `approved`, and
+`allow_tool_type`.
+
+The default `BaseUrlPolicy` is intentionally strict: `http://127.0.0.1` only,
+with no path, query, or fragment. Products that need a wider local policy can
+inject `BaseUrlPolicy(allowed_schemes=..., allowed_hostnames=...)`.

ai_agent_gateway_cli-0.1.0/agent_gateway_cli/__init__.py

@@ -0,0 +1,18 @@
+from __future__ import annotations
+
+from .cli import DevChatCLI, main
+from .config import BaseUrlPolicy, CLIConfig, CLIError
+from .session import SessionState
+from .transport import GatewaySession, GatewayTransport
+
+
+__all__ = [
+    "BaseUrlPolicy",
+    "CLIConfig",
+    "CLIError",
+    "DevChatCLI",
+    "GatewaySession",
+    "GatewayTransport",
+    "SessionState",
+    "main",
+]

ai_agent_gateway_cli-0.1.0/agent_gateway_cli/__main__.py

@@ -0,0 +1,7 @@
+from __future__ import annotations
+
+from .cli import main
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())