@adaptic/maestro 1.0.0

package/scripts/huddle/node_modules/ws/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "ws",
+  "version": "8.20.0",
+  "description": "Simple to use, blazing fast and thoroughly tested websocket client and server for Node.js",
+  "keywords": [
+    "HyBi",
+    "Push",
+    "RFC-6455",
+    "WebSocket",
+    "WebSockets",
+    "real-time"
+  ],
+  "homepage": "https://github.com/websockets/ws",
+  "bugs": "https://github.com/websockets/ws/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/websockets/ws.git"
+  },
+  "author": "Einar Otto Stangvik <einaros@gmail.com> (http://2x.io)",
+  "license": "MIT",
+  "main": "index.js",
+  "exports": {
+    ".": {
+      "browser": "./browser.js",
+      "import": "./wrapper.mjs",
+      "require": "./index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "browser": "browser.js",
+  "engines": {
+    "node": ">=10.0.0"
+  },
+  "files": [
+    "browser.js",
+    "index.js",
+    "lib/*.js",
+    "wrapper.mjs"
+  ],
+  "scripts": {
+    "test": "nyc --reporter=lcov --reporter=text mocha --throw-deprecation test/*.test.js",
+    "integration": "mocha --throw-deprecation test/*.integration.js",
+    "lint": "eslint . && prettier --check --ignore-path .gitignore \"**/*.{json,md,yaml,yml}\""
+  },
+  "peerDependencies": {
+    "bufferutil": "^4.0.1",
+    "utf-8-validate": ">=5.0.2"
+  },
+  "peerDependenciesMeta": {
+    "bufferutil": {
+      "optional": true
+    },
+    "utf-8-validate": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "benchmark": "^2.1.4",
+    "bufferutil": "^4.0.1",
+    "eslint": "^10.0.1",
+    "eslint-config-prettier": "^10.0.1",
+    "eslint-plugin-prettier": "^5.0.0",
+    "globals": "^17.0.0",
+    "mocha": "^8.4.0",
+    "nyc": "^15.0.0",
+    "prettier": "^3.0.0",
+    "utf-8-validate": "^6.0.0"
+  }
+}

package/scripts/huddle/node_modules/ws/wrapper.mjs

@@ -0,0 +1,21 @@
+import createWebSocketStream from './lib/stream.js';
+import extension from './lib/extension.js';
+import PerMessageDeflate from './lib/permessage-deflate.js';
+import Receiver from './lib/receiver.js';
+import Sender from './lib/sender.js';
+import subprotocol from './lib/subprotocol.js';
+import WebSocket from './lib/websocket.js';
+import WebSocketServer from './lib/websocket-server.js';
+
+export {
+  createWebSocketStream,
+  extension,
+  PerMessageDeflate,
+  Receiver,
+  Sender,
+  subprotocol,
+  WebSocket,
+  WebSocketServer
+};
+
+export default WebSocket;

package/scripts/huddle/package-lock.json

@@ -0,0 +1,62 @@
+{
+  "name": "sophie-huddle",
+  "version": "1.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "sophie-huddle",
+      "version": "1.0.0",
+      "dependencies": {
+        "@anthropic-ai/sdk": "^0.52.0",
+        "dotenv": "^16.5.0",
+        "ws": "^8.18.0"
+      },
+      "engines": {
+        "node": ">=20.0.0"
+      }
+    },
+    "node_modules/@anthropic-ai/sdk": {
+      "version": "0.52.0",
+      "resolved": "https://registry.npmjs.org/@anthropic-ai/sdk/-/sdk-0.52.0.tgz",
+      "integrity": "sha512-d4c+fg+xy9e46c8+YnrrgIQR45CZlAi7PwdzIfDXDM6ACxEZli1/fxhURsq30ZpMZy6LvSkr41jGq5aF5TD7rQ==",
+      "license": "MIT",
+      "bin": {
+        "anthropic-ai-sdk": "bin/cli"
+      }
+    },
+    "node_modules/dotenv": {
+      "version": "16.6.1",
+      "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-16.6.1.tgz",
+      "integrity": "sha512-uBq4egWHTcTt33a72vpSG0z3HnPuIl6NqYcTrKEg2azoEyl2hpW0zqlxysq2pK9HlDIHyHyakeYaYnSAwd8bow==",
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://dotenvx.com"
+      }
+    },
+    "node_modules/ws": {
+      "version": "8.20.0",
+      "resolved": "https://registry.npmjs.org/ws/-/ws-8.20.0.tgz",
+      "integrity": "sha512-sAt8BhgNbzCtgGbt2OxmpuryO63ZoDk/sqaB/znQm94T4fCEsy/yV+7CdC1kJhOU9lboAEU7R3kquuycDoibVA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=10.0.0"
+      },
+      "peerDependencies": {
+        "bufferutil": "^4.0.1",
+        "utf-8-validate": ">=5.0.2"
+      },
+      "peerDependenciesMeta": {
+        "bufferutil": {
+          "optional": true
+        },
+        "utf-8-validate": {
+          "optional": true
+        }
+      }
+    }
+  }
+}

package/scripts/huddle/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "sophie-huddle",
+  "version": "1.0.0",
+  "description": "Sophie Nguyen — Slack Huddle Voice Participation",
+  "main": "huddle-server.mjs",
+  "type": "module",
+  "scripts": {
+    "start": "node huddle-server.mjs",
+    "setup": "./setup-audio.sh",
+    "launch-slack": "./launch-slack.sh",
+    "join": "node huddle-server.mjs --join",
+    "call": "node huddle-server.mjs --call"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.52.0",
+    "dotenv": "^16.5.0",
+    "ws": "^8.18.0"
+  }
+}

package/scripts/huddle/setup-audio.sh

@@ -0,0 +1,239 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# ---------------------------------------------------------------------------
+# Sophie Huddle — Audio Setup
+#
+# Installs and configures BlackHole virtual audio devices for Slack huddle
+# participation. Two separate virtual devices prevent feedback loops:
+#
+#   BlackHole 2ch  → Slack's Speaker output (captures what others say)
+#   BlackHole 16ch → Slack's Mic input    (carries Sophie's synthesized voice)
+#
+# Usage:
+#   ./setup-audio.sh           # Full install + verify
+#   ./setup-audio.sh --check   # Verify existing setup only
+# ---------------------------------------------------------------------------
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+LOG_FILE="${SCRIPT_DIR}/../../logs/huddle/setup-audio.log"
+
+mkdir -p "$(dirname "$LOG_FILE")"
+
+log() { echo "[$(date '+%H:%M:%S')] $*" | tee -a "$LOG_FILE"; }
+err() { echo "[$(date '+%H:%M:%S')] ERROR: $*" | tee -a "$LOG_FILE" >&2; }
+ok()  { echo "[$(date '+%H:%M:%S')] ✓ $*" | tee -a "$LOG_FILE"; }
+
+# ---------------------------------------------------------------------------
+# Pre-flight checks
+# ---------------------------------------------------------------------------
+
+check_homebrew() {
+  if ! command -v brew &>/dev/null; then
+    err "Homebrew not installed. Install from https://brew.sh"
+    exit 1
+  fi
+  ok "Homebrew available"
+}
+
+check_switchaudio() {
+  if ! command -v SwitchAudioSource &>/dev/null; then
+    log "Installing switchaudio-osx..."
+    brew install switchaudio-osx
+  fi
+  ok "SwitchAudioSource available"
+}
+
+check_sox() {
+  if ! command -v sox &>/dev/null; then
+    log "Installing sox (audio capture/playback)..."
+    brew install sox
+  fi
+  ok "sox available"
+}
+
+# ---------------------------------------------------------------------------
+# BlackHole installation
+# ---------------------------------------------------------------------------
+
+install_blackhole_2ch() {
+  if SwitchAudioSource -a 2>/dev/null | grep -q "BlackHole 2ch"; then
+    ok "BlackHole 2ch already installed"
+    return 0
+  fi
+
+  log "Installing BlackHole 2ch (huddle output capture)..."
+  brew install blackhole-2ch
+
+  # Verify installation
+  sleep 2
+  if SwitchAudioSource -a 2>/dev/null | grep -q "BlackHole 2ch"; then
+    ok "BlackHole 2ch installed successfully"
+  else
+    err "BlackHole 2ch installation failed — may need restart"
+    return 1
+  fi
+}
+
+install_blackhole_16ch() {
+  if SwitchAudioSource -a 2>/dev/null | grep -q "BlackHole 16ch"; then
+    ok "BlackHole 16ch already installed"
+    return 0
+  fi
+
+  log "Installing BlackHole 16ch (Sophie mic input)..."
+  brew install blackhole-16ch
+
+  sleep 2
+  if SwitchAudioSource -a 2>/dev/null | grep -q "BlackHole 16ch"; then
+    ok "BlackHole 16ch installed successfully"
+  else
+    err "BlackHole 16ch installation failed — may need restart"
+    return 1
+  fi
+}
+
+# ---------------------------------------------------------------------------
+# Verification
+# ---------------------------------------------------------------------------
+
+verify_audio_devices() {
+  log ""
+  log "=== Audio Device Verification ==="
+  log ""
+
+  local all_devices
+  all_devices=$(SwitchAudioSource -a 2>/dev/null)
+
+  log "All audio devices:"
+  echo "$all_devices" | while read -r line; do
+    log "  $line"
+  done
+
+  local pass=true
+
+  if echo "$all_devices" | grep -q "BlackHole 2ch"; then
+    ok "BlackHole 2ch present (Slack speaker → capture)"
+  else
+    err "BlackHole 2ch NOT found"
+    pass=false
+  fi
+
+  if echo "$all_devices" | grep -q "BlackHole 16ch"; then
+    ok "BlackHole 16ch present (TTS → Slack mic)"
+  else
+    err "BlackHole 16ch NOT found"
+    pass=false
+  fi
+
+  if command -v sox &>/dev/null; then
+    ok "sox available for audio capture/playback"
+  else
+    err "sox NOT found"
+    pass=false
+  fi
+
+  log ""
+
+  if [ "$pass" = true ]; then
+    ok "Audio setup verified — all devices present"
+    log ""
+    log "=== Slack Configuration Required ==="
+    log ""
+    log "Open Slack → Preferences → Audio & Video:"
+    log "  Speaker:    BlackHole 2ch"
+    log "  Microphone: BlackHole 16ch"
+    log ""
+    log "This routes huddle audio through Sophie's capture pipeline."
+    log "System audio remains on built-in devices (no disruption)."
+    return 0
+  else
+    err "Audio setup incomplete — see errors above"
+    return 1
+  fi
+}
+
+# ---------------------------------------------------------------------------
+# Audio routing test
+# ---------------------------------------------------------------------------
+
+test_audio_capture() {
+  log ""
+  log "=== Audio Capture Test ==="
+  log ""
+  log "Recording 3 seconds from BlackHole 2ch..."
+
+  local test_file="/tmp/sophie-audio-test-$(date +%s).wav"
+
+  # Record 3 seconds from BlackHole 2ch
+  if sox -t coreaudio "BlackHole 2ch" -r 16000 -c 1 -b 16 "$test_file" trim 0 3 2>/dev/null; then
+    local file_size
+    file_size=$(stat -f%z "$test_file" 2>/dev/null || echo "0")
+    ok "Captured ${file_size} bytes to ${test_file}"
+
+    if [ "$file_size" -gt 1000 ]; then
+      ok "Audio capture working (got data)"
+    else
+      log "Captured silence (expected if nothing is playing through BlackHole 2ch)"
+    fi
+
+    rm -f "$test_file"
+  else
+    err "Audio capture failed — BlackHole 2ch may not be accessible"
+    return 1
+  fi
+}
+
+test_audio_playback() {
+  log ""
+  log "=== Audio Playback Test ==="
+  log ""
+  log "Generating 1-second test tone on BlackHole 16ch..."
+
+  # Generate a 440Hz sine wave and play to BlackHole 16ch
+  if sox -n -t coreaudio "BlackHole 16ch" synth 1 sine 440 2>/dev/null; then
+    ok "Playback to BlackHole 16ch succeeded"
+    log "If Slack mic is set to BlackHole 16ch, this tone would be heard in a huddle"
+  else
+    err "Playback to BlackHole 16ch failed"
+    return 1
+  fi
+}
+
+# ---------------------------------------------------------------------------
+# Main
+# ---------------------------------------------------------------------------
+
+main() {
+  log ""
+  log "=========================================="
+  log "  Sophie Huddle — Audio Setup"
+  log "  $(date)"
+  log "=========================================="
+  log ""
+
+  if [ "${1:-}" = "--check" ]; then
+    check_switchaudio
+    verify_audio_devices
+    exit $?
+  fi
+
+  if [ "${1:-}" = "--test" ]; then
+    test_audio_capture
+    test_audio_playback
+    exit $?
+  fi
+
+  # Full installation
+  check_homebrew
+  check_switchaudio
+  check_sox
+  install_blackhole_2ch
+  install_blackhole_16ch
+  verify_audio_devices
+
+  log ""
+  log "Run './setup-audio.sh --test' after configuring Slack audio to verify the pipeline."
+}
+
+main "$@"