subconscious-cli 0.2.0 → 0.3.0

package/bin/runbook/claude-code/run.sh

@@ -0,0 +1,164 @@
+#!/usr/bin/env bash
+# Point the `claude` CLI at the Subconscious gateway — ephemerally.
+#
+# Uses env vars only (ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN) so nothing is
+# written to ~/.claude/ config files.
+#
+# Usage:
+#   ./run.sh                         # uses GATEWAY_URL/API_KEY from ../.env
+#   ./run.sh --continue               # pass args through to claude
+#   ./run.sh --compact-window 1000000 -- --continue
+#   ./run.sh --model subconscious/glm-5.2 -p "hi"
+#
+# Config: copy ../env.example to ../.env and edit. .env is gitignored.
+# All agents share one coding-agents/.env file.
+#
+# Or source it to just export the env:
+#   source run.sh
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Load shared env from coding-agents/.env (gitignored) or env.example.
+SHARED_ENV="${MBTA_ENV_FILE:-${SCRIPT_DIR}/../.env}"
+[[ -f "$SHARED_ENV" ]] || SHARED_ENV="${SCRIPT_DIR}/../env.example"
+if [[ -f "$SHARED_ENV" ]]; then set -a; source "$SHARED_ENV"; set +a; fi
+
+DEFAULT_MODEL="subconscious/glm-5.2"
+DEFAULT_COMPACT_WINDOW="1000000"
+DEFAULT_MAX_CONTEXT_TOKENS="3000000"
+DEFAULT_MAX_CONCURRENT_SUBAGENTS="4"
+DEFAULT_MAX_SUBAGENT_SPAWN_DEPTH="1"
+DEFAULT_OPUS_MODEL="subconscious/glm-5.2"
+DEFAULT_SONNET_MODEL="subconscious/tim-qwen3.6-27b"
+DEFAULT_HAIKU_MODEL="subconscious/deepseek-v4-flash-marathon"
+
+GATEWAY_URL="${GATEWAY_URL:-}"
+API_KEY="${CLAUDE_CODE_API_KEY:-${API_KEY:-}}"
+MODEL="${MODEL:-$DEFAULT_MODEL}"
+COMPACT_WINDOW="${CLAUDE_CODE_AUTO_COMPACT_WINDOW:-${COMPACT_WINDOW:-$DEFAULT_COMPACT_WINDOW}}"
+MAX_CONTEXT_TOKENS="${CLAUDE_CODE_MAX_CONTEXT_TOKENS:-${MAX_CONTEXT_TOKENS:-$DEFAULT_MAX_CONTEXT_TOKENS}}"
+MAX_CONCURRENT_SUBAGENTS="${MAX_CONCURRENT_SUBAGENTS:-$DEFAULT_MAX_CONCURRENT_SUBAGENTS}"
+MAX_SUBAGENT_SPAWN_DEPTH="${MAX_SUBAGENT_SPAWN_DEPTH:-$DEFAULT_MAX_SUBAGENT_SPAWN_DEPTH}"
+OPUS_MODEL="${ANTHROPIC_DEFAULT_OPUS_MODEL:-$DEFAULT_OPUS_MODEL}"
+OPUS_MODEL_NAME="${ANTHROPIC_DEFAULT_OPUS_MODEL_NAME:-$OPUS_MODEL}"
+OPUS_MODEL_DESCRIPTION="${ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION:-Subconscious default model}"
+SONNET_MODEL="${ANTHROPIC_DEFAULT_SONNET_MODEL:-$DEFAULT_SONNET_MODEL}"
+SONNET_MODEL_NAME="${ANTHROPIC_DEFAULT_SONNET_MODEL_NAME:-$SONNET_MODEL}"
+SONNET_MODEL_DESCRIPTION="${ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION:-Subconscious TIM Qwen 3.6 27B}"
+HAIKU_MODEL="${ANTHROPIC_DEFAULT_HAIKU_MODEL:-$DEFAULT_HAIKU_MODEL}"
+HAIKU_MODEL_NAME="${ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME:-$HAIKU_MODEL}"
+HAIKU_MODEL_DESCRIPTION="${ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION:-Subconscious DeepSeek V4 Flash Marathon}"
+
+usage() {
+  cat <<'EOF'
+Usage:
+  run.sh [options] [-- CLAUDE_ARGS...]
+  run.sh [options] CLAUDE_ARGS...
+
+Options (same as install.sh; override coding-agents/.env for this run):
+  --gateway-url URL      Gateway origin (e.g. https://gateway.example)
+  --api-key KEY          Gateway API key (sk-gw-...)
+  --model MODEL          Model name (default: subconscious/glm-5.2)
+  --compact-window N     CLAUDE_CODE_AUTO_COMPACT_WINDOW (default: 1000000; Claude Code clamps to 100000–1000000)
+                         See https://code.claude.com/docs/en/env-vars and
+                         https://code.claude.com/docs/en/context-window#set-the-auto-compact-window
+  --max-context-tokens N CLAUDE_CODE_MAX_CONTEXT_TOKENS (default: 3000000)
+                         See https://code.claude.com/docs/en/env-vars
+  -h, --help             Show this help
+
+Anything after --, or unrecognized flags/args, is passed through to `claude`.
+EOF
+}
+
+# Parse args (only when executed, not sourced)
+PASSTHRU=()
+if [[ "${BASH_SOURCE[0]:-$0}" == "${0}" ]]; then
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --gateway-url)
+        GATEWAY_URL="${2:-}"
+        shift 2
+        ;;
+      --api-key)
+        API_KEY="${2:-}"
+        shift 2
+        ;;
+      --model)
+        MODEL="${2:-}"
+        shift 2
+        ;;
+      --compact-window)
+        COMPACT_WINDOW="${2:-}"
+        shift 2
+        ;;
+      --max-context-tokens)
+        MAX_CONTEXT_TOKENS="${2:-}"
+        shift 2
+        ;;
+      -h|--help)
+        usage
+        exit 0
+        ;;
+      --)
+        shift
+        PASSTHRU+=("$@")
+        break
+        ;;
+      *)
+        PASSTHRU+=("$1")
+        shift
+        ;;
+    esac
+  done
+fi
+
+if [[ -z "$GATEWAY_URL" || -z "$API_KEY" ]]; then
+  echo "error: GATEWAY_URL and API_KEY must be set in ../.env (or pass --gateway-url / --api-key)" >&2
+  exit 1
+fi
+
+# Optional CLAUDE_GATEWAY_URL in shared .env overrides GATEWAY_URL for Claude only
+# (CLI --gateway-url already updated GATEWAY_URL above).
+EFFECTIVE_GATEWAY_URL="${CLAUDE_GATEWAY_URL:-$GATEWAY_URL}"
+
+export ANTHROPIC_BASE_URL="$EFFECTIVE_GATEWAY_URL"
+export ANTHROPIC_AUTH_TOKEN="$API_KEY"
+export ANTHROPIC_MODEL="$MODEL"
+export ANTHROPIC_SMALL_FAST_MODEL="$MODEL"
+export ANTHROPIC_DEFAULT_OPUS_MODEL="$OPUS_MODEL"
+export ANTHROPIC_DEFAULT_OPUS_MODEL_NAME="$OPUS_MODEL_NAME"
+export ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION="$OPUS_MODEL_DESCRIPTION"
+export ANTHROPIC_DEFAULT_SONNET_MODEL="$SONNET_MODEL"
+export ANTHROPIC_DEFAULT_SONNET_MODEL_NAME="$SONNET_MODEL_NAME"
+export ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION="$SONNET_MODEL_DESCRIPTION"
+export ANTHROPIC_DEFAULT_HAIKU_MODEL="$HAIKU_MODEL"
+export ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME="$HAIKU_MODEL_NAME"
+export ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION="$HAIKU_MODEL_DESCRIPTION"
+export CLAUDE_CODE_SUBAGENT_MODEL="$MODEL"
+export CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS="${MAX_CONCURRENT_SUBAGENTS}"
+export CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH="${MAX_SUBAGENT_SPAWN_DEPTH}"
+export CLAUDE_CODE_AUTO_COMPACT_WINDOW="${COMPACT_WINDOW}"
+export CLAUDE_CODE_MAX_CONTEXT_TOKENS="${MAX_CONTEXT_TOKENS}"
+# Claude Code purpose attribution only: api_request logs → gateway POST /v1/logs
+# (not a general logs API). Docs:
+# https://code.claude.com/docs/en/monitoring-usage#api-request-event
+# Requires Claude Code >= 2.1.152.
+export CLAUDE_CODE_ENABLE_TELEMETRY=1
+export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
+export OTEL_LOGS_EXPORTER=otlp
+export OTEL_EXPORTER_OTLP_PROTOCOL=http/json
+export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT="${EFFECTIVE_GATEWAY_URL%/}/v1/logs"
+export OTEL_EXPORTER_OTLP_HEADERS="x-api-key=${API_KEY}"
+export OTEL_EXPORTER_OTLP_TIMEOUT=2000
+export OTEL_LOGS_EXPORT_INTERVAL="${OTEL_LOGS_EXPORT_INTERVAL:-2000}"
+# Do not set OTEL_TRACES_EXPORTER / OTEL_METRICS_EXPORTER (including to "none") -
+# Claude's telemetry init can abort the whole pipeline on unknown exporter types.
+# If sourced, export env and return (caller can unset when done).
+if [[ "${BASH_SOURCE[0]:-$0}" != "${0}" ]]; then
+  return 0 2>/dev/null || true
+fi
+
+# If executed, launch claude with any passed-through args.
+exec claude ${PASSTHRU[@]+"${PASSTHRU[@]}"}

package/bin/runbook/codex/hook.sh

@@ -0,0 +1,112 @@
+#!/usr/bin/env bash
+# Fail-open Codex hook: report PreCompact / PostCompact to the gateway.
+# Never blocks compaction (do not return continue: false).
+#
+# Docs: https://developers.openai.com/codex/hooks
+#
+#   PreCompact  -> conversation_compaction { phase: start }
+#   PostCompact -> conversation_compaction { phase: end }
+#
+# Custom (non-OpenAI-named) providers compact locally through the configured
+# Responses endpoint, so the summarization request hits the gateway between
+# these two signals. conversation_id is the hook session_id, which Codex
+# examples show as thr_… — the same value the gateway uses as thread-id
+# grouping. Capture after upgrades if that ever diverges.
+#
+# Stdin: Codex hook JSON. Stdout: empty success (or {} ). Exit 0 always.
+
+set -u
+
+CONFIG="${SUBCONSCIOUS_HOOKS_ENV:-${HOME}/.codex/subconscious-hooks.env}"
+if [[ -f "$CONFIG" ]]; then
+  # shellcheck disable=SC1090
+  source "$CONFIG"
+fi
+# install.sh also writes subconscious.env with the API key for the CLI.
+if [[ -f "${HOME}/.codex/subconscious.env" ]]; then
+  # shellcheck disable=SC1090
+  source "${HOME}/.codex/subconscious.env"
+fi
+
+GATEWAY_URL="${SUBCONSCIOUS_GATEWAY_URL:-}"
+API_KEY="${SUBCONSCIOUS_API_KEY:-}"
+
+fail_open() {
+  exit 0
+}
+
+if [[ -z "$GATEWAY_URL" || -z "$API_KEY" ]]; then
+  echo "subconscious codex hook: missing SUBCONSCIOUS_GATEWAY_URL or SUBCONSCIOUS_API_KEY" >&2
+  fail_open
+fi
+
+for tool in jq curl; do
+  if ! command -v "$tool" >/dev/null 2>&1; then
+    echo "subconscious codex hook: ${tool} is required" >&2
+    fail_open
+  fi
+done
+
+INPUT="$(cat || true)"
+if [[ -z "$INPUT" ]]; then
+  fail_open
+fi
+
+# Local fire-log for capture/debug (never blocks).
+FIRE_LOG_DIR="${SUBCONSCIOUS_CODEX_HOOK_LOG_DIR:-${HOME}/.codex/subconscious-hook-logs}"
+mkdir -p "$FIRE_LOG_DIR" 2>/dev/null || true
+
+HOOK_EVENT="$(printf '%s' "$INPUT" | jq -r '.hook_event_name // empty' 2>/dev/null || true)"
+case "$HOOK_EVENT" in
+  PreCompact) PHASE="start" ;;
+  PostCompact) PHASE="end" ;;
+  *) fail_open ;;
+esac
+
+SESSION_ID="$(printf '%s' "$INPUT" | jq -r '.session_id // empty' 2>/dev/null || true)"
+if [[ -z "$SESSION_ID" ]]; then
+  fail_open
+fi
+
+{
+  printf '%s event=%s session_id=%s payload=' "$(date -u +%Y-%m-%dT%H:%M:%SZ)" "$HOOK_EVENT" "$SESSION_ID"
+  printf '%s\n' "$INPUT"
+} >>"${FIRE_LOG_DIR}/${SESSION_ID}.log" 2>/dev/null || true
+
+TURN_ID="$(printf '%s' "$INPUT" | jq -r '.turn_id // empty' 2>/dev/null || true)"
+TRIGGER="$(printf '%s' "$INPUT" | jq -r '.trigger // empty' 2>/dev/null || true)"
+NOW_MS="$(date +%s)-$$-$RANDOM"
+if [[ -n "$TURN_ID" ]]; then
+  DEDUPE_KEY="${SESSION_ID}:${PHASE}:${TURN_ID}"
+else
+  DEDUPE_KEY="${SESSION_ID}:${PHASE}:${NOW_MS}"
+fi
+
+PAYLOAD="$(jq -n \
+  --arg conversation_id "$SESSION_ID" \
+  --arg phase "$PHASE" \
+  --arg hook_event_name "$HOOK_EVENT" \
+  --arg dedupe_key "$DEDUPE_KEY" \
+  --arg trigger "$TRIGGER" \
+  --arg turn_id "$TURN_ID" \
+  '{
+    event: "conversation_compaction",
+    conversation_id: $conversation_id,
+    phase: $phase,
+    hook_event_name: $hook_event_name,
+    dedupe_key: $dedupe_key,
+    metadata: {
+      trigger: (if $trigger == "" then null else $trigger end),
+      turn_id: (if $turn_id == "" then null else $turn_id end)
+    } | with_entries(select(.value != null))
+  }'
+)"
+
+curl -sS -m 2 \
+  -H "Authorization: Bearer ${API_KEY}" \
+  -H "Content-Type: application/json" \
+  -H "x-subconscious-client: codex" \
+  -d "$PAYLOAD" \
+  "${GATEWAY_URL%/}/v1/agent-hooks" >/dev/null 2>&1 || true
+
+fail_open

package/bin/runbook/codex/hooks.json

@@ -0,0 +1,29 @@
+{
+  "description": "Report Codex auto/manual compaction to the Subconscious API Gateway.",
+  "hooks": {
+    "PreCompact": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "HOOK_SH_PATH",
+            "timeout": 3,
+            "statusMessage": "Reporting compaction start"
+          }
+        ]
+      }
+    ],
+    "PostCompact": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "HOOK_SH_PATH",
+            "timeout": 3,
+            "statusMessage": "Reporting compaction end"
+          }
+        ]
+      }
+    ]
+  }
+}