instar 0.24.13 → 0.24.15

package/src/templates/hooks/slack-channel-context.sh

@@ -0,0 +1,98 @@
+#!/usr/bin/env bash
+# slack-channel-context.sh — UserPromptSubmit hook
+#
+# Detects [slack:CHANNEL_ID] prefix in user messages and injects
+# channel conversation history as JSON context.
+#
+# Reads from the ring buffer cache via instar server API —
+# zero Slack API calls per prompt.
+
+set -euo pipefail
+
+# Read user prompt from stdin (JSON format from Claude Code)
+INPUT=$(cat)
+PROMPT=$(echo "$INPUT" | python3 -c "import json,sys; print(json.load(sys.stdin).get('userMessage',''))" 2>/dev/null) || exit 0
+
+# Check for [slack:C...] prefix
+if [[ "$PROMPT" =~ \[slack:([A-Z0-9]+)\] ]]; then
+  CHANNEL_ID="${BASH_REMATCH[1]}"
+else
+  exit 0
+fi
+
+# Get port and auth from config
+PORT="${INSTAR_PORT:-}"
+AUTH=""
+
+if [ -f ".instar/config.json" ]; then
+  if [ -z "$PORT" ]; then
+    CONFIG_PORT=$(python3 -c "import json; print(json.load(open('.instar/config.json')).get('port',''))" 2>/dev/null)
+    [ -n "$CONFIG_PORT" ] && PORT="$CONFIG_PORT"
+  fi
+  AUTH=$(python3 -c "import json; print(json.load(open('.instar/config.json')).get('authToken',''))" 2>/dev/null)
+fi
+
+PORT="${PORT:-4042}"
+
+# Check server health
+if ! curl -sf "http://localhost:${PORT}/health" >/dev/null 2>&1; then
+  exit 0  # Server not running — graceful degradation
+fi
+
+# Fetch channel history from ring buffer cache
+MESSAGES=$(curl -sf \
+  ${AUTH:+-H "Authorization: Bearer $AUTH"} \
+  "http://localhost:${PORT}/slack/channels/${CHANNEL_ID}/messages?limit=30" 2>/dev/null) || exit 0
+
+# Format thread history for session context
+python3 -c "
+import json, sys
+from datetime import datetime
+
+data = json.loads('''${MESSAGES}''')
+messages = data.get('messages', [])
+
+if not messages:
+    sys.exit(0)
+
+lines = ['--- Thread History (last {} messages) ---'.format(len(messages))]
+lines.append('IMPORTANT: Read this history carefully before taking any action.')
+lines.append('Your task is to continue THIS conversation, not start something new.')
+lines.append('Topic: slack-{}'.format('${CHANNEL_ID}'))
+lines.append('')
+
+unanswered = 0
+for msg in messages:
+    ts = msg.get('ts', '')
+    try:
+        dt = datetime.fromtimestamp(float(ts))
+        time_str = dt.strftime('%H:%M:%S')
+    except:
+        time_str = ts
+
+    user = msg.get('user', 'unknown')
+    text = msg.get('text', '')
+
+    # Truncate very long messages
+    if len(text) > 2000:
+        text = text[:2000] + '...'
+
+    # Determine if from user or agent
+    sender = 'User' if msg.get('fromUser', True) else 'Agent'
+    lines.append('[{}] {}: {}'.format(time_str, sender, text))
+
+lines.append('')
+lines.append('--- End Thread History ---')
+lines.append('')
+lines.append('CRITICAL: You MUST relay your response back to Slack after responding.')
+lines.append('Use the relay script:')
+lines.append('')
+lines.append(\"cat <<'EOF' | .claude/scripts/slack-reply.sh ${CHANNEL_ID}\")
+lines.append('Your response text here')
+lines.append('EOF')
+lines.append('')
+lines.append('Strip the [slack:${CHANNEL_ID}] prefix before interpreting the message.')
+lines.append('Only relay conversational text — not tool output or internal reasoning.')
+
+print('\n'.join(lines))
+" 2>/dev/null || exit 0

package/src/templates/scripts/slack-reply.sh

@@ -0,0 +1,64 @@
+#!/usr/bin/env bash
+# slack-reply.sh — Send a message to a Slack channel via the instar server.
+#
+# Usage:
+#   slack-reply.sh CHANNEL_ID "message text"
+#   echo "message" | slack-reply.sh CHANNEL_ID
+#   cat <<'EOF' | slack-reply.sh CHANNEL_ID
+#   Multi-line message here
+#   EOF
+
+set -euo pipefail
+
+CHANNEL_ID="$1"
+shift
+
+# Read message from args or stdin
+if [ $# -gt 0 ]; then
+  MESSAGE="$*"
+else
+  MESSAGE="$(cat)"
+fi
+
+if [ -z "$MESSAGE" ]; then
+  echo "Error: no message text provided" >&2
+  exit 1
+fi
+
+# Get port from env or config
+PORT="${INSTAR_PORT:-}"
+AUTH=""
+
+if [ -f ".instar/config.json" ]; then
+  if [ -z "$PORT" ]; then
+    CONFIG_PORT=$(python3 -c "import json; print(json.load(open('.instar/config.json')).get('port',''))" 2>/dev/null)
+    [ -n "$CONFIG_PORT" ] && PORT="$CONFIG_PORT"
+  fi
+  AUTH=$(python3 -c "import json; print(json.load(open('.instar/config.json')).get('authToken',''))" 2>/dev/null)
+fi
+
+PORT="${PORT:-4042}"
+
+# JSON-escape the message
+ESCAPED=$(python3 -c "import json,sys; print(json.dumps(sys.stdin.read()))" <<< "$MESSAGE" 2>/dev/null)
+# Fallback to basic bash escaping if python unavailable
+if [ -z "$ESCAPED" ]; then
+  ESCAPED="\"$(echo "$MESSAGE" | sed 's/\\/\\\\/g; s/"/\\"/g')\""
+fi
+
+# Send via Instar server
+RESPONSE=$(curl -s -w "\n%{http_code}" -X POST \
+  "http://localhost:${PORT}/slack/reply/${CHANNEL_ID}" \
+  -H "Content-Type: application/json" \
+  ${AUTH:+-H "Authorization: Bearer $AUTH"} \
+  -d "{\"text\": ${ESCAPED}}")
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -1)
+BODY=$(echo "$RESPONSE" | sed '$d')
+
+if [ "$HTTP_CODE" = "200" ]; then
+  echo "Sent ${#MESSAGE} chars to channel ${CHANNEL_ID}"
+else
+  echo "Failed (HTTP ${HTTP_CODE}): ${BODY}" >&2
+  exit 1
+fi

package/upgrades/0.24.15.md

@@ -0,0 +1,49 @@
+# Upgrade Guide — vNEXT
+
+<!-- bump: minor -->
+
+## What Changed
+
+### Slack Messaging Adapter
+
+Instar now includes a full Slack messaging adapter (`SlackAdapter`), enabling agents to send and receive messages via Slack workspaces. The adapter supports:
+
+- Sending messages to channels and threads
+- Token validation and secure credential handling
+- Atomic write operations for message persistence
+- CLI tooling for Slack interaction (`slack-cli`)
+- Server-side routes for Slack webhook integration
+
+The adapter follows the same pattern as existing messaging adapters (Telegram, WhatsApp) and plugs into the unified channel routing system.
+
+### Server-Side Process Review Dashboard
+
+A new Systems tab on the dashboard provides real-time visibility into server processes. This includes:
+
+- Process telemetry collection and display
+- Health status monitoring for running services
+- Integration with the existing dashboard infrastructure
+
+### Architecture Documentation
+
+A new "Under the Hood" page on the documentation site explains Instar's internal architecture, giving developers and agents a clearer picture of how the system is structured.
+
+### CI Stability Improvements
+
+Several CI fixes improve reliability: resolved flaky test exclusions, fixed WhatsApp string test, added `skipStallClear` option to prevent stall-clear interference during topic sends, and fixed test failures blocking the push gate.
+
+## What to Tell Your User
+
+- **Slack support is here**: Your agent can now send and receive messages through Slack. If your team uses Slack, you can connect it as a messaging channel alongside Telegram and other platforms. Ask your agent to set it up for you.
+
+- **Better visibility into what is running**: There is a new Systems tab on your dashboard that shows what server processes are active and their health status. Useful for troubleshooting if something feels off.
+
+- **More reliable updates**: Several under-the-hood fixes make the CI pipeline more stable, which means smoother and more frequent releases going forward.
+
+## Summary of New Capabilities
+
+| Capability | How to Use |
+|-----------|-----------|
+| Slack messaging | Configure Slack token via CLI, then messages route automatically |
+| Process review dashboard | Visit the Systems tab on your Instar dashboard |
+| Architecture docs | Check the "Under the Hood" page on the docs site |