#!/usr/bin/env bash # llm.sh — Execute any LLM client with xop-managed credentials, no Touch ID. # # ## The technique (read this once) # # xop's auth gate (`src/auth/mod.rs::decide`) returns `AllowKeyring` — # silent unlock via the 0600 file keyring — when stdin is NOT a TTY. # That branch is checked FIRST, before SSH detection and biometrics. # So: redirect stdin away from the terminal, and xop skips Touch ID. # # Requirements / caveats: # # 1. Keyring must already be saved (one-time setup): # xop init # writes ~/.x/xop/keyring automatically # xop key --save # only needed for vaults created # # before v0.2.1 (pre-keyring) # Without `~/.x/xop/keyring`, headless still asks for the passphrase. # # 2. SSH interactive sessions (env `SSH_TTY` / `SSH_CONNECTION` set + # pty) → xop forces the xop passphrase regardless. The headless # bypass only works locally OR via `ssh host cmd` (non-pty). # # 3. stdin is consumed by the redirect. Don't pipe the LLM prompt via # stdin — pass it via the client's argv (`-d`, `--data`, etc.). # # 4. Three vault keys travel together: `llm_key` `llm_model` `llm_url`. # They're injected as env vars in the child process. Default mapping # is generic (`LLM_API_KEY` / `LLM_MODEL` / `LLM_BASE_URL`); override # with `LLM_ENV_KEY` / `LLM_ENV_MODEL` / `LLM_ENV_URL` for specific # SDKs (e.g. `LLM_ENV_KEY=ANTHROPIC_API_KEY`). # # 5. `--secret ENV_VAR=VAULT_KEY` order matters. ENV_VAR is what the # child sees; VAULT_KEY is what `xop set` named it. We default to # `LLM_API_KEY=llm_key` (vault convention from AGENTS.md). # # ## One-time setup (Touch ID WILL appear here, that's fine) # # xop init # echo "sk-..." | xop set llm_key # echo "gpt-4o" | xop set llm_model # echo "https://api.openai.com/v1"| xop set llm_url # # ## Usage # # # Generic env mapping (LLM_API_KEY / LLM_BASE_URL / LLM_MODEL): # ./examples/llm.sh -- curl -s "$LLM_BASE_URL/models" \ # -H "Authorization: Bearer $LLM_API_KEY" # # # Anthropic SDK env mapping: # LLM_ENV_KEY=ANTHROPIC_API_KEY LLM_ENV_URL=ANTHROPIC_BASE_URL \ # ./examples/llm.sh -- python my_agent.py # # # Tighten network policy to just the LLM endpoint: # LLM_ALLOW_NET='api.openai.com:443' ./examples/llm.sh -- python my_agent.py # # # Pass xop flags (e.g. --dry-run) BEFORE `--`: # ./examples/llm.sh --dry-run -- echo "policy OK" # # ## Verify the bypass # # ./examples/llm.sh --dry-run -- echo "policy OK" # # Expected: prints the resolved policy WITHOUT prompting Touch ID. set -euo pipefail cd "$(dirname "$0")/.." # ── Preflight: friendly error if keyring missing ───────────────────────── if [ ! -f "$HOME/.x/xop/keyring" ]; then echo "✗ ~/.x/xop/keyring not found — headless bypass will fail." >&2 echo " Fix (one-time, requires Touch ID): xop init OR xop key --save" >&2 exit 1 fi # ── Locate xop binary (installed takes priority over local build) ──────── XOP_BIN="${XOP_BIN:-$(command -v xop 2>/dev/null || echo "./target/release/xop")}" # ── Split args at the first `--`: xop flags go before, child args after ─ declare -a XOP_EXTRA=() declare -a CHILD_ARGS=() seen_sep=false for arg in "$@"; do if [ "$seen_sep" = false ] && [ "$arg" = "--" ]; then seen_sep=true continue fi if [ "$seen_sep" = true ]; then CHILD_ARGS+=("$arg") else XOP_EXTRA+=("$arg") fi done # ── 1. Headless bypass ──────────────────────────────────────────────────── # Only redirect if our stdin is currently a TTY. If the user is already # piping data into us, the pipe end is already non-TTY — xop would see # AllowKeyring anyway — so we leave it alone. [ -t 0 ] && exec