@adaptic/maestro 1.6.0 → 1.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adaptic/maestro",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "Maestro — Autonomous AI agent operating system. Deploy AI employees on dedicated Mac minis.",
   "type": "module",
   "bin": {

package/scripts/continuous-monitor.sh

@@ -8,18 +8,23 @@
 set -e
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-SOPHIE_AI_DIR="$(dirname "$SCRIPT_DIR")"
+AGENT_REPO_DIR="${AGENT_DIR:-$(dirname "$SCRIPT_DIR")}"
+# Load agent identity for the LLM prompt
+if [ -f "$AGENT_REPO_DIR/config/agent.env" ]; then
+  # shellcheck disable=SC1091
+  source "$AGENT_REPO_DIR/config/agent.env"
+fi
 CHANNEL="${1:---channel all}"
 CHANNEL="${CHANNEL#--channel }"
-LOG_DIR="$SOPHIE_AI_DIR/logs/monitor"
-QUEUE_DIR="$SOPHIE_AI_DIR/outputs/inbound/queue"
+LOG_DIR="$AGENT_REPO_DIR/logs/monitor"
+QUEUE_DIR="$AGENT_REPO_DIR/outputs/inbound/queue"
 TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
 
 mkdir -p "$LOG_DIR" "$QUEUE_DIR"
 
 # Check emergency stop
 check_stop() {
-    if [ -f "$SOPHIE_AI_DIR/.emergency-stop" ]; then
+    if [ -f "$AGENT_REPO_DIR/.emergency-stop" ]; then
         echo "[$TIMESTAMP] Monitor halted: emergency stop active" >> "$LOG_DIR/monitor.log"
         exit 0
     fi
@@ -40,14 +45,14 @@ monitor_channel() {
 
         # Use Claude to observe the channel via desktop control
         # This invokes the appropriate operator agent in observe mode
-        claude -p "You are the $channel monitoring agent for Sophie Nguyen at Adaptic.ai.
+        claude -p "You are the $channel monitoring agent for ${AGENT_FULL_NAME:-the agent} at ${COMPANY_NAME:-the company}.
 OBSERVE ONLY — do not send any messages.
 Check for new messages since the last check.
 If there are new messages, write a YAML summary to: $QUEUE_DIR/${channel}-$(date +%s).yaml
 Include: sender, timestamp, channel/thread, subject/preview, urgency_hint.
 If no new messages, do nothing.
 Check the desktop $channel app using screenshot observation.
-Working directory: $SOPHIE_AI_DIR" \
+Working directory: $AGENT_REPO_DIR" \
         --output-format text \
         >> "$log_file" 2>&1 || true
 

package/scripts/daemon/context-compiler.mjs

@@ -14,8 +14,8 @@
 import { readFileSync, readdirSync } from "fs";
 import { join } from "path";
 
-const SOPHIE_AI_DIR = process.env.__TEST_SOPHIE_DIR || join(new URL(".", import.meta.url).pathname, "../..");
-const SESSION_DIR = process.env.__TEST_SESSION_DIR || join(SOPHIE_AI_DIR, "state", "sessions");
+const AGENT_REPO_DIR = process.env.__TEST_AGENT_DIR || process.env.AGENT_DIR || join(new URL(".", import.meta.url).pathname, "../..");
+const SESSION_DIR = process.env.__TEST_SESSION_DIR || join(AGENT_REPO_DIR, "state", "sessions");
 const CHARS_PER_TOKEN = 4;
 
 // ── Token budgets by priority ──────────────────────────────────────
@@ -60,7 +60,7 @@ function extractChannelId(item) {
 function loadUserProfile(senderSlug, budgetTokens) {
   if (!senderSlug) return null;
   try {
-    const filePath = join(SOPHIE_AI_DIR, "memory", "profiles", "users", `${senderSlug}.yaml`);
+    const filePath = join(AGENT_REPO_DIR, "memory", "profiles", "users", `${senderSlug}.yaml`);
     let raw = readFileSync(filePath, "utf-8");
     const charBudget = budgetTokens * CHARS_PER_TOKEN;
     if (raw.length > charBudget) {
@@ -80,7 +80,7 @@ function loadUserProfile(senderSlug, budgetTokens) {
  */
 function loadDomainDescriptions() {
   try {
-    const filePath = join(SOPHIE_AI_DIR, "policies", "information-barriers.yaml");
+    const filePath = join(AGENT_REPO_DIR, "policies", "information-barriers.yaml");
     const raw = readFileSync(filePath, "utf-8");
     const map = new Map();
     const regex = /^\s{2}([\w-]+):\s*\n\s+description:\s*"(.+?)"/gm;
@@ -164,7 +164,7 @@ function loadDisclosureBoundaries(senderSlug, budgetTokens) {
 
   if (senderSlug) {
     try {
-      const filePath = join(SOPHIE_AI_DIR, "memory", "profiles", "users", `${senderSlug}.yaml`);
+      const filePath = join(AGENT_REPO_DIR, "memory", "profiles", "users", `${senderSlug}.yaml`);
       const raw = readFileSync(filePath, "utf-8");
 
       // Extract privilege_level via regex
@@ -226,10 +226,10 @@ function loadDisclosureBoundaries(senderSlug, budgetTokens) {
  */
 function loadConversationHistory(senderSlug, channelId, budgetTokens, forbiddenDomains) {
   const candidateDirs = [];
-  if (channelId) candidateDirs.push(join(SOPHIE_AI_DIR, "memory", "interactions", "slack", channelId));
+  if (channelId) candidateDirs.push(join(AGENT_REPO_DIR, "memory", "interactions", "slack", channelId));
   if (senderSlug) {
-    candidateDirs.push(join(SOPHIE_AI_DIR, "memory", "interactions", "slack", `dm-${senderSlug}`));
-    candidateDirs.push(join(SOPHIE_AI_DIR, "memory", "interactions", "slack", senderSlug));
+    candidateDirs.push(join(AGENT_REPO_DIR, "memory", "interactions", "slack", `dm-${senderSlug}`));
+    candidateDirs.push(join(AGENT_REPO_DIR, "memory", "interactions", "slack", senderSlug));
   }
 
   const entries = [];

package/scripts/daemon/health.mjs

@@ -5,7 +5,7 @@ import { writeFileSync, mkdirSync } from "fs";
 import { join } from "path";
 import { getStatus } from "./dispatcher.mjs";
 
-const SOPHIE_AI_DIR = join(new URL(".", import.meta.url).pathname, "../..");
+const AGENT_REPO_DIR = process.env.AGENT_DIR || join(new URL(".", import.meta.url).pathname, "../..");
 
 let stats = {
   daemon_start: new Date().toISOString(),
@@ -51,7 +51,7 @@ export function writeHealthDashboard() {
     dispatcher,
   };
 
-  const dir = join(SOPHIE_AI_DIR, "state", "dashboards");
+  const dir = join(AGENT_REPO_DIR, "state", "dashboards");
   mkdirSync(dir, { recursive: true });
   const path = join(dir, "daemon-health.yaml");
 

package/scripts/daemon/maestro-daemon.mjs

@@ -10,15 +10,16 @@
 // Install: launchd plist with KeepAlive: true
 // =============================================================================
 
-// The core daemon is in sophie-daemon.mjs for backward compatibility.
+// The core daemon implementation lives in sophie-daemon.mjs (filename
+// preserved for launchd-plist compatibility; the content is fully
+// agent-neutral and reads identity from config/agent.json).
 // It uses AGENT_DIR (resolved from this file's location) as the base path.
-// The init-maestro wizard renames sophie references in that file.
 
 import { resolve, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
-const AGENT_DIR = resolve(__dirname, "../..");
+const AGENT_DIR = process.env.AGENT_DIR || resolve(__dirname, "../..");
 
 // Set AGENT_DIR as env var so all modules can use it
 process.env.AGENT_DIR = AGENT_DIR;

package/scripts/email_thread_dedup.py

@@ -34,9 +34,10 @@ import sys
 import time
 from datetime import datetime, timezone
 
-SOPHIE_AI = "/Users/sophie/sophie-ai"
-LOCK_DIR = os.path.join(SOPHIE_AI, "state", "locks", "outbound", "email-threads")
-AUDIT_DIR = os.path.join(SOPHIE_AI, "logs", "audit")
+from pathlib import Path
+AGENT_REPO_DIR = os.environ.get("AGENT_DIR", str(Path(__file__).resolve().parent.parent))
+LOCK_DIR = os.path.join(AGENT_REPO_DIR, "state", "locks", "outbound", "email-threads")
+AUDIT_DIR = os.path.join(AGENT_REPO_DIR, "logs", "audit")
 TTL_SECONDS = 24 * 60 * 60  # 24 hours
 
 

package/scripts/huddle/huddle-server.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * Sophie Huddle — Main Server
+ * Agent Huddle — Main Server
  *
  * Orchestrates Slack huddle voice participation by coordinating:
  *   - HuddleController (CDP-based Slack UI automation)
@@ -24,7 +24,7 @@ import dotenv from "dotenv";
 import { fileURLToPath as _fu } from "node:url";
 import { dirname as _dn, join as _jn } from "node:path";
 
-// Load .env from sophie-ai root (where all API keys live), then huddle-specific .env
+// Load .env from agent repo root (where all API keys live), then huddle-specific .env
 const _d = _dn(_fu(import.meta.url));
 dotenv.config({ path: _jn(_d, "../..", ".env") });
 dotenv.config({ path: _jn(_d, ".env"), override: true });
@@ -42,8 +42,21 @@ import { HuddleController } from "./huddle-controller.mjs";
 import { AudioBridge } from "./audio-bridge.mjs";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
-const SOPHIE_ROOT = join(__dirname, "../..");
-const VOICE_AI_ROOT = join(process.env.HOME || "/Users/sophie", "voice-ai");
+const AGENT_REPO_DIR = process.env.AGENT_DIR || join(__dirname, "../..");
+const VOICE_AI_ROOT = process.env.VOICE_AI_ROOT || join(process.env.HOME || "", "voice-ai");
+
+// Load agent identity for transcript speaker tags + display names.
+let _agent = null;
+function loadAgent() {
+  if (_agent) return _agent;
+  try {
+    _agent = JSON.parse(readFileSync(join(AGENT_REPO_DIR, "config/agent.json"), "utf-8"));
+  } catch {
+    _agent = { firstName: "Agent" };
+  }
+  return _agent;
+}
+const AGENT_SLUG = (loadAgent().firstName || "agent").toLowerCase();
 
 // ---------------------------------------------------------------------------
 // Configuration
@@ -90,7 +103,7 @@ const HuddleState = {
 };
 
 /**
- * HuddleServer is the top-level orchestrator for Sophie's huddle participation.
+ * HuddleServer is the top-level orchestrator for the agent's huddle participation.
  */
 class HuddleServer extends EventEmitter {
   constructor() {
@@ -114,7 +127,7 @@ class HuddleServer extends EventEmitter {
 
   async start() {
     console.log("\n==========================================");
-    console.log("  Sophie Huddle Server");
+    console.log(`  ${loadAgent().firstName || "Agent"} Huddle Server`);
     console.log("  " + new Date().toISOString());
     console.log("==========================================\n");
 
@@ -265,7 +278,7 @@ class HuddleServer extends EventEmitter {
       lastThreadTs: null,          // Last seen thread message timestamp
     };
 
-    // Load live context from sophie-ai for Claude
+    // Load live context from the agent repo for Claude
     this.session.liveContext = this._loadLiveContext();
 
     // In webaudio capture mode, set Slack's speaker to physical output
@@ -289,7 +302,7 @@ class HuddleServer extends EventEmitter {
     await this.bridge.speak(greeting);
     if (this.session) {
       this.session.messages.push({ role: "assistant", content: greeting });
-      this.session.transcript.push({ speaker: "sophie", text: greeting, ts: Date.now() });
+      this.session.transcript.push({ speaker: AGENT_SLUG, text: greeting, ts: Date.now() });
     }
 
     // Start polling the huddle thread for text messages
@@ -329,7 +342,7 @@ class HuddleServer extends EventEmitter {
   // -------------------------------------------------------------------------
 
   /**
-   * Process a transcript from the huddle and generate Sophie's response.
+   * Process a transcript from the huddle and generate the agent's response.
    * @param {string} userText - What someone said in the huddle
    */
   async _handleTranscript(userText) {
@@ -356,7 +369,7 @@ class HuddleServer extends EventEmitter {
 
       // Add to history
       this.session.messages.push({ role: "assistant", content: cleanResponse });
-      this.session.transcript.push({ speaker: "sophie", text: cleanResponse, ts: Date.now() });
+      this.session.transcript.push({ speaker: AGENT_SLUG, text: cleanResponse, ts: Date.now() });
 
       // Speak the response via TTS → BlackHole 16ch → Slack mic
       await this.bridge.speak(cleanResponse);
@@ -380,7 +393,7 @@ class HuddleServer extends EventEmitter {
   /**
    * Start polling the huddle thread for text messages via the Slack API.
    * Text messages in the huddle thread are injected into the conversation
-   * so Sophie can respond to both voice and text.
+   * so the agent can respond to both voice and text.
    */
   _startThreadPolling() {
     const slackToken = process.env.SLACK_USER_TOKEN || process.env.SLACK_BOT_TOKEN;
@@ -431,7 +444,7 @@ class HuddleServer extends EventEmitter {
 
   /**
    * Poll the Slack channel for recent messages in the huddle thread.
-   * Only processes text messages from other users (not Sophie's bot).
+   * Only processes text messages from other users (not the agent's bot).
    */
   async _pollThreadMessages(channelId, token) {
     if (!this.session) return;
@@ -445,12 +458,14 @@ class HuddleServer extends EventEmitter {
     const data = await resp.json();
     if (!data.ok || !data.messages || data.messages.length === 0) return;
 
-    // Sophie's user ID (skip her own messages)
-    const sophieUserId = process.env.SLACK_BOT_USER_ID || "U099N1JFPRQ";
+    // The agent's Slack user ID (skip its own messages). Hardcoded fallback
+    // removed — agents must set SLACK_BOT_USER_ID in .env if they want this
+    // filter active, otherwise the agent's slackMemberId from agent.json is used.
+    const agentUserId = process.env.SLACK_BOT_USER_ID || loadAgent().slackMemberId || "";
 
     for (const msg of data.messages.reverse()) { // oldest first
-      // Skip bot messages, Sophie's messages, and non-text messages
-      if (msg.user === sophieUserId) continue;
+      // Skip bot messages, the agent's own messages, and non-text messages
+      if (agentUserId && msg.user === agentUserId) continue;
       if (msg.subtype) continue; // Skip system messages
       if (!msg.text || !msg.text.trim()) continue;
 
@@ -495,7 +510,7 @@ class HuddleServer extends EventEmitter {
     // Build a single prompt from system + conversation history
     const parts = [`[System]\n${systemPrompt}\n`];
     for (const msg of messages) {
-      const role = msg.role === "assistant" ? "Sophie" : "Participant";
+      const role = msg.role === "assistant" ? (loadAgent().firstName || "Agent") : "Participant";
       const content = typeof msg.content === "string"
         ? msg.content
         : msg.content?.map((b) => b.text || "").join("") || "";
@@ -503,7 +518,7 @@ class HuddleServer extends EventEmitter {
         parts.push(`[${role}]\n${content}`);
       }
     }
-    parts.push("[Sophie]");
+    parts.push(`[${loadAgent().firstName || "Agent"}]`);
 
     const prompt = parts.join("\n\n");
 
@@ -568,7 +583,7 @@ class HuddleServer extends EventEmitter {
         if (filler) {
           await this.bridge.speak(filler);
           if (this.session) {
-            this.session.transcript.push({ speaker: "sophie", text: filler, ts: Date.now() });
+            this.session.transcript.push({ speaker: AGENT_SLUG, text: filler, ts: Date.now() });
           }
         }
       }
@@ -616,7 +631,7 @@ class HuddleServer extends EventEmitter {
   // -------------------------------------------------------------------------
 
   /**
-   * Resolve a huddle participant's identity from sophie-ai contacts/profiles.
+   * Resolve a huddle participant's identity from the agent repo contacts/profiles.
    * Used for access control (CEO gets write tools) and personalized greetings.
    */
   _resolveHuddleParticipant(identifier) {
@@ -636,7 +651,7 @@ class HuddleServer extends EventEmitter {
 
     // Try loading from contacts.yaml
     try {
-      const contactsPath = join(SOPHIE_ROOT, "config/contacts.yaml");
+      const contactsPath = join(AGENT_REPO_DIR, "config/contacts.yaml");
       const contacts = readFileSync(contactsPath, "utf8");
       // Simple search — look for the identifier in the contacts file
       if (contacts.toLowerCase().includes(key)) {
@@ -695,7 +710,7 @@ class HuddleServer extends EventEmitter {
     console.log(`[EVENTS] Huddle event: ${user_name || user} → ${huddle_state} in ${channel || "unknown"}`);
     this._logEvent("events-api-huddle", event);
 
-    // Someone started a huddle and Sophie isn't in one yet
+    // Someone started a huddle and the agent isn't in one yet
     if (huddle_state === "in_a_huddle" && this.state === HuddleState.IDLE && this.autoJoin) {
       // Determine the channel to join
       const targetChannel = channel || user_name;
@@ -719,7 +734,7 @@ class HuddleServer extends EventEmitter {
   }
 
   // -------------------------------------------------------------------------
-  // Live context loader (reads from sophie-ai state files)
+  // Live context loader (reads from the agent repo state files)
   // -------------------------------------------------------------------------
 
   _loadLiveContext() {
@@ -727,13 +742,13 @@ class HuddleServer extends EventEmitter {
 
     // Load priorities
     try {
-      const priorities = readFileSync(join(SOPHIE_ROOT, "config/priorities.yaml"), "utf8");
+      const priorities = readFileSync(join(AGENT_REPO_DIR, "config/priorities.yaml"), "utf8");
       contextParts.push(`PRIORITIES:\n${priorities.slice(0, 2000)}`);
     } catch { /* optional */ }
 
     // Load executive summary
     try {
-      const summary = readFileSync(join(SOPHIE_ROOT, "state/dashboards/executive-summary.yaml"), "utf8");
+      const summary = readFileSync(join(AGENT_REPO_DIR, "state/dashboards/executive-summary.yaml"), "utf8");
       contextParts.push(`EXECUTIVE SUMMARY:\n${summary.slice(0, 3000)}`);
     } catch { /* optional */ }
 
@@ -835,7 +850,7 @@ class HuddleServer extends EventEmitter {
   // -------------------------------------------------------------------------
 
   /**
-   * Toggle Sophie's Slack mic mute via CDP on the huddle window.
+   * Toggle the agent's Slack mic mute via CDP on the huddle window.
    * Keeps mic muted between TTS outputs to prevent echo from the
    * virtual audio loopback.
    * @param {boolean} muted - true to mute, false to unmute
@@ -946,7 +961,7 @@ class HuddleServer extends EventEmitter {
   // -------------------------------------------------------------------------
 
   _logEvent(event, data = {}) {
-    const logDir = join(SOPHIE_ROOT, "logs/huddle");
+    const logDir = join(AGENT_REPO_DIR, "logs/huddle");
     mkdirSync(logDir, { recursive: true });
 
     const date = new Date().toISOString().split("T")[0];
@@ -964,7 +979,7 @@ class HuddleServer extends EventEmitter {
   _saveTranscript() {
     if (!this.session || this.session.transcript.length === 0) return;
 
-    const logDir = join(SOPHIE_ROOT, "logs/huddle");
+    const logDir = join(AGENT_REPO_DIR, "logs/huddle");
     mkdirSync(logDir, { recursive: true });
 
     const date = new Date().toISOString().split("T")[0];
@@ -984,7 +999,10 @@ class HuddleServer extends EventEmitter {
 // Huddle-specific system prompt
 // ---------------------------------------------------------------------------
 
-const HUDDLE_SYSTEM_PROMPT = `You are Sophie Nguyen, Chief of Staff to Mehran Granfar, CEO of Adaptic.ai.
+function buildHuddleSystemPrompt() {
+  const a = loadAgent();
+  const principal = a.principal || {};
+  return `You are ${a.fullName}, ${a.title} to ${principal.fullName || "the principal"}, ${principal.title || "the principal"} of ${a.company}.
 You are participating in a Slack huddle — a real-time voice conversation.
 
 PERSONALITY:
@@ -1026,6 +1044,9 @@ CRITICAL — DO NOT REPEAT YOURSELF:
 - Never re-introduce yourself after the initial greeting
 - Each response should add new information or move the conversation forward
 - If you already answered a question, do not repeat the answer`;
+}
+
+const HUDDLE_SYSTEM_PROMPT = buildHuddleSystemPrompt();
 
 // ---------------------------------------------------------------------------
 // Main

package/scripts/llm_email_dedup.py

@@ -35,22 +35,30 @@ import time
 from datetime import datetime, timedelta, timezone
 from email.utils import parsedate_to_datetime
 
-SOPHIE_AI = "/Users/sophie/sophie-ai"
-AUDIT_DIR = os.path.join(SOPHIE_AI, "logs", "audit")
+from pathlib import Path
+import json as _json
+AGENT_REPO_DIR = os.environ.get("AGENT_DIR", str(Path(__file__).resolve().parent.parent))
+AUDIT_DIR = os.path.join(AGENT_REPO_DIR, "logs", "audit")
 
-# Gmail credentials — same pattern as other send scripts
-SOPHIE_EMAIL = "sophie@adaptic.ai"
-SOPHIE_PASSWORD = os.environ.get("GMAIL_APP_PASSWORD", "")
+# Load agent identity (canonical SOT)
+try:
+    with open(os.path.join(AGENT_REPO_DIR, "config", "agent.json")) as _f:
+        _AGENT = _json.load(_f)
+except Exception:
+    _AGENT = {"email": "agent@example.com", "firstName": "agent"}
+
+AGENT_EMAIL = _AGENT.get("email", "agent@example.com")
+AGENT_GMAIL_PASSWORD = os.environ.get("GMAIL_APP_PASSWORD", "")
 
 # Load from .env if not in environment
-if not SOPHIE_PASSWORD:
-    _env_path = os.path.join(os.path.dirname(os.path.dirname(os.path.abspath(__file__))), ".env")
+if not AGENT_GMAIL_PASSWORD:
+    _env_path = os.path.join(AGENT_REPO_DIR, ".env")
     if os.path.exists(_env_path):
         with open(_env_path) as _f:
             for _line in _f:
                 _line = _line.strip()
                 if _line.startswith("GMAIL_APP_PASSWORD="):
-                    SOPHIE_PASSWORD = _line.split("=", 1)[1].strip().strip('"').strip("'")
+                    AGENT_GMAIL_PASSWORD = _line.split("=", 1)[1].strip().strip('"').strip("'")
                     break
 
 # Anthropic API key
@@ -112,9 +120,9 @@ def fetch_recent_thread_messages(to: str, subject: str, sender_email: str = "",
         List of message dicts sorted by date (newest first), or empty list on error.
     """
     if not sender_email:
-        sender_email = SOPHIE_EMAIL
+        sender_email = AGENT_EMAIL
     if not sender_password:
-        sender_password = SOPHIE_PASSWORD
+        sender_password = AGENT_GMAIL_PASSWORD
 
     if not sender_email or not sender_password:
         return []
@@ -283,7 +291,7 @@ def llm_dedup_check(to: str, subject: str, body: str,
         to: Recipient email address
         subject: Proposed email subject
         body: Proposed email body
-        sender_email: Sender's Gmail address (default: sophie@adaptic.ai)
+        sender_email: Sender's Gmail address (default: agent.email from config/agent.json)
         sender_password: Sender's app password (default: from env/config)
 
     Returns:
@@ -298,8 +306,8 @@ def llm_dedup_check(to: str, subject: str, body: str,
     # Fetch recent conversation history
     recent = fetch_recent_thread_messages(
         to, subject,
-        sender_email=sender_email or SOPHIE_EMAIL,
-        sender_password=sender_password or SOPHIE_PASSWORD,
+        sender_email=sender_email or AGENT_EMAIL,
+        sender_password=sender_password or AGENT_GMAIL_PASSWORD,
     )
 
     if not recent:
@@ -315,7 +323,7 @@ def llm_dedup_check(to: str, subject: str, body: str,
     # Build context for LLM assessment
     conversation_summary = []
     for i, msg in enumerate(recent):
-        direction = "SENT" if SOPHIE_EMAIL.lower() in msg.get("from", "").lower() or (sender_email and sender_email.lower() in msg.get("from", "").lower()) else "RECEIVED"
+        direction = "SENT" if AGENT_EMAIL.lower() in msg.get("from", "").lower() or (sender_email and sender_email.lower() in msg.get("from", "").lower()) else "RECEIVED"
         conversation_summary.append(
             f"[{i+1}] {direction} | Date: {msg['date']} | Subject: {msg['subject']}\n"
             f"    Preview: {msg['body_preview'][:300]}"
@@ -404,7 +412,7 @@ def main():
     parser.add_argument("to", help="Recipient email address")
     parser.add_argument("subject", help="Proposed email subject")
     parser.add_argument("body", help="Proposed email body")
-    parser.add_argument("--sender-email", default="", help="Sender email (default: sophie@adaptic.ai)")
+    parser.add_argument("--sender-email", default="", help="Sender email (default: agent.email from config/agent.json)")
     parser.add_argument("--sender-password", default="", help="Sender app password (default: from env)")
     parser.add_argument("--verbose", "-v", action="store_true", help="Show detailed output")
 

package/scripts/local-triggers/generate-plists.sh

@@ -40,7 +40,8 @@ echo "[generate-plists] User: $AGENT_USER"
 mkdir -p "$PLIST_DIR"
 
 # Clear old plists before generating — prevents stale plists from a previous
-# agent identity (e.g. sophie-*) from being installed alongside new ones
+# agent identity (e.g. an old AGENT_LAUNCHD_PREFIX) from being installed
+# alongside new ones
 rm -f "$PLIST_DIR"/*.plist 2>/dev/null
 
 # ── Helper: generate a single plist ──────────────────────────────────────────

package/scripts/media-generation/README.md

@@ -9,7 +9,7 @@ Ported from `~/adapticai/app/scripts/media-generation/` and `~/ai-born/`.
 
 ```bash
 # Install dependencies
-cd ~/sophie-ai && npm install
+cd ~/<agent-name> && npm install
 
 # Set API key in .env or config/environment.yaml
 echo "GEMINI_API_KEY=your-key-here" >> .env

package/scripts/outbound-dedup-cleanup.sh

@@ -5,14 +5,14 @@
 # Also cleans the legacy Slack locks in state/locks/slack-response/
 #
 # Intended to be run by launchd or cron every 5 minutes:
-#   */5 * * * * /Users/sophie/sophie-ai/scripts/outbound-dedup-cleanup.sh
+#   */5 * * * * <AGENT_REPO_DIR>/scripts/outbound-dedup-cleanup.sh
 #
 # Or via launchd plist with StartInterval: 300
 set -e
 
-SOPHIE_AI="/Users/sophie/sophie-ai"
-SCRIPT_DIR="$SOPHIE_AI/scripts"
-LOG_DIR="$SOPHIE_AI/logs/audit"
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+AGENT_REPO_DIR="${AGENT_DIR:-$(cd "$SCRIPT_DIR/.." && pwd)}"
+LOG_DIR="$AGENT_REPO_DIR/logs/audit"
 TIMESTAMP=$(date -u +%Y-%m-%dT%H:%M:%SZ)
 
 mkdir -p "$LOG_DIR"

package/scripts/outbound-dedup.sh

@@ -44,10 +44,11 @@
 #   - Full audit trail to logs/audit/
 set -e
 
-SOPHIE_AI="/Users/sophie/sophie-ai"
-LOCK_BASE_DIR="$SOPHIE_AI/state/locks/outbound"
+SCRIPT_DIR_INIT="$(cd "$(dirname "$0")" && pwd)"
+AGENT_REPO_DIR="${AGENT_DIR:-$(cd "$SCRIPT_DIR_INIT/.." && pwd)}"
+LOCK_BASE_DIR="$AGENT_REPO_DIR/state/locks/outbound"
 LOCK_TTL_MINUTES=720  # 12 hours — email dedup needs long TTL to prevent cross-session duplicates
-AUDIT_DIR="$SOPHIE_AI/logs/audit"
+AUDIT_DIR="$AGENT_REPO_DIR/logs/audit"
 TIMESTAMP=$(date -u +%Y-%m-%dT%H:%M:%SZ)
 
 # Ensure base directories exist

package/scripts/pdf-generation/README.md

@@ -15,7 +15,7 @@ brew install pandoc
 brew install --cask mactex-no-gui
 
 # Install Node.js dependencies
-cd ~/sophie-ai && npm install
+cd ~/<agent-name> && npm install
 ```
 
 ## Usage

package/scripts/pdf-generation/templates/memo.latex

@@ -49,7 +49,7 @@
 \renewcommand{\footrulewidth}{0.3pt}
 \fancyhead[L]{\includegraphics[height=10mm]{public/assets/adaptic-icon-dark.png}}
 \fancyhead[R]{\footnotesize\sffamily\color{adaptic-text-secondary} Internal — $if(title)$$title$$endif$}
-\fancyfoot[L]{\footnotesize\color{adaptic-text-secondary} Prepared by Sophie Nguyen, Chief of Staff}
+\fancyfoot[L]{\footnotesize\color{adaptic-text-secondary} $if(author)$Prepared by $author$$endif$}
 \fancyfoot[R]{\footnotesize\color{adaptic-text-secondary} \thepage}
 
 % ─── Links ───

package/scripts/poll-slack-events.sh

@@ -4,8 +4,10 @@
 # Run via cron every 5-10 seconds for near-instant response
 set -e
 
-EVENTS_URL="https://slack-events-server-production.up.railway.app/events"
-INBOX_DIR="/Users/sophie/sophie-ai/state/inbox/slack"
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+AGENT_REPO_DIR="${AGENT_DIR:-$(cd "$SCRIPT_DIR/.." && pwd)}"
+EVENTS_URL="${SLACK_EVENTS_RELAY_URL:-https://slack-events-server-production.up.railway.app/events}"
+INBOX_DIR="$AGENT_REPO_DIR/state/inbox/slack"
 mkdir -p "$INBOX_DIR"
 
 RESPONSE=$(curl -s --max-time 5 "$EVENTS_URL" 2>/dev/null)

package/scripts/poller/imap-client.mjs

@@ -1,4 +1,5 @@
-// imap-client.mjs — Shared native IMAP polling for Sophie and Mehran inboxes
+// imap-client.mjs — Shared native IMAP polling for the agent's inbox and
+// any other inbox the agent has explicit access to (e.g. principal-gmail).
 // Replaces external Python scripts with direct Node.js IMAP via imapflow.
 //
 // Each inbox gets its own credentials and file-naming convention, but the
@@ -9,10 +10,10 @@ import { ImapFlow } from "imapflow";
 import { writeFileSync, existsSync, readFileSync, mkdirSync } from "fs";
 import { join, dirname } from "path";
 import { createHash } from "crypto";
-import { SOPHIE_AI_DIR } from "./utils.mjs";
+import { AGENT_REPO_DIR } from "./utils.mjs";
 
-const INBOX_DIR = join(SOPHIE_AI_DIR, "state", "inbox", "gmail");
-const ATTACHMENTS_DIR = join(SOPHIE_AI_DIR, "state", "inbox", "attachments");
+const INBOX_DIR = join(AGENT_REPO_DIR, "state", "inbox", "gmail");
+const ATTACHMENTS_DIR = join(AGENT_REPO_DIR, "state", "inbox", "attachments");
 const MAX_EMAILS_PER_CYCLE = 20;
 const SNIPPET_LENGTH = 500;
 const IMAP_TIMEOUT_MS = 25_000;
@@ -55,7 +56,7 @@ function isAlreadyProcessed(midHash, suffix) {
 // ── Cursor Management ───────────────────────────────────────────────────
 
 function cursorPath(account) {
-  return join(SOPHIE_AI_DIR, "state", "polling", `${account}-gmail-cursor.yaml`);
+  return join(AGENT_REPO_DIR, "state", "polling", `${account}-gmail-cursor.yaml`);
 }
 
 function readImapCursor(account) {
@@ -128,12 +129,12 @@ function saveAttachments(parsed, midHash) {
  * Poll a Gmail inbox via IMAP and write new messages as JSON to the inbox dir.
  *
  * @param {object} opts
- * @param {string} opts.email       — Email address (e.g. sophie@adaptic.ai)
+ * @param {string} opts.email       — Email address to poll
  * @param {string} opts.password    — Gmail app password
- * @param {string} opts.account     — Account slug for cursor/file naming (e.g. "sophie" or "mehran")
- * @param {string} opts.fileSuffix  — JSON file suffix (e.g. "email" or "mehran-email")
- * @param {string} opts.eventType   — Event type tag (e.g. "sophie_email" or "mehran_email")
- * @param {string} opts.logPrefix   — Console log prefix (e.g. "[sophie-gmail]")
+ * @param {string} opts.account     — Account slug for cursor/file naming (e.g. agent's first name)
+ * @param {string} opts.fileSuffix  — JSON file suffix
+ * @param {string} opts.eventType   — Event type tag
+ * @param {string} opts.logPrefix   — Console log prefix
  * @returns {Promise<{newCount: number, errors: string[]}>}
  */
 export async function pollImapInbox({