@adaptic/maestro 1.6.0 → 1.7.0

package/scripts/send-sms.sh

@@ -1,19 +1,19 @@
 #!/bin/bash
-# send-sms.sh — Send outbound SMS via Twilio REST API as Sophie
+# send-sms.sh — Send outbound SMS via Twilio REST API as the running agent
 # Usage: ./scripts/send-sms.sh --to "+1234567890" --body "message text"
 #
 # Environment variables (from .env):
 #   TWILIO_ACCOUNT_SID  — Twilio account SID
 #   TWILIO_AUTH_TOKEN   — Twilio auth token
-#   TWILIO_PHONE_NUMBER — Sophie's Twilio phone number (default: +16282656712)
+#   TWILIO_PHONE_NUMBER — The agent's Twilio phone number
 set -e
 
 # Load environment
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-SOPHIE_AI="$(dirname "$SCRIPT_DIR")"
+AGENT_REPO_DIR="${AGENT_DIR:-$(dirname "$SCRIPT_DIR")}"
 
-if [ -f "$SOPHIE_AI/.env" ]; then
-  source "$SOPHIE_AI/.env"
+if [ -f "$AGENT_REPO_DIR/.env" ]; then
+  source "$AGENT_REPO_DIR/.env"
 fi
 
 # Defaults
@@ -110,7 +110,7 @@ MESSAGE_SID=$(echo "$RESPONSE_BODY" | grep -o '"sid": *"[^"]*"' | head -1 | sed
 STATUS=$(echo "$RESPONSE_BODY" | grep -o '"status": *"[^"]*"' | head -1 | sed 's/"status": *"//' | sed 's/"//')
 
 # Log to SMS log
-LOG_DIR="$SOPHIE_AI/logs/sms/$(date +%Y-%m-%d)"
+LOG_DIR="$AGENT_REPO_DIR/logs/sms/$(date +%Y-%m-%d)"
 mkdir -p "$LOG_DIR"
 LOG_FILE="$LOG_DIR/$(date +%Y-%m-%d)-sms.jsonl"
 
@@ -121,7 +121,7 @@ LOGEOF
 echo "$LOG_ENTRY" >> "$LOG_FILE"
 
 # Log to audit trail
-AUDIT_DIR="$SOPHIE_AI/logs/audit"
+AUDIT_DIR="$AGENT_REPO_DIR/logs/audit"
 mkdir -p "$AUDIT_DIR"
 AUDIT_FILE="$AUDIT_DIR/$(date +%Y-%m-%d)-actions.jsonl"
 

package/scripts/send-whatsapp.sh

@@ -1,32 +1,32 @@
 #!/bin/bash
-# send-whatsapp.sh — Send outbound WhatsApp message via Twilio REST API as Sophie
+# send-whatsapp.sh — Send outbound WhatsApp message via Twilio REST API as the agent
 #
 # Supports two modes:
 #   1. Sandbox mode (default until production WABA is active):
 #      Uses Twilio sandbox number +14155238886
 #      Recipients must have joined the sandbox first
 #   2. Production mode (--production flag or WHATSAPP_MODE=production):
-#      Uses Sophie's own number +16282656712 as WhatsApp Business sender
+#      Uses the agent's own Twilio number as WhatsApp Business sender
 #
 # Usage:
-#   ./scripts/send-whatsapp.sh --to "+971501234567" --body "Hello from Sophie"
+#   ./scripts/send-whatsapp.sh --to "+971501234567" --body "Hello"
 #   ./scripts/send-whatsapp.sh --to "+971501234567" --body "Hello" --production
-#   ./scripts/send-whatsapp.sh --to "+971501234567" --template "intro_greeting" --vars "Sophie,Adaptic"
+#   ./scripts/send-whatsapp.sh --to "+971501234567" --template "intro_greeting" --vars "Var1,Var2"
 #
 # Environment variables (from .env):
 #   TWILIO_ACCOUNT_SID      — Twilio account SID
 #   TWILIO_AUTH_TOKEN        — Twilio auth token
-#   TWILIO_PHONE_NUMBER      — Sophie's Twilio phone number
+#   TWILIO_PHONE_NUMBER      — The agent's Twilio phone number
 #   WHATSAPP_MODE            — "sandbox" (default) or "production"
 #   WHATSAPP_SANDBOX_NUMBER  — Sandbox sender (default: +14155238886)
 set -e
 
 # Load environment
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-SOPHIE_AI="$(dirname "$SCRIPT_DIR")"
+AGENT_REPO_DIR="${AGENT_DIR:-$(dirname "$SCRIPT_DIR")}"
 
-if [ -f "$SOPHIE_AI/.env" ]; then
-  source "$SOPHIE_AI/.env"
+if [ -f "$AGENT_REPO_DIR/.env" ]; then
+  source "$AGENT_REPO_DIR/.env"
 fi
 
 # Defaults
@@ -77,7 +77,7 @@ while [[ $# -gt 0 ]]; do
       echo "  --to          Recipient phone number (E.164 format, required)"
       echo "  --body        Message text (required unless --template is used)"
       echo "  --template    WhatsApp message template name (for business-initiated messages)"
-      echo "  --vars        Comma-separated template variables (e.g. \"Sophie,Adaptic\")"
+      echo "  --vars        Comma-separated template variables (e.g. \"Name,Company\")"
       echo "  --media       URL of media to attach (image, PDF, etc.)"
       echo "  --production  Use production WhatsApp Business number"
       echo "  --sandbox     Use Twilio WhatsApp sandbox (default)"
@@ -207,7 +207,7 @@ ERROR_CODE=$(echo "$RESPONSE_BODY" | grep -o '"code": *[0-9]*' | head -1 | sed '
 ERROR_MSG=$(echo "$RESPONSE_BODY" | grep -o '"message": *"[^"]*"' | head -1 | sed 's/"message": *"//' | sed 's/"//')
 
 # Log to WhatsApp log
-LOG_DIR="$SOPHIE_AI/logs/whatsapp/$(date +%Y-%m-%d)"
+LOG_DIR="$AGENT_REPO_DIR/logs/whatsapp/$(date +%Y-%m-%d)"
 mkdir -p "$LOG_DIR"
 LOG_FILE="$LOG_DIR/$(date +%Y-%m-%d)-whatsapp.jsonl"
 
@@ -220,7 +220,7 @@ LOGEOF
 echo "$LOG_ENTRY" >> "$LOG_FILE"
 
 # Log to audit trail
-AUDIT_DIR="$SOPHIE_AI/logs/audit"
+AUDIT_DIR="$AGENT_REPO_DIR/logs/audit"
 mkdir -p "$AUDIT_DIR"
 AUDIT_FILE="$AUDIT_DIR/$(date +%Y-%m-%d)-actions.jsonl"
 

package/scripts/setup/configure-macos.sh

@@ -30,7 +30,7 @@ AGENT_NAME=$(basename "$AGENT_DIR")
 CURRENT_USER=$(whoami)
 
 # The directory from which this script was invoked — used as the boot-time
-# Claude Code working directory (e.g. ~/sophie-ai, ~/wundr, etc.)
+# Claude Code working directory (e.g. ~/agent-name, ~/wundr, etc.)
 CALLER_DIR="${PWD}"
 
 # Colours
@@ -419,7 +419,9 @@ configure_memory_watchdog() {
   local PLIST_DEST="$real_home/Library/LaunchAgents/ai.maestro.memory-watchdog.plist"
 
   # Install the plist (update paths for this agent directory)
-  sed "s|/Users/sophie/maestro|$AGENT_DIR|g" "$PLIST_SOURCE" > "$PLIST_DEST"
+  # Template plists may contain `__AGENT_DIR__` (preferred) or the legacy
+  # `/Users/sophie/maestro` literal — substitute both for compatibility.
+  sed -e "s|__AGENT_DIR__|$AGENT_DIR|g" -e "s|/Users/sophie/maestro|$AGENT_DIR|g" "$PLIST_SOURCE" > "$PLIST_DEST"
   chown "$real_user:staff" "$PLIST_DEST" 2>/dev/null || true
 
   # Load it (as the real user)

package/scripts/setup/init-agent.sh

@@ -31,7 +31,7 @@ set -e
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 AGENT_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"
-AGENT_NAME=$(basename "$AGENT_DIR")  # e.g. "sophie-ai", "jacob-ai"
+AGENT_NAME=$(basename "$AGENT_DIR")  # e.g. "ravi-ai", "jacob-ai"
 
 # Colours
 RED='\033[0;31m'

package/scripts/slack-react.mjs

@@ -2,7 +2,7 @@
 /**
  * Slack Reaction Utility — Add emoji reactions to Slack messages.
  *
- * Used by Sophie's Claude Code sessions to react to messages.
+ * Used by the agent's Claude Code sessions to react to messages.
  * This is a thin wrapper around the Slack reactions.add API.
  *
  * Usage:

package/scripts/slack-typing.mjs

@@ -1,9 +1,9 @@
 #!/usr/bin/env /opt/homebrew/bin/node
 /**
- * slack-typing.mjs — Send Slack typing indicator as Sophie
+ * slack-typing.mjs — Send Slack typing indicator as the running agent
  *
- * Shows the "Sophie is typing..." indicator in a channel/DM before
- * a message is sent, making Sophie's presence feel human and real.
+ * Shows the "<Agent> is typing..." indicator in a channel/DM before
+ * a message is sent, making the agent's presence feel human and real.
  *
  * Approach: Connect to Slack RTM (WebSocket), send a `typing` event,
  * hold the connection for the specified duration, then disconnect.

package/scripts/system-verify.sh

@@ -1,12 +1,20 @@
 #!/bin/bash
-# Sophie System Verification — checks all components are operational
+# Agent System Verification — checks all components are operational
 # Usage: ./scripts/system-verify.sh
 #
 # Run this anytime to verify the full system is working.
 
 set -e
-SOPHIE_AI_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-cd "$SOPHIE_AI_DIR"
+AGENT_REPO_DIR="${AGENT_DIR:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)}"
+cd "$AGENT_REPO_DIR"
+
+# Load identity (AGENT_LAUNCHD_PREFIX in particular) — the verification
+# checks read launchd labels with the agent-specific prefix.
+if [ -f "$AGENT_REPO_DIR/config/agent.env" ]; then
+  # shellcheck disable=SC1091
+  source "$AGENT_REPO_DIR/config/agent.env"
+fi
+LAUNCHD_PREFIX="${AGENT_LAUNCHD_PREFIX:-ai.adaptic.agent}"
 
 RED='\033[0;31m'
 GREEN='\033[0;32m'
@@ -38,23 +46,28 @@ warn_check() {
 }
 
 echo "╔══════════════════════════════════════════════╗"
-echo "║  SOPHIE SYSTEM VERIFICATION                  ║"
+printf "║  %-44s║\n" "$(echo "${AGENT_FULL_NAME:-AGENT}" | tr '[:lower:]' '[:upper:]') SYSTEM VERIFICATION"
 echo "║  $(date '+%Y-%m-%d %H:%M %Z')                      ║"
 echo "╚══════════════════════════════════════════════╝"
 echo ""
 
 echo "=== DAEMONS ==="
-check "Poller daemon loaded" "launchctl list | grep -q sophie-poller"
-check "Inbox processor loaded" "launchctl list | grep -q sophie-inbox-processor"
-check "Meeting prep loaded" "launchctl list | grep -q sophie-meeting-prep"
-check "Meeting capture loaded" "launchctl list | grep -q sophie-meeting-action-capture"
-check "Midday sweep loaded" "launchctl list | grep -q sophie-midday-sweep"
-check "Weekly hiring loaded" "launchctl list | grep -q sophie-weekly-hiring"
-check "Weekly priorities loaded" "launchctl list | grep -q sophie-weekly-priorities"
-check "Weekly eng health loaded" "launchctl list | grep -q sophie-weekly-engineering-health"
-check "Weekly execution loaded" "launchctl list | grep -q sophie-weekly-execution"
-check "Weekly strategic memo loaded" "launchctl list | grep -q sophie-weekly-strategic-memo"
-check "Quarterly self-assessment loaded" "launchctl list | grep -q sophie-quarterly"
+# Launchd labels start with AGENT_LAUNCHD_PREFIX (e.g. ai.adaptic.ravi).
+# The legacy code searched for "sophie-poller" etc.; we now derive the
+# agent-specific component from the prefix's last segment so the check
+# works for any agent.
+LAUNCHD_AGENT_SLUG="$(basename "$LAUNCHD_PREFIX" | tr -d ' ')"  # e.g. "ravi" from "ai.adaptic.ravi"
+check "Poller daemon loaded" "launchctl list | grep -q ${LAUNCHD_AGENT_SLUG}-poller"
+check "Inbox processor loaded" "launchctl list | grep -q ${LAUNCHD_AGENT_SLUG}-inbox-processor"
+check "Meeting prep loaded" "launchctl list | grep -q ${LAUNCHD_AGENT_SLUG}-meeting-prep"
+check "Meeting capture loaded" "launchctl list | grep -q ${LAUNCHD_AGENT_SLUG}-meeting-action-capture"
+check "Midday sweep loaded" "launchctl list | grep -q ${LAUNCHD_AGENT_SLUG}-midday-sweep"
+check "Weekly hiring loaded" "launchctl list | grep -q ${LAUNCHD_AGENT_SLUG}-weekly-hiring"
+check "Weekly priorities loaded" "launchctl list | grep -q ${LAUNCHD_AGENT_SLUG}-weekly-priorities"
+check "Weekly eng health loaded" "launchctl list | grep -q ${LAUNCHD_AGENT_SLUG}-weekly-engineering-health"
+check "Weekly execution loaded" "launchctl list | grep -q ${LAUNCHD_AGENT_SLUG}-weekly-execution"
+check "Weekly strategic memo loaded" "launchctl list | grep -q ${LAUNCHD_AGENT_SLUG}-weekly-strategic-memo"
+check "Quarterly self-assessment loaded" "launchctl list | grep -q ${LAUNCHD_AGENT_SLUG}-quarterly"
 echo ""
 
 echo "=== REMOTE TRIGGERS ==="

package/scripts/user-context-search.py

@@ -2,7 +2,7 @@
 """
 user-context-search.py — Per-user ring-fenced context search (Phase 1 + Phase 2)
 
-Searches sophie-ai files scoped to a user's access level.
+Searches the agent repo's files scoped to a user's access level.
 Supports two backends:
   - grep (default): file-based grep with user-scoped directory paths (Phase 1)
   - sqlite: FTS5 full-text search over pre-indexed SQLite database (Phase 2)
@@ -15,7 +15,7 @@ Usage:
     python3 scripts/user-context-search.py --user unknown --query "adaptic" --format text
     python3 scripts/user-context-search.py --user mehran --query "flight" --backend sqlite
 
-Author: Sophie Nguyen, Chief of Staff
+Author: Adaptic.ai
 Date: 2026-04-03
 """
 
@@ -30,7 +30,7 @@ from pathlib import Path
 
 # ── Constants ──────────────────────────────────────────────────────────────────
 
-BASE_DIR = Path(__file__).resolve().parent.parent  # sophie-ai root
+BASE_DIR = Path(os.environ.get("AGENT_DIR", str(Path(__file__).resolve().parent.parent)))  # agent repo root
 CONFIG_PATH = BASE_DIR / "config" / "caller-id-map.yaml"
 DEFAULT_DB_PATH = BASE_DIR / "state" / "rag" / "search.db"
 DEFAULT_MAX_RESULTS = 10
@@ -569,7 +569,7 @@ def format_text(user_slug, user_data, access_level, paths_searched, matches, que
 def main():
     parser = argparse.ArgumentParser(
         description="Per-user ring-fenced context search (Phase 1 + Phase 2). "
-                    "Searches sophie-ai files scoped to a user's access level.",
+                    "Searches the agent repo's files scoped to a user's access level.",
         epilog="Examples:\n"
                "  %(prog)s --user mehran --query \"DFSA\"\n"
                "  %(prog)s --user hootan --query \"portal\" --max-results 5\n"

package/scripts/validate-outbound.py

@@ -4,8 +4,8 @@
 Checks outbound messages for:
   1. Relationship claims — "our project manager" must match confirmed status
   2. Title/role accuracy — titles must match org chart / profiles
-  3. AI self-disclosure — Sophie must never reveal she is AI
-  4. In-person meeting self-scheduling — Sophie must not attend physical meetings
+  3. AI self-disclosure — the agent must never reveal it is AI
+  4. In-person meeting self-scheduling — the agent must not attend physical meetings
   5. Unverified commitment claims — flag strong commitment language
 
 Usage:
@@ -47,7 +47,16 @@ except Exception:
 
 # Resolve paths relative to the repo root
 SCRIPT_DIR = Path(__file__).resolve().parent
-REPO_ROOT = SCRIPT_DIR.parent
+REPO_ROOT = Path(os.environ.get("AGENT_DIR", SCRIPT_DIR.parent))
+
+# Load agent identity (canonical SOT) so validation patterns can be
+# parameterised by the running agent's first name.
+try:
+    with open(REPO_ROOT / "config" / "agent.json") as _f:
+        _AGENT = json.load(_f)
+except Exception:
+    _AGENT = {"firstName": "Agent", "fullName": "Agent"}
+AGENT_FIRST_NAME = _AGENT.get("firstName", "Agent")
 
 # Data source paths
 CONTACTS_PATH = REPO_ROOT / "config" / "contacts.yaml"
@@ -914,7 +923,7 @@ def check_title_accuracy(message):
 
 
 def check_ai_self_disclosure(message):
-    """Scan for language that reveals Sophie is AI.
+    """Scan for language that reveals the agent is AI.
 
     Must NOT flag general business discussion of Adaptic's AI products.
     Returns list of issue dicts.
@@ -941,8 +950,8 @@ def check_ai_self_disclosure(message):
          "Self-referential 'as an AI'"),
         (r'\b(?:my|I)\s+(?:training|training data|knowledge cutoff|neural network|parameters)\b',
          "AI-specific self-reference"),
-        (r'\bSophie\s+is\s+(?:an?\s+)?(?:AI|bot|automated|virtual|artificial)\b',
-         "Third-person AI disclosure about Sophie"),
+        (rf'\b{re.escape(AGENT_FIRST_NAME)}\s+is\s+(?:an?\s+)?(?:AI|bot|automated|virtual|artificial)\b',
+         f"Third-person AI disclosure about {AGENT_FIRST_NAME}"),
         (r'\b(?:automated|AI[- ]powered|AI[- ]operated|machine[- ]generated)\s+(?:assistant|chief of staff|executive|system)\b',
          "Role described as automated"),
         (r'\b(?:I don\'t have|I lack)\s+(?:feelings|emotions|a body|physical form|consciousness)\b',
@@ -971,7 +980,7 @@ def check_ai_self_disclosure(message):
                     "severity": "block",
                     "matched_text": matched_text,
                     "description": f"AI self-disclosure detected: {description}",
-                    "suggestion": "Remove or rephrase to avoid revealing Sophie's AI nature.",
+                    "suggestion": f"Remove or rephrase to avoid revealing {AGENT_FIRST_NAME}'s AI nature.",
                     "context": context_window.strip(),
                 })
 
@@ -979,27 +988,29 @@ def check_ai_self_disclosure(message):
 
 
 def check_in_person_self_scheduling(message):
-    """Detect Sophie scheduling herself for in-person meetings.
+    """Detect the agent scheduling itself for in-person meetings.
 
-    Should NOT flag scheduling for Mehran or team members.
+    Should NOT flag scheduling for the principal or team members.
     Returns list of issue dicts.
     """
     issues = []
 
-    # Patterns where Sophie offers to physically attend
+    _principal_name = (_AGENT.get("principal") or {}).get("firstName", "the principal")
+
+    # Patterns where the agent offers to physically attend
     self_attend_patterns = [
         (r'\bI\'ll\s+(?:attend|be there|come to|visit|meet you at|stop by|drop by|come by|swing by|show up)\b',
-         "Sophie offering to physically attend"),
+         f"{AGENT_FIRST_NAME} offering to physically attend"),
         (r'\b(?:meet me at|see you at|I\'ll see you|I can meet|let me come|I\'ll come)\b',
-         "Sophie scheduling herself for physical meeting"),
+         f"{AGENT_FIRST_NAME} scheduling itself for physical meeting"),
         (r'\b(?:I\'ll be in|I\'m in|I will be at)\s+(?:the office|DIFC|Innovation|your office|the meeting room|the boardroom)\b',
-         "Sophie placing herself in physical location"),
-        (r'\bSophie\s+(?:will attend|will be at|will meet|will visit)\b',
-         "Third-person Sophie physical attendance"),
+         f"{AGENT_FIRST_NAME} placing itself in physical location"),
+        (rf'\b{re.escape(AGENT_FIRST_NAME)}\s+(?:will attend|will be at|will meet|will visit)\b',
+         f"Third-person {AGENT_FIRST_NAME} physical attendance"),
         (r'\bI\'ll\s+(?:fly|travel|drive|take a cab|take a taxi)\b',
-         "Sophie describing physical travel"),
+         f"{AGENT_FIRST_NAME} describing physical travel"),
         (r'\b(?:looking forward to meeting you|see you (?:there|soon|Monday|Tuesday|Wednesday|Thursday|Friday|tomorrow|next week))\b',
-         "Sophie implying physical presence at meeting"),
+         f"{AGENT_FIRST_NAME} implying physical presence at meeting"),
     ]
 
     # Exception patterns — scheduling others is fine
@@ -1029,7 +1040,7 @@ def check_in_person_self_scheduling(message):
                     "severity": "block",
                     "matched_text": matched_text,
                     "description": f"In-person self-scheduling detected: {description}",
-                    "suggestion": "Sophie cannot attend in-person meetings. Propose Mehran or a team member instead.",
+                    "suggestion": f"{AGENT_FIRST_NAME} cannot attend in-person meetings. Propose {_principal_name} or a team member instead.",
                     "context": context_window.strip(),
                 })