@conversionpros/aiva 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (152) hide show
  1. package/README.md +148 -0
  2. package/auto-deploy.js +190 -0
  3. package/bin/aiva.js +81 -0
  4. package/cli-sync.js +126 -0
  5. package/d2a-prompt-template.txt +106 -0
  6. package/diagnostics-api.js +304 -0
  7. package/docs/ara-dedup-fix-scope.md +112 -0
  8. package/docs/ara-fix-round2-scope.md +61 -0
  9. package/docs/ara-greeting-fix-scope.md +70 -0
  10. package/docs/calendar-date-fix-scope.md +28 -0
  11. package/docs/getting-started.md +115 -0
  12. package/docs/network-architecture-rollout-scope.md +43 -0
  13. package/docs/scope-google-oauth-integration.md +351 -0
  14. package/docs/settings-page-scope.md +50 -0
  15. package/docs/xai-imagine-scope.md +116 -0
  16. package/docs/xai-voice-integration-scope.md +115 -0
  17. package/docs/xai-voice-tools-scope.md +165 -0
  18. package/email-router.js +512 -0
  19. package/follow-up-handler.js +606 -0
  20. package/gateway-monitor.js +158 -0
  21. package/google-email.js +379 -0
  22. package/google-oauth.js +310 -0
  23. package/grok-imagine.js +97 -0
  24. package/health-reporter.js +287 -0
  25. package/invisible-prefix-base.txt +206 -0
  26. package/invisible-prefix-owner.txt +26 -0
  27. package/invisible-prefix-slim.txt +10 -0
  28. package/invisible-prefix.txt +43 -0
  29. package/knowledge-base.js +472 -0
  30. package/lib/cli.js +19 -0
  31. package/lib/config.js +124 -0
  32. package/lib/health.js +57 -0
  33. package/lib/process.js +207 -0
  34. package/lib/server.js +42 -0
  35. package/lib/setup.js +472 -0
  36. package/meta-capi.js +206 -0
  37. package/meta-leads.js +411 -0
  38. package/notion-oauth.js +323 -0
  39. package/package.json +61 -0
  40. package/public/agent-config.html +241 -0
  41. package/public/aiva-avatar-anime.png +0 -0
  42. package/public/css/docs.css.bak +688 -0
  43. package/public/css/onboarding.css +543 -0
  44. package/public/diagrams/claude-subscription-pool.html +329 -0
  45. package/public/diagrams/claude-subscription-pool.png +0 -0
  46. package/public/docs-icon.png +0 -0
  47. package/public/escalation.html +237 -0
  48. package/public/group-config.html +300 -0
  49. package/public/icon-192.png +0 -0
  50. package/public/icon-512.png +0 -0
  51. package/public/icons/agents.svg +1 -0
  52. package/public/icons/attach.svg +1 -0
  53. package/public/icons/characters.svg +1 -0
  54. package/public/icons/chat.svg +1 -0
  55. package/public/icons/docs.svg +1 -0
  56. package/public/icons/heartbeat.svg +1 -0
  57. package/public/icons/messages.svg +1 -0
  58. package/public/icons/mic.svg +1 -0
  59. package/public/icons/notes.svg +1 -0
  60. package/public/icons/settings.svg +1 -0
  61. package/public/icons/tasks.svg +1 -0
  62. package/public/images/onboarding/p0-communication-layer.png +0 -0
  63. package/public/images/onboarding/p0-infinite-surface.png +0 -0
  64. package/public/images/onboarding/p0-learning-model.png +0 -0
  65. package/public/images/onboarding/p0-meet-aiva.png +0 -0
  66. package/public/images/onboarding/p4-contact-intelligence.png +0 -0
  67. package/public/images/onboarding/p4-context-compounds.png +0 -0
  68. package/public/images/onboarding/p4-message-router.png +0 -0
  69. package/public/images/onboarding/p4-per-contact-rules.png +0 -0
  70. package/public/images/onboarding/p4-send-messages.png +0 -0
  71. package/public/images/onboarding/p6-be-precise.png +0 -0
  72. package/public/images/onboarding/p6-review-escalations.png +0 -0
  73. package/public/images/onboarding/p6-voice-input.png +0 -0
  74. package/public/images/onboarding/p7-completion.png +0 -0
  75. package/public/index.html +11594 -0
  76. package/public/js/onboarding.js +699 -0
  77. package/public/manifest.json +24 -0
  78. package/public/messages-v2.html +2824 -0
  79. package/public/permission-approve.html.bak +107 -0
  80. package/public/permissions.html +150 -0
  81. package/public/styles/design-system.css +68 -0
  82. package/router-db.js +604 -0
  83. package/router-utils.js +28 -0
  84. package/router-v2/adapters/imessage.js +191 -0
  85. package/router-v2/adapters/quo.js +82 -0
  86. package/router-v2/adapters/whatsapp.js +192 -0
  87. package/router-v2/contact-manager.js +234 -0
  88. package/router-v2/conversation-engine.js +498 -0
  89. package/router-v2/data/knowledge-base.json +176 -0
  90. package/router-v2/data/router-v2.db +0 -0
  91. package/router-v2/data/router-v2.db-shm +0 -0
  92. package/router-v2/data/router-v2.db-wal +0 -0
  93. package/router-v2/data/router.db +0 -0
  94. package/router-v2/db.js +457 -0
  95. package/router-v2/escalation-bridge.js +540 -0
  96. package/router-v2/follow-up-engine.js +347 -0
  97. package/router-v2/index.js +441 -0
  98. package/router-v2/ingestion.js +213 -0
  99. package/router-v2/knowledge-base.js +231 -0
  100. package/router-v2/lead-qualifier.js +152 -0
  101. package/router-v2/learning-loop.js +202 -0
  102. package/router-v2/outbound-sender.js +160 -0
  103. package/router-v2/package.json +13 -0
  104. package/router-v2/permission-gate.js +86 -0
  105. package/router-v2/playbook.js +177 -0
  106. package/router-v2/prompts/base.js +52 -0
  107. package/router-v2/prompts/first-contact.js +38 -0
  108. package/router-v2/prompts/lead-qualification.js +37 -0
  109. package/router-v2/prompts/scheduling.js +72 -0
  110. package/router-v2/prompts/style-overrides.js +22 -0
  111. package/router-v2/scheduler.js +301 -0
  112. package/router-v2/scripts/migrate-v1-to-v2.js +215 -0
  113. package/router-v2/scripts/seed-faq.js +67 -0
  114. package/router-v2/seed-knowledge-base.js +39 -0
  115. package/router-v2/utils/ai.js +129 -0
  116. package/router-v2/utils/phone.js +52 -0
  117. package/router-v2/utils/response-validator.js +98 -0
  118. package/router-v2/utils/sanitize.js +222 -0
  119. package/router.js +5005 -0
  120. package/routes/google-calendar.js +186 -0
  121. package/scripts/deploy.sh +62 -0
  122. package/scripts/macos-calendar.sh +232 -0
  123. package/scripts/onboard-device.sh +466 -0
  124. package/server.js +5131 -0
  125. package/start.sh +24 -0
  126. package/templates/AGENTS.md +548 -0
  127. package/templates/IDENTITY.md +15 -0
  128. package/templates/docs-agents.html +132 -0
  129. package/templates/docs-app.html +130 -0
  130. package/templates/docs-home.html +83 -0
  131. package/templates/docs-imessage.html +121 -0
  132. package/templates/docs-tasks.html +123 -0
  133. package/templates/docs-tips.html +175 -0
  134. package/templates/getting-started.html +809 -0
  135. package/templates/invisible-prefix-base.txt +171 -0
  136. package/templates/invisible-prefix-owner.txt +282 -0
  137. package/templates/invisible-prefix.txt +338 -0
  138. package/templates/manifest.json +61 -0
  139. package/templates/memory-org/clients.md +7 -0
  140. package/templates/memory-org/credentials.md +9 -0
  141. package/templates/memory-org/devices.md +7 -0
  142. package/templates/updates.html +464 -0
  143. package/templates/workspace/AGENTS.md.tmpl +161 -0
  144. package/templates/workspace/HEARTBEAT.md.tmpl +17 -0
  145. package/templates/workspace/IDENTITY.md.tmpl +15 -0
  146. package/templates/workspace/MEMORY.md.tmpl +16 -0
  147. package/templates/workspace/SOUL.md.tmpl +51 -0
  148. package/templates/workspace/USER.md.tmpl +25 -0
  149. package/tts-proxy.js +96 -0
  150. package/voice-call-local.js +731 -0
  151. package/voice-call.js +732 -0
  152. package/wa-listener.js +354 -0
package/templates/docs-agents.html ADDED
@@ -0,0 +1,132 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Meet Your Agents — AIVA</title>
7
+ <link rel="stylesheet" href="/css/docs.css">
8
+ </head>
9
+ <body>
10
+
11
+ <div class="mobile-header">
12
+ <button class="hamburger-btn" id="hamburgerBtn" aria-label="Menu"><span></span></button>
13
+ <span class="mobile-title">AIVA Docs</span>
14
+ </div>
15
+ <div class="mobile-overlay" id="mobileOverlay"></div>
16
+
17
+ <nav class="docs-sidebar" id="sidebar">
18
+ <div class="sidebar-header">
19
+ <a href="/getting-started" class="sidebar-logo">AIVA <span>Docs</span></a>
20
+ </div>
21
+ <div class="sidebar-label">Getting Started</div>
22
+ <div class="sidebar-nav">
23
+ <a href="/getting-started">Overview</a>
24
+ <a href="/getting-started/agents" class="active">Meet Your Agents</a>
25
+ <a href="/getting-started/app">The AIVA App</a>
26
+ <a href="/getting-started/imessage">iMessage &amp; Outreach</a>
27
+ <a href="/getting-started/tasks">Your Task Board</a>
28
+ <a href="/getting-started/tips">Pro Tips</a>
29
+ <div class="nav-divider"></div>
30
+ <a href="/updates">Updates</a>
31
+ </div>
32
+ </nav>
33
+
34
+ <main class="docs-content">
35
+ <div class="content-inner fade-in">
36
+
37
+ <div class="page-label">Architecture</div>
38
+ <h1 class="page-title">Meet Your Agents</h1>
39
+ <p class="page-desc">AIVA uses a multi-agent system, meaning different agents handle different types of work. Here is who does what.</p>
40
+
41
+ <div class="agent-grid">
42
+ <div class="agent-card full-width">
43
+ <div class="agent-icon">
44
+ <svg viewBox="0 0 24 24"><circle cx="12" cy="12" r="3"/><path d="M12 1v2M12 21v2M4.22 4.22l1.42 1.42M18.36 18.36l1.42 1.42M1 12h2M21 12h2M4.22 19.78l1.42-1.42M18.36 5.64l1.42-1.42"/></svg>
45
+ </div>
46
+ <h3>Main Agent</h3>
47
+ <div class="agent-role">Your Central Brain</div>
48
+ <p>This is the agent you talk to in the AIVA App. It is the coordinator — the one that receives your requests and figures out who should handle them.</p>
49
+ <ul>
50
+ <li>Receives your requests and figures out who should handle them</li>
51
+ <li>Manages your task board</li>
52
+ <li>Distributes knowledge across all other agents</li>
53
+ <li>Handles calendar, email monitoring, and general questions</li>
54
+ <li>Sends you morning and evening briefings</li>
55
+ </ul>
56
+ <p style="margin-top:0.75rem;"><strong>Think of it as your executive assistant</strong> who delegates to specialists.</p>
57
+ </div>
58
+
59
+ <div class="agent-card">
60
+ <div class="agent-icon">
61
+ <svg viewBox="0 0 24 24"><path d="M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z"/></svg>
62
+ </div>
63
+ <h3>Outreach Agent</h3>
64
+ <div class="agent-role">Your Message Manager</div>
65
+ <p>Handles all iMessage and text communication. When someone texts your AIVA-managed number:</p>
66
+ <ul>
67
+ <li>Reads and responds based on your preferences</li>
68
+ <li>Manages conversations with contacts on your behalf</li>
69
+ <li>Follows up on active conversations automatically</li>
70
+ <li>Surfaces important messages to the main agent</li>
71
+ </ul>
72
+ <p style="margin-top:0.75rem;"><strong>Think of it as your receptionist</strong> — fielding calls and messages so you do not have to.</p>
73
+ </div>
74
+
75
+ <div class="agent-card">
76
+ <div class="agent-icon">
77
+ <svg viewBox="0 0 24 24"><rect x="2" y="4" width="20" height="16" rx="2"/><path d="M22 7l-10 7L2 7"/></svg>
78
+ </div>
79
+ <h3>Email Agent</h3>
80
+ <div class="agent-role">Your Inbox Manager</div>
81
+ <p>Monitors your email, triages messages, and alerts you to anything important. Routine stuff gets handled automatically so you only see what matters.</p>
82
+ </div>
83
+
84
+ <div class="agent-card">
85
+ <div class="agent-icon">
86
+ <svg viewBox="0 0 24 24"><circle cx="11" cy="11" r="8"/><path d="M21 21l-4.35-4.35"/></svg>
87
+ </div>
88
+ <h3>Research Agent</h3>
89
+ <div class="agent-role">Your Analyst</div>
90
+ <p>When you need information — market research, competitor analysis, or deep dives on a topic — the research agent handles it and reports back with findings.</p>
91
+ </div>
92
+
93
+ <div class="agent-card">
94
+ <div class="agent-icon">
95
+ <svg viewBox="0 0 24 24"><path d="M12 20h9"/><path d="M16.5 3.5a2.121 2.121 0 0 1 3 3L7 19l-4 1 1-4L16.5 3.5z"/></svg>
96
+ </div>
97
+ <h3>Content Agent</h3>
98
+ <div class="agent-role">Your Writer</div>
99
+ <p>Handles content creation tasks — drafts, copy, documentation, social posts, and more.</p>
100
+ </div>
101
+ </div>
102
+
103
+ <div class="docs-nav-footer">
104
+ <a href="/getting-started" class="nav-link prev">
105
+ <span class="nav-label">Previous</span>
106
+ <span class="nav-title">Overview</span>
107
+ </a>
108
+ <a href="/getting-started/app" class="nav-link next">
109
+ <span class="nav-label">Next</span>
110
+ <span class="nav-title">The AIVA App</span>
111
+ </a>
112
+ </div>
113
+
114
+ </div>
115
+ </main>
116
+
117
+ <script>
118
+ (function(){
119
+ var btn=document.getElementById('hamburgerBtn'),
120
+ sidebar=document.getElementById('sidebar'),
121
+ overlay=document.getElementById('mobileOverlay');
122
+ function toggle(){
123
+ var open=sidebar.classList.toggle('open');
124
+ overlay.classList.toggle('open',open);
125
+ btn.classList.toggle('open',open);
126
+ }
127
+ btn.addEventListener('click',toggle);
128
+ overlay.addEventListener('click',toggle);
129
+ })();
130
+ </script>
131
+ </body>
132
+ </html>
package/templates/docs-app.html ADDED
@@ -0,0 +1,130 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>The AIVA App — AIVA</title>
7
+ <link rel="stylesheet" href="/css/docs.css">
8
+ </head>
9
+ <body>
10
+
11
+ <div class="mobile-header">
12
+ <button class="hamburger-btn" id="hamburgerBtn" aria-label="Menu"><span></span></button>
13
+ <span class="mobile-title">AIVA Docs</span>
14
+ </div>
15
+ <div class="mobile-overlay" id="mobileOverlay"></div>
16
+
17
+ <nav class="docs-sidebar" id="sidebar">
18
+ <div class="sidebar-header">
19
+ <a href="/getting-started" class="sidebar-logo">AIVA <span>Docs</span></a>
20
+ </div>
21
+ <div class="sidebar-label">Getting Started</div>
22
+ <div class="sidebar-nav">
23
+ <a href="/getting-started">Overview</a>
24
+ <a href="/getting-started/agents">Meet Your Agents</a>
25
+ <a href="/getting-started/app" class="active">The AIVA App</a>
26
+ <a href="/getting-started/imessage">iMessage &amp; Outreach</a>
27
+ <a href="/getting-started/tasks">Your Task Board</a>
28
+ <a href="/getting-started/tips">Pro Tips</a>
29
+ <div class="nav-divider"></div>
30
+ <a href="/updates">Updates</a>
31
+ </div>
32
+ </nav>
33
+
34
+ <main class="docs-content">
35
+ <div class="content-inner fade-in">
36
+
37
+ <div class="page-label">Communication</div>
38
+ <h1 class="page-title">The AIVA App</h1>
39
+ <p class="page-desc">The AIVA app is your central hub — the primary way to interact with your assistant. This is where requests, planning, and brain dumps happen.</p>
40
+
41
+ <div class="doc-section">
42
+ <h2 class="section-title">Your Main Channel</h2>
43
+ <p class="section-desc">The app is where you should do most of your communication with AIVA. Here is what you can do:</p>
44
+ <ul style="list-style:none;padding:0;">
45
+ <li style="font-size:0.95rem;color:var(--text);padding:0.6rem 0;padding-left:1.1rem;position:relative;line-height:1.6;border-bottom:1px solid var(--border);">
46
+ <span style="position:absolute;left:0;top:0.85rem;width:5px;height:5px;border-radius:50%;background:var(--accent);opacity:0.5;"></span>
47
+ <strong style="color:var(--text-heading);">Brain dump</strong> — tell AIVA everything on your mind. She will organize it, create tasks, and distribute knowledge to the right agents.
48
+ </li>
49
+ <li style="font-size:0.95rem;color:var(--text);padding:0.6rem 0;padding-left:1.1rem;position:relative;line-height:1.6;border-bottom:1px solid var(--border);">
50
+ <span style="position:absolute;left:0;top:0.85rem;width:5px;height:5px;border-radius:50%;background:var(--accent);opacity:0.5;"></span>
51
+ <strong style="color:var(--text-heading);">Make requests</strong> — "Schedule a meeting with John next week" or "Research the best CRM tools for small businesses"
52
+ </li>
53
+ <li style="font-size:0.95rem;color:var(--text);padding:0.6rem 0;padding-left:1.1rem;position:relative;line-height:1.6;border-bottom:1px solid var(--border);">
54
+ <span style="position:absolute;left:0;top:0.85rem;width:5px;height:5px;border-radius:50%;background:var(--accent);opacity:0.5;"></span>
55
+ <strong style="color:var(--text-heading);">Check your task board</strong> — see what is in progress, what is done, and what needs attention
56
+ </li>
57
+ <li style="font-size:0.95rem;color:var(--text);padding:0.6rem 0;padding-left:1.1rem;position:relative;line-height:1.6;">
58
+ <span style="position:absolute;left:0;top:0.85rem;width:5px;height:5px;border-radius:50%;background:var(--accent);opacity:0.5;"></span>
59
+ <strong style="color:var(--text-heading);">Review agent activity</strong> — see what your agents are working on
60
+ </li>
61
+ </ul>
62
+ </div>
63
+
64
+ <div class="doc-section">
65
+ <h2 class="section-title">Voice Messages</h2>
66
+ <p class="section-desc">Voice messages work great in the app. Just talk naturally — AIVA will transcribe and act on it. This is often the fastest way to do a brain dump or give complex instructions.</p>
67
+ <div class="callout">
68
+ <strong>Pro tip:</strong> Voice messages are especially useful when you have a lot on your mind. Just talk through it — AIVA will parse out the tasks, context, and action items.
69
+ </div>
70
+ </div>
71
+
72
+ <div class="doc-section">
73
+ <h2 class="section-title">Knowledge Distribution</h2>
74
+ <p class="section-desc">When you share information in the app, your main agent does not just store it — she distributes relevant pieces to the right agents. Tell AIVA about a new contact and the outreach agent learns about them. Mention a content idea and the content agent gets briefed.</p>
75
+ </div>
76
+
77
+ <div class="doc-section">
78
+ <h2 class="section-title">What Happens When You Submit a Request</h2>
79
+ <div class="workflow-step">
80
+ <div class="step-num">1</div>
81
+ <div class="step-content"><strong>You send a message</strong><span>Via app, voice, or text</span></div>
82
+ </div>
83
+ <div class="workflow-step">
84
+ <div class="step-num">2</div>
85
+ <div class="step-content"><strong>AIVA receives it</strong><span>And creates a task on your board</span></div>
86
+ </div>
87
+ <div class="workflow-step">
88
+ <div class="step-num">3</div>
89
+ <div class="step-content"><strong>The right agent picks it up</strong><span>Based on what needs to be done</span></div>
90
+ </div>
91
+ <div class="workflow-step">
92
+ <div class="step-num">4</div>
93
+ <div class="step-content"><strong>Work happens</strong><span>You can check progress on the task board anytime</span></div>
94
+ </div>
95
+ <div class="workflow-step">
96
+ <div class="step-num">5</div>
97
+ <div class="step-content"><strong>You get notified</strong><span>When it is done, with a summary of what was accomplished</span></div>
98
+ </div>
99
+ </div>
100
+
101
+ <div class="docs-nav-footer">
102
+ <a href="/getting-started/agents" class="nav-link prev">
103
+ <span class="nav-label">Previous</span>
104
+ <span class="nav-title">Meet Your Agents</span>
105
+ </a>
106
+ <a href="/getting-started/imessage" class="nav-link next">
107
+ <span class="nav-label">Next</span>
108
+ <span class="nav-title">iMessage &amp; Outreach</span>
109
+ </a>
110
+ </div>
111
+
112
+ </div>
113
+ </main>
114
+
115
+ <script>
116
+ (function(){
117
+ var btn=document.getElementById('hamburgerBtn'),
118
+ sidebar=document.getElementById('sidebar'),
119
+ overlay=document.getElementById('mobileOverlay');
120
+ function toggle(){
121
+ var open=sidebar.classList.toggle('open');
122
+ overlay.classList.toggle('open',open);
123
+ btn.classList.toggle('open',open);
124
+ }
125
+ btn.addEventListener('click',toggle);
126
+ overlay.addEventListener('click',toggle);
127
+ })();
128
+ </script>
129
+ </body>
130
+ </html>
package/templates/docs-home.html ADDED
@@ -0,0 +1,83 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Getting Started — AIVA</title>
7
+ <link rel="stylesheet" href="/css/docs.css">
8
+ </head>
9
+ <body>
10
+
11
+ <!-- Mobile Header -->
12
+ <div class="mobile-header">
13
+ <button class="hamburger-btn" id="hamburgerBtn" aria-label="Menu"><span></span></button>
14
+ <span class="mobile-title">AIVA Docs</span>
15
+ </div>
16
+ <div class="mobile-overlay" id="mobileOverlay"></div>
17
+
18
+ <!-- Sidebar -->
19
+ <nav class="docs-sidebar" id="sidebar">
20
+ <div class="sidebar-header">
21
+ <a href="/getting-started" class="sidebar-logo">AIVA <span>Docs</span></a>
22
+ </div>
23
+ <div class="sidebar-label">Getting Started</div>
24
+ <div class="sidebar-nav">
25
+ <a href="/getting-started" class="active">Overview</a>
26
+ <a href="/getting-started/agents">Meet Your Agents</a>
27
+ <a href="/getting-started/app">The AIVA App</a>
28
+ <a href="/getting-started/imessage">iMessage &amp; Outreach</a>
29
+ <a href="/getting-started/tasks">Your Task Board</a>
30
+ <a href="/getting-started/tips">Pro Tips</a>
31
+ <div class="nav-divider"></div>
32
+ <a href="/updates">Updates</a>
33
+ </div>
34
+ </nav>
35
+
36
+ <!-- Content -->
37
+ <main class="docs-content">
38
+ <div class="content-inner fade-in">
39
+
40
+ <div class="page-label">Overview</div>
41
+ <h1 class="page-title">Getting to Know Your AIVA Assistant</h1>
42
+ <p class="page-desc">AIVA is your personal AI-powered assistant designed to help you stay organized, communicate effectively, and get things done. Here is everything you need to know.</p>
43
+
44
+ <div class="doc-section">
45
+ <h2 class="section-title">What is AIVA?</h2>
46
+ <p class="section-desc">AIVA is more than a chatbot — she is a team of specialized AI agents working together behind the scenes. Think of it like having a personal office staff: each agent has a specific role, and they coordinate to handle your requests efficiently.</p>
47
+ <p class="section-desc">You do not need to worry about which agent does what — just communicate naturally, and AIVA routes everything to the right place.</p>
48
+ </div>
49
+
50
+ <div class="doc-section">
51
+ <h2 class="section-title">How It Works</h2>
52
+ <p class="section-desc">AIVA uses a multi-agent architecture. Different agents handle different types of work — from managing your messages to researching topics to writing content. Your main agent acts as the coordinator, delegating tasks to the right specialist.</p>
53
+ <p class="section-desc">Use these docs to learn about each agent, how to communicate with AIVA, and how to get the most out of your assistant.</p>
54
+ </div>
55
+
56
+ <!-- Prev/Next -->
57
+ <div class="docs-nav-footer">
58
+ <div></div>
59
+ <a href="/getting-started/agents" class="nav-link next">
60
+ <span class="nav-label">Next</span>
61
+ <span class="nav-title">Meet Your Agents</span>
62
+ </a>
63
+ </div>
64
+
65
+ </div>
66
+ </main>
67
+
68
+ <script>
69
+ (function(){
70
+ var btn=document.getElementById('hamburgerBtn'),
71
+ sidebar=document.getElementById('sidebar'),
72
+ overlay=document.getElementById('mobileOverlay');
73
+ function toggle(){
74
+ var open=sidebar.classList.toggle('open');
75
+ overlay.classList.toggle('open',open);
76
+ btn.classList.toggle('open',open);
77
+ }
78
+ btn.addEventListener('click',toggle);
79
+ overlay.addEventListener('click',toggle);
80
+ })();
81
+ </script>
82
+ </body>
83
+ </html>
package/templates/docs-imessage.html ADDED
@@ -0,0 +1,121 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>iMessage &amp; Outreach — AIVA</title>
7
+ <link rel="stylesheet" href="/css/docs.css">
8
+ </head>
9
+ <body>
10
+
11
+ <div class="mobile-header">
12
+ <button class="hamburger-btn" id="hamburgerBtn" aria-label="Menu"><span></span></button>
13
+ <span class="mobile-title">AIVA Docs</span>
14
+ </div>
15
+ <div class="mobile-overlay" id="mobileOverlay"></div>
16
+
17
+ <nav class="docs-sidebar" id="sidebar">
18
+ <div class="sidebar-header">
19
+ <a href="/getting-started" class="sidebar-logo">AIVA <span>Docs</span></a>
20
+ </div>
21
+ <div class="sidebar-label">Getting Started</div>
22
+ <div class="sidebar-nav">
23
+ <a href="/getting-started">Overview</a>
24
+ <a href="/getting-started/agents">Meet Your Agents</a>
25
+ <a href="/getting-started/app">The AIVA App</a>
26
+ <a href="/getting-started/imessage" class="active">iMessage &amp; Outreach</a>
27
+ <a href="/getting-started/tasks">Your Task Board</a>
28
+ <a href="/getting-started/tips">Pro Tips</a>
29
+ <div class="nav-divider"></div>
30
+ <a href="/updates">Updates</a>
31
+ </div>
32
+ </nav>
33
+
34
+ <main class="docs-content">
35
+ <div class="content-inner fade-in">
36
+
37
+ <div class="page-label">Communication</div>
38
+ <h1 class="page-title">iMessage &amp; Outreach</h1>
39
+ <p class="page-desc">Messages sent to your AIVA phone number go directly to the outreach agent. This is a separate specialist from your main AIVA — purpose-built for managing conversations.</p>
40
+
41
+ <div class="doc-section">
42
+ <h2 class="section-title">How the Outreach Agent Works</h2>
43
+ <p class="section-desc">The outreach agent handles all iMessage and text communication on your behalf. When someone texts your AIVA-managed number, the outreach agent:</p>
44
+ <ul style="list-style:none;padding:0;">
45
+ <li style="font-size:0.95rem;color:var(--text);padding:0.6rem 0;padding-left:1.1rem;position:relative;line-height:1.6;border-bottom:1px solid var(--border);">
46
+ <span style="position:absolute;left:0;top:0.85rem;width:5px;height:5px;border-radius:50%;background:var(--accent);opacity:0.5;"></span>
47
+ Reads and responds based on your preferences
48
+ </li>
49
+ <li style="font-size:0.95rem;color:var(--text);padding:0.6rem 0;padding-left:1.1rem;position:relative;line-height:1.6;border-bottom:1px solid var(--border);">
50
+ <span style="position:absolute;left:0;top:0.85rem;width:5px;height:5px;border-radius:50%;background:var(--accent);opacity:0.5;"></span>
51
+ Manages conversations with contacts on your behalf
52
+ </li>
53
+ <li style="font-size:0.95rem;color:var(--text);padding:0.6rem 0;padding-left:1.1rem;position:relative;line-height:1.6;border-bottom:1px solid var(--border);">
54
+ <span style="position:absolute;left:0;top:0.85rem;width:5px;height:5px;border-radius:50%;background:var(--accent);opacity:0.5;"></span>
55
+ Follows up on active conversations automatically
56
+ </li>
57
+ <li style="font-size:0.95rem;color:var(--text);padding:0.6rem 0;padding-left:1.1rem;position:relative;line-height:1.6;">
58
+ <span style="position:absolute;left:0;top:0.85rem;width:5px;height:5px;border-radius:50%;background:var(--accent);opacity:0.5;"></span>
59
+ Surfaces important messages to the main agent
60
+ </li>
61
+ </ul>
62
+ </div>
63
+
64
+ <div class="doc-section">
65
+ <h2 class="section-title">Training Your Outreach Agent</h2>
66
+ <p class="section-desc">Training happens through iMessage conversations. The more context you give the outreach agent about how you want to handle specific contacts, the better it gets. You can set preferences for each contact:</p>
67
+ <ul style="list-style:none;padding:0;">
68
+ <li style="font-size:0.95rem;color:var(--text);padding:0.6rem 0;padding-left:1.1rem;position:relative;line-height:1.6;border-bottom:1px solid var(--border);">
69
+ <span style="position:absolute;left:0;top:0.85rem;width:5px;height:5px;border-radius:50%;background:var(--accent);opacity:0.5;"></span>
70
+ <strong style="color:var(--text-heading);">Respond</strong> — actively engage and reply on your behalf
71
+ </li>
72
+ <li style="font-size:0.95rem;color:var(--text);padding:0.6rem 0;padding-left:1.1rem;position:relative;line-height:1.6;border-bottom:1px solid var(--border);">
73
+ <span style="position:absolute;left:0;top:0.85rem;width:5px;height:5px;border-radius:50%;background:var(--accent);opacity:0.5;"></span>
74
+ <strong style="color:var(--text-heading);">Ignore</strong> — do not respond to this contact
75
+ </li>
76
+ <li style="font-size:0.95rem;color:var(--text);padding:0.6rem 0;padding-left:1.1rem;position:relative;line-height:1.6;">
77
+ <span style="position:absolute;left:0;top:0.85rem;width:5px;height:5px;border-radius:50%;background:var(--accent);opacity:0.5;"></span>
78
+ <strong style="color:var(--text-heading);">Take message only</strong> — acknowledge receipt but defer to you
79
+ </li>
80
+ </ul>
81
+ </div>
82
+
83
+ <div class="doc-section">
84
+ <h2 class="section-title">Separate from Main Agent</h2>
85
+ <p class="section-desc">The outreach agent is a separate specialist. It has its own memory, its own conversation style, and its own training. This separation is intentional — it allows the outreach agent to be laser-focused on communication while your main agent handles everything else.</p>
86
+
87
+ <div class="callout warning">
88
+ <strong>Important:</strong> The outreach agent is a separate specialist from your main AIVA. Training it happens through iMessage conversations. The more context you give it about how you want to handle specific contacts, the better it gets. She will always check with you before contacting someone new.
89
+ </div>
90
+ </div>
91
+
92
+ <div class="docs-nav-footer">
93
+ <a href="/getting-started/app" class="nav-link prev">
94
+ <span class="nav-label">Previous</span>
95
+ <span class="nav-title">The AIVA App</span>
96
+ </a>
97
+ <a href="/getting-started/tasks" class="nav-link next">
98
+ <span class="nav-label">Next</span>
99
+ <span class="nav-title">Your Task Board</span>
100
+ </a>
101
+ </div>
102
+
103
+ </div>
104
+ </main>
105
+
106
+ <script>
107
+ (function(){
108
+ var btn=document.getElementById('hamburgerBtn'),
109
+ sidebar=document.getElementById('sidebar'),
110
+ overlay=document.getElementById('mobileOverlay');
111
+ function toggle(){
112
+ var open=sidebar.classList.toggle('open');
113
+ overlay.classList.toggle('open',open);
114
+ btn.classList.toggle('open',open);
115
+ }
116
+ btn.addEventListener('click',toggle);
117
+ overlay.addEventListener('click',toggle);
118
+ })();
119
+ </script>
120
+ </body>
121
+ </html>
package/templates/docs-tasks.html ADDED
@@ -0,0 +1,123 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Your Task Board — AIVA</title>
7
+ <link rel="stylesheet" href="/css/docs.css">
8
+ </head>
9
+ <body>
10
+
11
+ <div class="mobile-header">
12
+ <button class="hamburger-btn" id="hamburgerBtn" aria-label="Menu"><span></span></button>
13
+ <span class="mobile-title">AIVA Docs</span>
14
+ </div>
15
+ <div class="mobile-overlay" id="mobileOverlay"></div>
16
+
17
+ <nav class="docs-sidebar" id="sidebar">
18
+ <div class="sidebar-header">
19
+ <a href="/getting-started" class="sidebar-logo">AIVA <span>Docs</span></a>
20
+ </div>
21
+ <div class="sidebar-label">Getting Started</div>
22
+ <div class="sidebar-nav">
23
+ <a href="/getting-started">Overview</a>
24
+ <a href="/getting-started/agents">Meet Your Agents</a>
25
+ <a href="/getting-started/app">The AIVA App</a>
26
+ <a href="/getting-started/imessage">iMessage &amp; Outreach</a>
27
+ <a href="/getting-started/tasks" class="active">Your Task Board</a>
28
+ <a href="/getting-started/tips">Pro Tips</a>
29
+ <div class="nav-divider"></div>
30
+ <a href="/updates">Updates</a>
31
+ </div>
32
+ </nav>
33
+
34
+ <main class="docs-content">
35
+ <div class="content-inner fade-in">
36
+
37
+ <div class="page-label">Workflow</div>
38
+ <h1 class="page-title">Your Task Board</h1>
39
+ <p class="page-desc">Every request you make becomes a task. The task board is your single source of truth for all work in progress.</p>
40
+
41
+ <div class="doc-section">
42
+ <h2 class="section-title">Task Flow</h2>
43
+ <p class="section-desc">Tasks move through a simple pipeline as work progresses:</p>
44
+
45
+ <div style="display:flex;gap:1rem;flex-wrap:wrap;margin-bottom:2rem;">
46
+ <div style="flex:1;min-width:140px;background:var(--bg-card);border:1px solid var(--border);border-radius:var(--radius);padding:1.5rem;text-align:center;">
47
+ <div style="font-size:1.5rem;font-weight:700;color:var(--accent);margin-bottom:0.5rem;">To Do</div>
48
+ <p style="font-size:0.85rem;color:var(--text-secondary);line-height:1.5;">Request received, queued for action</p>
49
+ </div>
50
+ <div style="display:flex;align-items:center;color:var(--text-secondary);font-size:1.2rem;">&#8594;</div>
51
+ <div style="flex:1;min-width:140px;background:var(--bg-card);border:1px solid var(--border);border-radius:var(--radius);padding:1.5rem;text-align:center;">
52
+ <div style="font-size:1.5rem;font-weight:700;color:#f0c27a;margin-bottom:0.5rem;">In Progress</div>
53
+ <p style="font-size:0.85rem;color:var(--text-secondary);line-height:1.5;">An agent is actively working on it</p>
54
+ </div>
55
+ <div style="display:flex;align-items:center;color:var(--text-secondary);font-size:1.2rem;">&#8594;</div>
56
+ <div style="flex:1;min-width:140px;background:var(--bg-card);border:1px solid var(--border);border-radius:var(--radius);padding:1.5rem;text-align:center;">
57
+ <div style="font-size:1.5rem;font-weight:700;color:#6fcf97;margin-bottom:0.5rem;">Done</div>
58
+ <p style="font-size:0.85rem;color:var(--text-secondary);line-height:1.5;">Completed, with a summary of results</p>
59
+ </div>
60
+ </div>
61
+ </div>
62
+
63
+ <div class="doc-section">
64
+ <h2 class="section-title">Checking Progress</h2>
65
+ <p class="section-desc">You can check the task board anytime in the AIVA app to see:</p>
66
+ <ul style="list-style:none;padding:0;">
67
+ <li style="font-size:0.95rem;color:var(--text);padding:0.6rem 0;padding-left:1.1rem;position:relative;line-height:1.6;border-bottom:1px solid var(--border);">
68
+ <span style="position:absolute;left:0;top:0.85rem;width:5px;height:5px;border-radius:50%;background:var(--accent);opacity:0.5;"></span>
69
+ What tasks are queued and waiting
70
+ </li>
71
+ <li style="font-size:0.95rem;color:var(--text);padding:0.6rem 0;padding-left:1.1rem;position:relative;line-height:1.6;border-bottom:1px solid var(--border);">
72
+ <span style="position:absolute;left:0;top:0.85rem;width:5px;height:5px;border-radius:50%;background:var(--accent);opacity:0.5;"></span>
73
+ What is currently being worked on
74
+ </li>
75
+ <li style="font-size:0.95rem;color:var(--text);padding:0.6rem 0;padding-left:1.1rem;position:relative;line-height:1.6;border-bottom:1px solid var(--border);">
76
+ <span style="position:absolute;left:0;top:0.85rem;width:5px;height:5px;border-radius:50%;background:var(--accent);opacity:0.5;"></span>
77
+ What has been completed and the results
78
+ </li>
79
+ <li style="font-size:0.95rem;color:var(--text);padding:0.6rem 0;padding-left:1.1rem;position:relative;line-height:1.6;">
80
+ <span style="position:absolute;left:0;top:0.85rem;width:5px;height:5px;border-radius:50%;background:var(--accent);opacity:0.5;"></span>
81
+ Notes and updates from agents on each task
82
+ </li>
83
+ </ul>
84
+ </div>
85
+
86
+ <div class="doc-section">
87
+ <h2 class="section-title">Creating Tasks</h2>
88
+ <p class="section-desc">Tasks are created automatically when you send a request through the app or iMessage. You can also create tasks directly on the board if you prefer. Either way, AIVA picks them up and routes them to the right agent.</p>
89
+ <div class="callout">
90
+ <strong>Tip:</strong> You do not need to follow up on tasks unless it has been too long. If you submitted a request, it is on the board and being tracked.
91
+ </div>
92
+ </div>
93
+
94
+ <div class="docs-nav-footer">
95
+ <a href="/getting-started/imessage" class="nav-link prev">
96
+ <span class="nav-label">Previous</span>
97
+ <span class="nav-title">iMessage &amp; Outreach</span>
98
+ </a>
99
+ <a href="/getting-started/tips" class="nav-link next">
100
+ <span class="nav-label">Next</span>
101
+ <span class="nav-title">Pro Tips</span>
102
+ </a>
103
+ </div>
104
+
105
+ </div>
106
+ </main>
107
+
108
+ <script>
109
+ (function(){
110
+ var btn=document.getElementById('hamburgerBtn'),
111
+ sidebar=document.getElementById('sidebar'),
112
+ overlay=document.getElementById('mobileOverlay');
113
+ function toggle(){
114
+ var open=sidebar.classList.toggle('open');
115
+ overlay.classList.toggle('open',open);
116
+ btn.classList.toggle('open',open);
117
+ }
118
+ btn.addEventListener('click',toggle);
119
+ overlay.addEventListener('click',toggle);
120
+ })();
121
+ </script>
122
+ </body>
123
+ </html>