astra-cli-agent 0.1.0__tar.gz

astra_cli_agent-0.1.0/.env.example

@@ -0,0 +1,28 @@
+# Copy to .env and fill in the providers you have keys for — or just run `astra setup`,
+# which walks you through picking a provider and tests the key before saving it.
+# Astra never reads these into logs or memory; they're loaded as env vars only.
+
+ANTHROPIC_API_KEY=
+OPENAI_API_KEY=
+GROQ_API_KEY=
+
+# Local Ollama server (optional last-resort fallback)
+OLLAMA_HOST=http://localhost:11434
+
+# Optional general web search (the research agent's `web_search_general` tool). Uses SerpApi
+# (https://serpapi.com) to run a real Google search. Leaving SERPAPI_KEY unset simply disables
+# `web_search_general`; the GitHub/StackOverflow/fetch tools work without it.
+SERPAPI_KEY=
+
+# Optional observability: set LANGCHAIN_TRACING_V2=true and provide a LangSmith API key to
+# get a full trace (every graph node + every LLM call, with tokens/cost/latency) exported to
+# https://smith.langchain.com for each `astra` request. LANGCHAIN_PROJECT groups traces under
+# one project name in the LangSmith UI (defaults to "default" if unset). Leaving
+# LANGCHAIN_TRACING_V2 unset/false costs nothing — Astra's own cost/token tracking
+# (`astra memory costs`) works independently of this and needs no key at all.
+LANGCHAIN_API_KEY=
+LANGCHAIN_TRACING_V2=false
+LANGCHAIN_PROJECT=astra-cli
+
+# Nested settings overrides, e.g.:
+# ASTRA_APP__LOG_LEVEL=DEBUG

astra_cli_agent-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,37 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+
+      - name: Install dependencies
+        run: uv pip install --system -e ".[dev]"
+
+      - name: Ruff
+        run: ruff check .
+
+      - name: Mypy
+        run: mypy src
+
+      - name: Pytest
+        # No GROQ_API_KEY is configured in CI, so tests/e2e/test_e2e_live_groq.py
+        # skips cleanly (see HANDOFF.md Phase 17) rather than failing or spending
+        # real money. Docker/kubernetes-backed tests skip the same way when the
+        # runner has no reachable daemon/cluster.
+        run: pytest -q

astra_cli_agent-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,49 @@
+name: Release
+
+# Fires when a GitHub Release is published (create the release from a tag,
+# e.g. v0.1.0, once CI is green on main). Uses PyPI's trusted-publishing
+# (OIDC) flow, so no API token is stored as a repo secret.
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Build sdist and wheel
+        run: |
+          python -m pip install --upgrade build
+          python -m build
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write  # required for PyPI trusted publishing
+    steps:
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

astra_cli_agent-0.1.0/.gitignore

@@ -0,0 +1,15 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+build/
+dist/
+.venv/
+venv/
+.env
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+.astra/