@geravant/sinain 1.0.18 → 1.1.0

package/sinain-agent/run.sh

@@ -0,0 +1,248 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Load .env if present (does not override existing env vars)
+if [ -f "$SCRIPT_DIR/.env" ]; then
+  set -a
+  # shellcheck source=/dev/null
+  . "$SCRIPT_DIR/.env"
+  set +a
+fi
+
+MCP_CONFIG="${MCP_CONFIG:-$SCRIPT_DIR/mcp-config.json}"
+CORE_URL="${SINAIN_CORE_URL:-http://localhost:9500}"
+POLL_INTERVAL="${SINAIN_POLL_INTERVAL:-5}"
+HEARTBEAT_INTERVAL="${SINAIN_HEARTBEAT_INTERVAL:-900}" # 15 minutes
+AGENT="${SINAIN_AGENT:-claude}"
+WORKSPACE="${SINAIN_WORKSPACE:-$HOME/.openclaw/workspace}"
+
+# --- Agent profiles ---
+
+# Returns 0 if the selected agent supports MCP tools natively.
+# Junie support is detected at startup (JUNIE_HAS_MCP flag).
+JUNIE_HAS_MCP=false  # set during startup checks
+agent_has_mcp() {
+  case "$AGENT" in
+    claude|codex|goose) return 0 ;;
+    junie) $JUNIE_HAS_MCP ;;
+    *) return 1 ;;
+  esac
+}
+
+# Invoke the selected agent with a prompt. MCP-capable agents get the config
+# so they can call sinain tools directly. Returns text on stdout.
+# Exit code 1 means "agent doesn't support MCP — use pipe mode instead".
+invoke_agent() {
+  local prompt="$1"
+  case "$AGENT" in
+    claude)
+      claude --dangerously-skip-permissions \
+        --mcp-config "$MCP_CONFIG" \
+        --max-turns 5 --output-format text \
+        -p "$prompt" 2>/dev/null
+      ;;
+    codex)
+      codex exec -s danger-full-access \
+        "$prompt" 2>/dev/null
+      ;;
+    junie)
+      if $JUNIE_HAS_MCP; then
+        junie --output-format text \
+          --mcp-location "$JUNIE_MCP_DIR" \
+          --task "$prompt" 2>/dev/null
+      else
+        return 1
+      fi
+      ;;
+    goose)
+      goose run --text "$prompt" \
+        --output-format text \
+        --max-turns 10 2>/dev/null
+      ;;
+    aider)
+      # No MCP support — signal pipe mode
+      return 1
+      ;;
+    *)
+      # Generic pipe mode — treat AGENT value as a command
+      return 1
+      ;;
+  esac
+}
+
+# --- Pipe-mode helpers (for agents without MCP) ---
+
+# JSON-encode stdin for use in curl payloads
+json_encode() {
+  python3 -c 'import sys,json; print(json.dumps(sys.stdin.read()))'
+}
+
+# Post an escalation response via HTTP (used in pipe mode)
+post_response() {
+  local esc_id="$1" response="$2"
+  curl -sf -X POST "$CORE_URL/escalation/respond" \
+    -H 'Content-Type: application/json' \
+    -d "{\"id\":\"$esc_id\",\"response\":$(echo "$response" | json_encode)}" >/dev/null
+}
+
+# Invoke a pipe-mode agent with escalation message text.
+# Some agents take the message as an argument, others via stdin.
+invoke_pipe() {
+  local msg="$1"
+  case "$AGENT" in
+    junie)
+      junie --output-format text --task "$msg" 2>/dev/null
+      ;;
+    aider)
+      aider --yes -m "$msg" 2>/dev/null
+      ;;
+    *)
+      # Generic: pipe message to stdin
+      echo "$msg" | $AGENT 2>/dev/null
+      ;;
+  esac
+}
+
+# --- Startup checks ---
+
+# Verify sinain-core is running
+if ! curl -sf "$CORE_URL/health" > /dev/null 2>&1; then
+  echo "ERROR: sinain-core is not running at $CORE_URL"
+  echo "Start it first: cd sinain-core && npm run dev"
+  exit 1
+fi
+
+# Junie: detect --mcp-location support (must run before agent_has_mcp calls)
+JUNIE_MCP_DIR="$SCRIPT_DIR/.junie-mcp"
+if [ "$AGENT" = "junie" ]; then
+  if junie --help 2>&1 | grep -q "mcp-location"; then
+    JUNIE_HAS_MCP=true
+    mkdir -p "$JUNIE_MCP_DIR"
+    cp "$MCP_CONFIG" "$JUNIE_MCP_DIR/mcp.json"
+  else
+    echo "NOTE: junie $(junie --version 2>&1 | grep -oE '[0-9.]+' | head -1) lacks --mcp-location, using pipe mode"
+    echo "  Upgrade junie for MCP support: brew upgrade junie"
+  fi
+fi
+
+# Verify MCP server dependencies (only needed for MCP agents)
+if agent_has_mcp && [ ! -d "$SCRIPT_DIR/../sinain-mcp-server/node_modules" ]; then
+  echo "Installing sinain-mcp-server dependencies..."
+  (cd "$SCRIPT_DIR/../sinain-mcp-server" && npm install)
+fi
+
+# Codex: auto-register sinain MCP server if not already configured
+if [ "$AGENT" = "codex" ]; then
+  TSX_BIN="$SCRIPT_DIR/../sinain-core/node_modules/.bin/tsx"
+  MCP_ENTRY="$SCRIPT_DIR/../sinain-mcp-server/index.ts"
+  if ! codex mcp get sinain >/dev/null 2>&1; then
+    echo "Registering sinain MCP server with codex..."
+    codex mcp add sinain \
+      --env "SINAIN_CORE_URL=$CORE_URL" \
+      --env "SINAIN_WORKSPACE=$WORKSPACE" \
+      -- "$TSX_BIN" "$MCP_ENTRY"
+  fi
+fi
+
+# Agent mode label
+if agent_has_mcp; then
+  AGENT_MODE="MCP"
+else
+  AGENT_MODE="pipe"
+fi
+
+echo "sinain bare agent started"
+echo "  Agent: $AGENT ($AGENT_MODE)"
+echo "  Core: $CORE_URL"
+echo "  Poll: every ${POLL_INTERVAL}s"
+echo "  Heartbeat: every ${HEARTBEAT_INTERVAL}s"
+echo "  Press Ctrl+C to stop"
+echo ""
+
+LAST_HEARTBEAT=$(date +%s)
+ESCALATION_COUNT=0
+
+cleanup() {
+  echo ""
+  echo "Agent stopped. Escalations handled: $ESCALATION_COUNT"
+  exit 0
+}
+trap cleanup INT TERM
+
+# --- Prompt templates ---
+
+ESC_PROMPT_TEMPLATE='You are the sinain HUD agent. An escalation is pending with ID=%s.
+
+Call sinain_get_escalation to see the full context, then call sinain_respond with the ID and your response.
+
+Response guidelines: 5-10 sentences, address errors first, reference specific screen/audio context, never NO_REPLY. Max 4000 chars for coding context, 3000 otherwise.'
+
+HEARTBEAT_PROMPT='You are the sinain HUD agent. Run the heartbeat cycle:
+1. Call sinain_heartbeat_tick with a brief session summary
+2. If the result contains a suggestion, post it to HUD via sinain_post_feed
+3. Call sinain_get_feedback to review recent scores'
+
+# --- Main loop ---
+
+while true; do
+  # Poll for pending escalation
+  ESC=$(curl -sf "$CORE_URL/escalation/pending" 2>/dev/null || echo '{"ok":false}')
+  ESC_ID=$(echo "$ESC" | python3 -c "import sys,json; d=json.load(sys.stdin); e=d.get('escalation'); print(e['id'] if e else '')" 2>/dev/null || true)
+
+  if [ -n "$ESC_ID" ]; then
+    ESC_MSG=$(echo "$ESC" | python3 -c "import sys,json; d=json.load(sys.stdin); print(d['escalation']['message'])" 2>/dev/null)
+    ESC_SCORE=$(echo "$ESC" | python3 -c "import sys,json; d=json.load(sys.stdin); print(d['escalation'].get('score','?'))" 2>/dev/null)
+    ESC_CODING=$(echo "$ESC" | python3 -c "import sys,json; d=json.load(sys.stdin); print(d['escalation'].get('codingContext',False))" 2>/dev/null)
+
+    echo "[$(date +%H:%M:%S)] Escalation $ESC_ID (score=$ESC_SCORE, coding=$ESC_CODING)"
+
+    if agent_has_mcp; then
+      # MCP path: agent calls sinain tools directly
+      PROMPT=$(printf "$ESC_PROMPT_TEMPLATE" "$ESC_ID")
+      RESPONSE=$(invoke_agent "$PROMPT" || echo "ERROR: $AGENT invocation failed")
+    else
+      # Pipe path: bash handles HTTP, agent just generates text
+      RESPONSE=$(invoke_pipe "$ESC_MSG" || true)
+      if [ -n "$RESPONSE" ]; then
+        post_response "$ESC_ID" "$RESPONSE"
+      else
+        echo "[$(date +%H:%M:%S)] WARNING: $AGENT returned empty response"
+      fi
+    fi
+
+    ESCALATION_COUNT=$((ESCALATION_COUNT + 1))
+    echo "[$(date +%H:%M:%S)] Responded ($ESCALATION_COUNT total): ${RESPONSE:0:120}..."
+    echo ""
+  fi
+
+  # Heartbeat check
+  NOW=$(date +%s)
+  ELAPSED=$((NOW - LAST_HEARTBEAT))
+  if [ "$ELAPSED" -ge "$HEARTBEAT_INTERVAL" ]; then
+    echo "[$(date +%H:%M:%S)] Running heartbeat tick..."
+
+    if agent_has_mcp; then
+      # MCP path: agent runs heartbeat tools
+      invoke_agent "$HEARTBEAT_PROMPT" || true
+    else
+      # Pipe path: run curation scripts directly
+      SCRIPTS_DIR="$WORKSPACE/sinain-memory"
+      MEMORY_DIR="$WORKSPACE/memory"
+      if [ -d "$SCRIPTS_DIR" ]; then
+        python3 "$SCRIPTS_DIR/signal_analyzer.py" --memory-dir "$MEMORY_DIR" 2>/dev/null || true
+        python3 "$SCRIPTS_DIR/playbook_curator.py" --memory-dir "$MEMORY_DIR" 2>/dev/null || true
+        echo "[$(date +%H:%M:%S)] Heartbeat: ran signal_analyzer + playbook_curator"
+      else
+        echo "[$(date +%H:%M:%S)] Heartbeat: skipped (no scripts at $SCRIPTS_DIR)"
+      fi
+    fi
+
+    LAST_HEARTBEAT=$NOW
+    echo "[$(date +%H:%M:%S)] Heartbeat complete"
+    echo ""
+  fi
+
+  sleep "$POLL_INTERVAL"
+done

package/sinain-core/.env.example

@@ -0,0 +1,93 @@
+# sinain-core configuration
+# Copy to .env and fill in your values:  cp .env.example .env
+
+# ── Server ──
+PORT=9500
+
+# ── System Audio ──
+# Default: ScreenCaptureKit (zero-setup, macOS 13+). Fallback: ffmpeg + BlackHole.
+AUDIO_CAPTURE_CMD=screencapturekit # screencapturekit | sox | ffmpeg
+AUDIO_DEVICE=BlackHole 2ch        # macOS audio device (only used by sox/ffmpeg)
+AUDIO_SAMPLE_RATE=16000
+AUDIO_CHUNK_MS=5000
+AUDIO_VAD_ENABLED=true
+AUDIO_VAD_THRESHOLD=0.003
+AUDIO_AUTO_START=true
+AUDIO_GAIN_DB=20
+# AUDIO_ALT_DEVICE=                # alternate device for switch_device command
+
+# ── Microphone (opt-in for privacy) ──
+MIC_ENABLED=false                  # set true to capture user's microphone
+MIC_DEVICE=default                 # "default" = system mic. For specific device: use exact CoreAudio name
+MIC_CAPTURE_CMD=sox                # sox or ffmpeg (mic uses sox by default)
+MIC_SAMPLE_RATE=16000
+MIC_CHUNK_MS=5000
+MIC_VAD_ENABLED=true
+MIC_VAD_THRESHOLD=0.008            # higher threshold (ambient noise)
+MIC_AUTO_START=false
+MIC_GAIN_DB=0
+
+# ── Transcription ──
+OPENROUTER_API_KEY=                # required (unless TRANSCRIPTION_BACKEND=local)
+TRANSCRIPTION_BACKEND=openrouter   # openrouter | local (local = whisper.cpp on-device)
+TRANSCRIPTION_MODEL=google/gemini-2.5-flash
+TRANSCRIPTION_LANGUAGE=en-US
+
+# ── Local Transcription (only when TRANSCRIPTION_BACKEND=local) ──
+# Install: brew install whisper-cpp
+# Models:  https://huggingface.co/ggerganov/whisper.cpp/tree/main
+# LOCAL_WHISPER_BIN=whisper-cli
+# LOCAL_WHISPER_MODEL=~/models/ggml-large-v3-turbo.bin
+# LOCAL_WHISPER_TIMEOUT_MS=15000
+
+# ── Agent ──
+AGENT_ENABLED=true
+AGENT_MODEL=google/gemini-2.5-flash-lite
+# AGENT_FALLBACK_MODELS=google/gemini-2.5-flash,anthropic/claude-3.5-haiku
+AGENT_MAX_TOKENS=300
+AGENT_TEMPERATURE=0.3
+AGENT_PUSH_TO_FEED=true
+AGENT_DEBOUNCE_MS=3000
+AGENT_MAX_INTERVAL_MS=30000
+AGENT_COOLDOWN_MS=10000
+AGENT_MAX_AGE_MS=120000            # context window lookback (2 min)
+
+# ── Escalation ──
+ESCALATION_MODE=selective          # off | selective | focus | rich
+ESCALATION_COOLDOWN_MS=30000
+# ESCALATION_TRANSPORT=auto        # ws | http | auto — use http for bare agent (no gateway)
+                                   # auto = WS when gateway connected, HTTP fallback
+                                   # http = skip gateway entirely, poll via GET /escalation/pending
+                                   # See docs/INSTALL-BARE-AGENT.md for bare agent setup
+
+# ── OpenClaw / NemoClaw Gateway ─────────────────────────────────────────────
+# Run ./setup-nemoclaw.sh to fill these in interactively (recommended).
+#
+# NemoClaw (NVIDIA Brev) quick-start:
+#   1. In Brev dashboard: Expose Port(s) → enter 18789 → TCP → note the IP
+#   2. In Code-Server terminal: npx sinain   (installs plugin, prints token)
+#   3. On Mac: ./setup-nemoclaw.sh           (interactive wizard)
+#
+# URL:   ws://YOUR-IP:18789   (use the IP shown after exposing port 18789)
+# Token: printed by `npx sinain` / visible in Brev dashboard → Gateway Token
+OPENCLAW_WS_URL=ws://localhost:18789
+OPENCLAW_WS_TOKEN=                 # 48-char hex — from gateway config or `npx sinain` output
+OPENCLAW_HTTP_URL=http://localhost:18789/hooks/agent
+OPENCLAW_HTTP_TOKEN=               # same token as WS_TOKEN
+OPENCLAW_SESSION_KEY=agent:main:sinain  # MUST be agent:main:sinain — see README § Session Key
+# OPENCLAW_PHASE1_TIMEOUT_MS=10000    # Phase 1 (delivery) timeout — circuit trips on failure
+# OPENCLAW_PHASE2_TIMEOUT_MS=120000   # Phase 2 (agent response) timeout — no circuit trip
+# OPENCLAW_QUEUE_TTL_MS=300000        # Outbound queue message TTL (5 min)
+# OPENCLAW_QUEUE_MAX_SIZE=10          # Max queued escalations (oldest dropped on overflow)
+# OPENCLAW_PING_INTERVAL_MS=30000     # WS ping keepalive interval
+
+# ── SITUATION.md ──
+SITUATION_MD_PATH=~/.openclaw/workspace/SITUATION.md
+# OPENCLAW_WORKSPACE_DIR=~/.openclaw/workspace
+
+# ── Debug ──
+# DEBUG=true                       # verbose logging (every tick, every chunk)
+
+# ── Tracing ──
+TRACE_ENABLED=true
+TRACE_DIR=~/.sinain-core/traces