npm - @peonai/swarm - Versions diffs - 0.1.0 - Mend

@peonai/swarm 0.1.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 (61) hide show

package/.dockerignore +6 -0
package/Dockerfile +9 -0
package/README.md +29 -0
package/app/api/health/route.ts +2 -0
package/app/api/v1/admin/agents/[id]/route.ts +12 -0
package/app/api/v1/admin/agents/route.ts +31 -0
package/app/api/v1/admin/audit/route.ts +23 -0
package/app/api/v1/admin/cleanup/route.ts +21 -0
package/app/api/v1/admin/export/route.ts +15 -0
package/app/api/v1/admin/history/route.ts +23 -0
package/app/api/v1/admin/profile/route.ts +23 -0
package/app/api/v1/admin/settings/route.ts +44 -0
package/app/api/v1/auth/route.ts +5 -0
package/app/api/v1/memory/route.ts +105 -0
package/app/api/v1/persona/[agentId]/route.ts +13 -0
package/app/api/v1/persona/me/route.ts +12 -0
package/app/api/v1/profile/observe/route.ts +34 -0
package/app/api/v1/profile/route.ts +72 -0
package/app/api/v1/reflect/route.ts +96 -0
package/app/globals.css +190 -0
package/app/i18n.ts +161 -0
package/app/layout.tsx +12 -0
package/app/page.tsx +561 -0
package/docker-compose.yml +34 -0
package/docs/DEBATE-ROUND1.md +244 -0
package/docs/DEBATE-ROUND2.md +158 -0
package/docs/REQUIREMENTS.md +162 -0
package/docs/docs.html +272 -0
package/docs/index.html +228 -0
package/docs/script.js +103 -0
package/docs/style.css +418 -0
package/lib/auth.ts +63 -0
package/lib/db.ts +63 -0
package/lib/embedding.ts +29 -0
package/lib/schema.ts +134 -0
package/mcp-server.ts +56 -0
package/next-env.d.ts +6 -0
package/next.config.ts +5 -0
package/package.json +34 -0
package/packages/cli/README.md +33 -0
package/packages/cli/bin/swarm.mjs +274 -0
package/packages/cli/package.json +10 -0
package/postcss.config.mjs +2 -0
package/skill/CLAUDE.md +40 -0
package/skill/CODEX.md +43 -0
package/skill/GEMINI.md +38 -0
package/skill/IFLOW.md +38 -0
package/skill/OPENCODE.md +38 -0
package/skill/swarm-ai-skill/SKILL.md +74 -0
package/skill/swarm-ai-skill/env.sh +4 -0
package/skill/swarm-ai-skill/scripts/bootstrap.sh +21 -0
package/skill/swarm-ai-skill/scripts/env.sh +4 -0
package/skill/swarm-ai-skill/scripts/env.sh.example +3 -0
package/skill/swarm-ai-skill/scripts/memory-read.sh +8 -0
package/skill/swarm-ai-skill/scripts/memory-write.sh +10 -0
package/skill/swarm-ai-skill/scripts/observe.sh +9 -0
package/skill/swarm-ai-skill/scripts/profile-read.sh +9 -0
package/skill/swarm-ai-skill/scripts/profile-update.sh +9 -0
package/skill/swarm-ai-skill/scripts/session-start.sh +19 -0
package/tsconfig.json +21 -0
package/tsconfig.tsbuildinfo +1 -0

package/docs/docs.html ADDED Viewed

@@ -0,0 +1,272 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Documentation — Swarm AI</title>
+<link rel="preconnect" href="https://fonts.googleapis.com">
+<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
+<link rel="stylesheet" href="style.css">
+</head>
+<body class="docs-page">
+<nav class="nav">
+  <div class="nav-inner">
+    <a href="./" class="nav-logo">
+      <svg width="28" height="28" viewBox="0 0 100 100" fill="none">
+        <path d="M50 5L93.3 27.5V72.5L50 95L6.7 72.5V27.5L50 5Z" stroke="currentColor" stroke-width="4" fill="none"/>
+        <path d="M50 25L72.5 37.5V62.5L50 75L27.5 62.5V37.5L50 25Z" stroke="currentColor" stroke-width="3" fill="none" opacity="0.6"/>
+        <circle cx="50" cy="50" r="8" fill="currentColor" opacity="0.8"/>
+      </svg>
+      <span>Swarm AI</span>
+    </a>
+    <div class="nav-links">
+      <a href="#quickstart">Quick Start</a>
+      <a href="#integration">Integration</a>
+      <a href="#profile">Profile</a>
+      <a href="#memory">Memory</a>
+      <a href="#api">API</a>
+      <a href="https://github.com/euynahz/swarm-ai" class="nav-cta">GitHub</a>
+    </div>
+  </div>
+</nav>
+<div class="docs-layout">
+<aside class="docs-sidebar">
+  <div class="sidebar-section">
+    <div class="sidebar-title">Getting Started</div>
+    <a href="#quickstart">Quick Start</a>
+    <a href="#integration">Platform Integration</a>
+  </div>
+  <div class="sidebar-section">
+    <div class="sidebar-title">Concepts</div>
+    <a href="#profile">Profile Structure</a>
+    <a href="#confidence">Confidence Scoring</a>
+    <a href="#memory">Memory &amp; Search</a>
+    <a href="#reflect">Reflect</a>
+  </div>
+  <div class="sidebar-section">
+    <div class="sidebar-title">Reference</div>
+    <a href="#api">API Endpoints</a>
+    <a href="#scripts">Shell Scripts</a>
+    <a href="#admin">Admin API</a>
+    <a href="#audit">Audit &amp; History</a>
+    <a href="#auth">Authentication</a>
+    <a href="#env">Environment</a>
+  </div>
+</aside>
+<main class="docs-main">
+<section id="quickstart" class="doc-section">
+  <h1>Quick Start</h1>
+  <p>Get Swarm AI running locally in one command.</p>
+  <h2>1. Install &amp; start</h2>
+  <pre><code>npx @peonai/swarm</code></pre>
+  <p>The interactive installer will ask for port (default <code>3777</code>), admin token, and whether to install as a background service (systemd on Linux, launchd on macOS).</p>
+  <h3>Service commands</h3>
+  <pre><code>npx @peonai/swarm start    # start the server
+npx @peonai/swarm stop     # stop
+npx @peonai/swarm status   # health check
+npx @peonai/swarm uninstall # remove service (keeps data)</code></pre>
+  <p>Verify with:</p>
+  <pre><code>curl http://localhost:3777/api/health</code></pre>
+  <h3>Alternative: Manual</h3>
+  <pre><code>git clone https://github.com/euynahz/swarm-ai.git
+cd swarm-ai
+npm install
+npm run dev</code></pre>
+  <h2>2. Register an agent</h2>
+  <pre><code>curl -X POST http://localhost:3777/api/v1/admin/agents \
+  -H "X-Admin-Token: swarm-admin-dev" \
+  -H "Content-Type: application/json" \
+  -d '{"id":"my-agent","name":"My Agent"}'</code></pre>
+  <p>Save the returned <code>apiKey</code> &mdash; your agent needs it for all subsequent requests.</p>
+  <h2>3. Write and read your first profile entry</h2>
+  <pre><code># Write
+curl -X PATCH http://localhost:3777/api/v1/profile \
+  -H "Authorization: Bearer YOUR_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"layer":"identity","entries":{"name":"Alice","language":"en"}}'
+# Read
+curl http://localhost:3777/api/v1/profile \
+  -H "Authorization: Bearer YOUR_API_KEY"</code></pre>
+</section>
+<section id="integration" class="doc-section">
+  <h1>Platform Integration</h1>
+  <p>Swarm AI ships shell scripts that work with any agent platform. The key script is <code>bootstrap.sh</code>, which reads the user profile and outputs it as context text for injection into agent sessions.</p>
+  <h2>OpenClaw</h2>
+  <p>Add to your <code>AGENTS.md</code> under the "Every Session" checklist:</p>
+  <pre><code>Run `bash ~/.openclaw/workspace/skills/swarm-ai-skill/scripts/bootstrap.sh` to load user profile context</code></pre>
+  <h2>Claude Code</h2>
+  <p>Add to your project's <code>CLAUDE.md</code>:</p>
+  <pre><code>At the start of every task, run:
+  bash /path/to/skills/swarm-ai-skill/scripts/bootstrap.sh
+When you learn something new about the user, run:
+  bash /path/to/skills/swarm-ai-skill/scripts/observe.sh '[{"key":"...","value":"..."}]'</code></pre>
+  <h2>Codex</h2>
+  <p>Add <code>skill/CODEX.md</code> content to your project's <code>AGENTS.md</code>.</p>
+  <h2>Gemini CLI</h2>
+  <p>Add <code>skill/GEMINI.md</code> content to your project's <code>GEMINI.md</code>.</p>
+  <h2>OpenCode</h2>
+  <p>Add <code>skill/OPENCODE.md</code> content to your agent instructions file.</p>
+  <h2>iFlow</h2>
+  <p>Add <code>skill/IFLOW.md</code> content to your workflow configuration.</p>
+  <h2>Cursor</h2>
+  <p>Add to <code>.cursorrules</code>:</p>
+  <pre><code>At session start, execute scripts/bootstrap.sh and use the output as user context.</code></pre>
+  <h2>Any other platform</h2>
+  <p>If your agent can execute shell commands, add this to its system prompt or startup instructions:</p>
+  <pre><code>Run `scripts/bootstrap.sh` and use the output as user context for personalization.</code></pre>
+  <h2>Configuration</h2>
+  <p>Copy <code>scripts/env.sh.example</code> to <code>scripts/env.sh</code> and set your API key:</p>
+  <pre><code>export SWARM_API_URL="http://localhost:3777"
+export SWARM_API_KEY="swarm_your_key_here"</code></pre>
+</section>
+<section id="profile" class="doc-section">
+  <h1>Profile Structure</h1>
+  <p>Profiles are organized into <strong>layers</strong> &mdash; free-form namespaces that group related knowledge.</p>
+  <div class="profile-demo">
+    <div class="profile-layers">
+      <div class="profile-layer"><div class="layer-header">identity</div><div class="layer-body"><div class="layer-field"><span class="field-key">name</span><span class="field-val">"Alice Chen"</span><span class="field-meta">confidence: 1.0</span></div><div class="layer-field"><span class="field-key">timezone</span><span class="field-val">"Asia/Shanghai"</span><span class="field-meta">confidence: 1.0</span></div></div></div>
+      <div class="profile-layer"><div class="layer-header">work</div><div class="layer-body"><div class="layer-field"><span class="field-key">tech_stack</span><span class="field-val">["TypeScript", "React"]</span><span class="field-meta">tags: dev</span></div><div class="layer-field"><span class="field-key">role</span><span class="field-val">"founder"</span><span class="field-meta">confidence: 0.9</span></div></div></div>
+      <div class="profile-layer"><div class="layer-header">context <span class="ttl-badge">24h TTL</span></div><div class="layer-body"><div class="layer-field"><span class="field-key">current_task</span><span class="field-val">"building swarm-ai"</span><span class="field-meta">auto-expires</span></div></div></div>
+    </div>
+  </div>
+  <h2 id="confidence">Confidence Scoring</h2>
+  <p>Every observation carries a <code>confidence</code> value between 0 and 1. When an agent submits an observation via the <code>/observe</code> endpoint:</p>
+  <ul>
+    <li>If the new confidence is <strong>higher</strong> than the existing value, the observation overwrites it.</li>
+    <li>If the new confidence is <strong>lower or equal</strong>, the existing value is preserved.</li>
+  </ul>
+  <p>This ensures that confirmed facts (confidence 1.0) are never overwritten by guesses (confidence 0.3), regardless of which agent submits them.</p>
+  <h2>Tags and Filtering</h2>
+  <p>Each profile entry can carry tags for categorization. Query by layer or tag:</p>
+  <pre><code># Filter by layer
+curl "http://localhost:3777/api/v1/profile?layer=work" -H "Authorization: Bearer $KEY"
+# Filter by tag
+curl "http://localhost:3777/api/v1/profile?tag=preference" -H "Authorization: Bearer $KEY"</code></pre>
+  <h2>Automatic Expiry</h2>
+  <p>Observations submitted to the <code>context</code> layer via <code>/observe</code> receive a default 24-hour TTL. Expired entries are automatically excluded from query results. Permanent layers like <code>identity</code> and <code>work</code> have no expiry.</p>
+</section>
+<section id="api" class="doc-section">
+  <h1>API Reference</h1>
+  <p>All agent endpoints require an <code>Authorization: Bearer &lt;api_key&gt;</code> header.</p>
+  <div class="api-table-wrap">
+    <table class="api-table">
+      <thead><tr><th>Method</th><th>Endpoint</th><th>Description</th></tr></thead>
+      <tbody>
+        <tr><td><span class="method get">GET</span></td><td>/api/v1/profile</td><td>Read profile. Query params: <code>layer</code>, <code>tag</code></td></tr>
+        <tr><td><span class="method patch">PATCH</span></td><td>/api/v1/profile</td><td>Update entries. Body: <code>{"layer":"...","entries":{...}}</code></td></tr>
+        <tr><td><span class="method post">POST</span></td><td>/api/v1/profile/observe</td><td>Submit observations with confidence merging</td></tr>
+        <tr><td><span class="method get">GET</span></td><td>/api/v1/memory</td><td>Search memory. Params: <code>q</code>, <code>mode=semantic</code>, <code>tag</code>, <code>type</code>, <code>limit</code></td></tr>
+        <tr><td><span class="method post">POST</span></td><td>/api/v1/memory</td><td>Write memory (auto-embeds). Body: <code>{"content":"...","tags":[...],"type":"..."}</code></td></tr>
+        <tr><td><span class="method post">POST</span></td><td>/api/v1/reflect</td><td>Trigger memory→profile reflection. Body: <code>{"since":"ISO","limit":100}</code></td></tr>
+        <tr><td><span class="method get">GET</span></td><td>/api/v1/persona/me</td><td>Read current agent persona</td></tr>
+        <tr><td><span class="method get">GET</span></td><td>/api/v1/persona/:agentId</td><td>Read another agent's persona</td></tr>
+      </tbody>
+    </table>
+  </div>
+  <h2>Observe Example</h2>
+  <div class="api-example">
+    <div class="api-example-header">POST /api/v1/profile/observe</div>
+    <pre><code>curl -X POST http://localhost:3777/api/v1/profile/observe \
+  -H "Authorization: Bearer $API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "observations": [{
+      "layer": "work",
+      "key": "tech_stack",
+      "value": ["TypeScript", "React", "Next.js"],
+      "confidence": 0.9,
+      "tags": ["dev", "skills"]
+    }]
+  }'</code></pre>
+  </div>
+</section>
+<section id="scripts" class="doc-section">
+  <h1>Shell Scripts</h1>
+  <p>Located in <code>skill/swarm-ai-skill/scripts/</code>. All scripts source <code>env.sh</code> for configuration.</p>
+  <div class="api-table-wrap">
+    <table class="api-table">
+      <thead><tr><th>Script</th><th>Usage</th><th>When to Use</th></tr></thead>
+      <tbody>
+        <tr><td><code>bootstrap.sh</code></td><td>No args</td><td>Session start &mdash; outputs profile as context text</td></tr>
+        <tr><td><code>profile-read.sh</code></td><td><code>[layer] [tag]</code></td><td>Query specific profile data</td></tr>
+        <tr><td><code>profile-update.sh</code></td><td><code>&lt;layer&gt; &lt;json&gt;</code></td><td>Confirmed new user information</td></tr>
+        <tr><td><code>observe.sh</code></td><td><code>&lt;json_array&gt;</code></td><td>Discovered preferences or habits</td></tr>
+        <tr><td><code>memory-read.sh</code></td><td><code>[query]</code></td><td>Search historical context</td></tr>
+        <tr><td><code>memory-write.sh</code></td><td><code>&lt;content&gt; [tags]</code></td><td>Record significant events</td></tr>
+      </tbody>
+    </table>
+  </div>
+</section>
+<section id="admin" class="doc-section">
+  <h1>Admin API</h1>
+  <p>Admin endpoints require an <code>X-Admin-Token</code> header or JWT <code>Authorization: Bearer &lt;jwt&gt;</code>.</p>
+  <div class="api-table-wrap">
+    <table class="api-table">
+      <thead><tr><th>Method</th><th>Endpoint</th><th>Description</th></tr></thead>
+      <tbody>
+        <tr><td><span class="method get">GET</span></td><td>/api/v1/admin/agents</td><td>List all agents</td></tr>
+        <tr><td><span class="method post">POST</span></td><td>/api/v1/admin/agents</td><td>Create agent. Body: <code>{"id":"...","name":"..."}</code></td></tr>
+        <tr><td><span class="method patch">PATCH</span></td><td>/api/v1/admin/agents</td><td>Update agent persona/name</td></tr>
+        <tr><td><span class="method delete">DELETE</span></td><td>/api/v1/admin/agents/:id</td><td>Delete agent and revoke API key</td></tr>
+        <tr><td><span class="method get">GET</span></td><td>/api/v1/admin/profile</td><td>View all raw profile data</td></tr>
+        <tr><td><span class="method put">PUT</span></td><td>/api/v1/admin/profile</td><td>Admin profile update</td></tr>
+        <tr><td><span class="method get">GET</span></td><td>/api/v1/admin/audit</td><td>Audit log. Params: <code>action</code>, <code>agent</code>, <code>limit</code></td></tr>
+        <tr><td><span class="method get">GET</span></td><td>/api/v1/admin/history</td><td>Profile change history. Params: <code>layer</code>, <code>key</code>, <code>limit</code></td></tr>
+        <tr><td><span class="method get">GET</span></td><td>/api/v1/admin/export</td><td>Export all data as JSON</td></tr>
+      </tbody>
+    </table>
+  </div>
+</section>
+</main>
+</div>
+<footer class="footer">
+  <div class="container footer-inner">
+    <div class="footer-brand">
+      <svg width="24" height="24" viewBox="0 0 100 100" fill="none"><path d="M50 5L93.3 27.5V72.5L50 95L6.7 72.5V27.5L50 5Z" stroke="currentColor" stroke-width="4" fill="none"/><circle cx="50" cy="50" r="8" fill="currentColor" opacity="0.6"/></svg>
+      <span>Swarm AI</span>
+    </div>
+    <div class="footer-links">
+      <a href="./">Home</a>
+      <a href="https://github.com/euynahz/swarm-ai">GitHub</a>
+    </div>
+    <p class="footer-copy">&copy; 2026 PeonAI. MIT License.</p>
+  </div>
+</footer>
+</body>
+</html>

package/docs/index.html ADDED Viewed

@@ -0,0 +1,228 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Swarm AI — Cross-Agent User Profile Hub</title>
+<meta name="description" content="Teach one agent, all agents remember. A shared profile server for AI agents across platforms.">
+<link rel="preconnect" href="https://fonts.googleapis.com">
+<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
+<link rel="stylesheet" href="style.css">
+</head>
+<body>
+<nav class="nav">
+  <div class="nav-inner">
+    <a href="/" class="nav-logo">
+      <svg width="28" height="28" viewBox="0 0 100 100" fill="none">
+        <path d="M50 5L93.3 27.5V72.5L50 95L6.7 72.5V27.5L50 5Z" stroke="currentColor" stroke-width="4" fill="none"/>
+        <path d="M50 25L72.5 37.5V62.5L50 75L27.5 62.5V37.5L50 25Z" stroke="currentColor" stroke-width="3" fill="none" opacity="0.6"/>
+        <circle cx="50" cy="50" r="8" fill="currentColor" opacity="0.8"/>
+      </svg>
+      <span>Swarm AI</span>
+    </a>
+    <div class="nav-links">
+      <a href="#problem">Problem</a>
+      <a href="#how-it-works">How It Works</a>
+      <a href="#features">Features</a>
+      <a href="docs.html">Docs</a>
+      <a href="https://github.com/euynahz/swarm-ai" class="nav-cta">GitHub</a>
+    </div>
+  </div>
+</nav>
+<section class="hero" id="hero">
+  <canvas id="hexCanvas"></canvas>
+  <div class="hero-content">
+    <p class="hero-eyebrow">Open Source User Profile Hub</p>
+    <h1>Teach one agent.<br>All agents remember.</h1>
+    <p class="hero-sub">A shared memory layer for AI agents across every platform and device. End the cycle of repeating yourself to every new assistant.</p>
+    <pre class="hero-code"><code>npx @peonai/swarm</code></pre>
+    <div class="hero-actions">
+      <a href="docs.html#quickstart" class="btn btn-primary">Get Started</a>
+      <a href="https://github.com/euynahz/swarm-ai" class="btn btn-ghost">View Source</a>
+    </div>
+  </div>
+</section>
+<section class="section section-problem" id="problem">
+  <div class="container">
+    <div class="section-label">The Problem</div>
+    <h2>N devices, M agents, N&times;M information silos</h2>
+    <p class="section-desc">Every AI agent you use starts from zero. Your coding assistant doesn't know your design preferences. Your writing tool doesn't know your tech stack. You repeat the same context, the same corrections, the same preferences &mdash; endlessly.</p>
+    <div class="silo-grid">
+      <div class="silo-card stagger">
+        <div class="silo-icon">
+          <svg width="40" height="40" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5"><rect x="2" y="3" width="20" height="14" rx="2"/><line x1="8" y1="21" x2="16" y2="21"/><line x1="12" y1="17" x2="12" y2="21"/></svg>
+        </div>
+        <h3>Desktop Agent</h3>
+        <p>"What's your preferred language?"</p>
+      </div>
+      <div class="silo-card stagger">
+        <div class="silo-icon">
+          <svg width="40" height="40" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5"><rect x="5" y="2" width="14" height="20" rx="2"/><line x1="12" y1="18" x2="12" y2="18" stroke-linecap="round" stroke-width="2"/></svg>
+        </div>
+        <h3>Mobile Agent</h3>
+        <p>"What's your preferred language?"</p>
+      </div>
+      <div class="silo-card stagger">
+        <div class="silo-icon">
+          <svg width="40" height="40" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5"><polyline points="16 18 22 12 16 6"/><polyline points="8 6 2 12 8 18"/><line x1="14" y1="4" x2="10" y2="20"/></svg>
+        </div>
+        <h3>Code Agent</h3>
+        <p>"What's your preferred language?"</p>
+      </div>
+      <div class="silo-card silo-card-accent stagger">
+        <div class="silo-icon">
+          <svg width="40" height="40" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5"><path d="M12 2L2 7l10 5 10-5-10-5z"/><path d="M2 17l10 5 10-5"/><path d="M2 12l10 5 10-5"/></svg>
+        </div>
+        <h3>With Swarm AI</h3>
+        <p>"I already know. Let's get to work."</p>
+      </div>
+    </div>
+  </div>
+</section>
+<section class="section section-how" id="how-it-works">
+  <div class="container">
+    <div class="section-label">How It Works</div>
+    <h2>Three primitives, infinite memory</h2>
+    <div class="steps">
+      <div class="step stagger">
+        <div class="step-num">01</div>
+        <div class="step-line"></div>
+        <h3>Connect</h3>
+        <p>Register each agent with a unique API key. Each agent gets scoped read/write access to the shared profile store.</p>
+      </div>
+      <div class="step stagger">
+        <div class="step-num">02</div>
+        <div class="step-line"></div>
+        <h3>Observe</h3>
+        <p>Agents submit observations as they learn about you. Confidence scoring ensures high-quality data wins &mdash; guesses never overwrite facts.</p>
+      </div>
+      <div class="step stagger">
+        <div class="step-num">03</div>
+        <div class="step-line"></div>
+        <h3>Share</h3>
+        <p>Every agent reads the same profile at session start. What one learns, all know. Context follows you across tools and devices.</p>
+      </div>
+    </div>
+  </div>
+</section>
+<section class="section section-arch" id="architecture">
+  <div class="container">
+    <div class="section-label">Architecture</div>
+    <h2>One server, every agent</h2>
+    <div class="arch-diagram">
+      <div class="arch-agents">
+        <div class="arch-node">OpenClaw</div>
+        <div class="arch-node">Claude Code</div>
+        <div class="arch-node">Codex</div>
+        <div class="arch-node">Gemini CLI</div>
+        <div class="arch-node">OpenCode</div>
+        <div class="arch-node">Cursor</div>
+        <div class="arch-node">iFlow</div>
+      </div>
+      <div class="arch-lines">
+        <svg viewBox="0 0 400 60" preserveAspectRatio="none">
+          <path d="M50,0 L200,55" stroke="var(--amber)" stroke-width="1" opacity="0.4"/>
+          <path d="M150,0 L200,55" stroke="var(--amber)" stroke-width="1" opacity="0.4"/>
+          <path d="M250,0 L200,55" stroke="var(--amber)" stroke-width="1" opacity="0.4"/>
+          <path d="M350,0 L200,55" stroke="var(--amber)" stroke-width="1" opacity="0.4"/>
+        </svg>
+      </div>
+      <div class="arch-center">
+        <div class="arch-server">Swarm AI Server<span>Next.js + SQLite</span></div>
+      </div>
+      <div class="arch-layers">
+        <div class="arch-layer">Identity</div>
+        <div class="arch-layer">Work</div>
+        <div class="arch-layer">Communication</div>
+        <div class="arch-layer">Context</div>
+      </div>
+    </div>
+  </div>
+</section>
+<section class="section section-features" id="features">
+  <div class="container">
+    <div class="section-label">Core Capabilities</div>
+    <h2>Built for the multi-agent era</h2>
+    <div class="feature-grid">
+      <div class="feature-card stagger">
+        <div class="feature-icon">
+          <svg width="32" height="32" viewBox="0 0 24 24" fill="none" stroke="var(--amber)" stroke-width="1.5"><path d="M12 2L2 7l10 5 10-5-10-5z"/><path d="M2 17l10 5 10-5"/><path d="M2 12l10 5 10-5"/></svg>
+        </div>
+        <h3>Free-form Layers</h3>
+        <p>Organize knowledge into any namespace. Identity, work, communication, or define your own. No rigid schema.</p>
+      </div>
+      <div class="feature-card stagger">
+        <div class="feature-icon">
+          <svg width="32" height="32" viewBox="0 0 24 24" fill="none" stroke="var(--amber)" stroke-width="1.5"><path d="M22 11.08V12a10 10 0 1 1-5.93-9.14"/><polyline points="22 4 12 14.01 9 11.01"/></svg>
+        </div>
+        <h3>Confidence Scoring</h3>
+        <p>Every observation carries a confidence value. High-confidence facts are never overwritten by low-confidence guesses.</p>
+      </div>
+      <div class="feature-card stagger">
+        <div class="feature-icon">
+          <svg width="32" height="32" viewBox="0 0 24 24" fill="none" stroke="var(--amber)" stroke-width="1.5"><circle cx="12" cy="12" r="10"/><polyline points="12 6 12 12 16 14"/></svg>
+        </div>
+        <h3>Automatic Expiry</h3>
+        <p>Context-layer data expires after 24 hours by default. Stale information cleans itself up without intervention.</p>
+      </div>
+      <div class="feature-card stagger">
+        <div class="feature-icon">
+          <svg width="32" height="32" viewBox="0 0 24 24" fill="none" stroke="var(--amber)" stroke-width="1.5"><path d="M17 21v-2a4 4 0 0 0-4-4H5a4 4 0 0 0-4 4v2"/><circle cx="9" cy="7" r="4"/><path d="M23 21v-2a4 4 0 0 0-3-3.87"/><path d="M16 3.13a4 4 0 0 1 0 7.75"/></svg>
+        </div>
+        <h3>Source Attribution</h3>
+        <p>Every field records which agent wrote it. Full provenance across your entire agent ecosystem.</p>
+      </div>
+      <div class="feature-card stagger">
+        <div class="feature-icon">
+          <svg width="32" height="32" viewBox="0 0 24 24" fill="none" stroke="var(--amber)" stroke-width="1.5"><rect x="3" y="11" width="18" height="11" rx="2" ry="2"/><path d="M7 11V7a5 5 0 0 1 10 0v4"/></svg>
+        </div>
+        <h3>Per-Agent Auth</h3>
+        <p>Each agent gets a unique API key with scoped permissions. Read-only agents never modify your profile.</p>
+      </div>
+      <div class="feature-card stagger">
+        <div class="feature-icon">
+          <svg width="32" height="32" viewBox="0 0 24 24" fill="none" stroke="var(--amber)" stroke-width="1.5"><polyline points="16 18 22 12 16 6"/><polyline points="8 6 2 12 8 18"/></svg>
+        </div>
+        <h3>Zero Dependencies</h3>
+        <p>Shell scripts with curl. No SDK, no runtime, no framework lock-in. If your agent can run a command, it can join.</p>
+      </div>
+    </div>
+  </div>
+</section>
+<section class="section section-cta">
+  <div class="container" style="text-align:center">
+    <h2>Ready to unify your agents?</h2>
+    <p class="section-desc" style="margin:0 auto 36px">Self-hosted, open source, and running in under a minute.</p>
+    <pre class="hero-code" style="display:inline-block;margin:0 auto 24px;text-align:left"><code>npx @peonai/swarm</code></pre>
+    <div class="hero-actions" style="justify-content:center">
+      <a href="docs.html#quickstart" class="btn btn-primary">Read the Docs</a>
+      <a href="https://github.com/euynahz/swarm-ai" class="btn btn-ghost">View on GitHub</a>
+    </div>
+  </div>
+</section>
+<footer class="footer">
+  <div class="container footer-inner">
+    <div class="footer-brand">
+      <svg width="24" height="24" viewBox="0 0 100 100" fill="none"><path d="M50 5L93.3 27.5V72.5L50 95L6.7 72.5V27.5L50 5Z" stroke="currentColor" stroke-width="4" fill="none"/><circle cx="50" cy="50" r="8" fill="currentColor" opacity="0.6"/></svg>
+      <span>Swarm AI</span>
+    </div>
+    <div class="footer-links">
+      <a href="docs.html">Documentation</a>
+      <a href="https://github.com/euynahz/swarm-ai">GitHub</a>
+      <a href="https://github.com/euynahz/swarm-ai/issues">Issues</a>
+    </div>
+    <p class="footer-copy">&copy; 2026 PeonAI. MIT License.</p>
+  </div>
+</footer>
+<script src="script.js"></script>
+</body>
+</html>

package/docs/script.js ADDED Viewed

@@ -0,0 +1,103 @@
+// Hex canvas background
+const canvas = document.getElementById('hexCanvas');
+if (canvas) {
+  const ctx = canvas.getContext('2d');
+  let w, h, hexes = [], mouse = { x: -1, y: -1 };
+  const resize = () => { w = canvas.width = canvas.offsetWidth; h = canvas.height = canvas.offsetHeight; init(); };
+  function init() {
+    hexes = [];
+    const size = 60, gap = size * 1.8;
+    for (let x = -size; x < w + size; x += gap * 0.866) {
+      for (let y = -size; y < h + size; y += gap * 0.75) {
+        const offset = (Math.floor(y / (gap * 0.75)) % 2) * gap * 0.433;
+        hexes.push({
+          x: x + offset, y, size: size * (0.6 + Math.random() * 0.4),
+          phase: Math.random() * Math.PI * 2, speed: 0.003 + Math.random() * 0.005
+        });
+      }
+    }
+  }
+  function drawHex(cx, cy, r) {
+    ctx.beginPath();
+    for (let i = 0; i < 6; i++) {
+      const a = Math.PI / 3 * i - Math.PI / 6;
+      ctx[i ? 'lineTo' : 'moveTo'](cx + r * Math.cos(a), cy + r * Math.sin(a));
+    }
+    ctx.closePath();
+  }
+  // Mouse proximity effect
+  canvas.addEventListener('mousemove', e => { mouse.x = e.clientX; mouse.y = e.clientY; });
+  canvas.addEventListener('mouseleave', () => { mouse.x = -1; mouse.y = -1; });
+  let t = 0;
+  function draw() {
+    ctx.clearRect(0, 0, w, h);
+    t++;
+    for (const hex of hexes) {
+      let alpha = 0.06 + 0.06 * Math.sin(t * hex.speed + hex.phase);
+      // Mouse proximity boost
+      if (mouse.x > 0) {
+        const dx = hex.x - mouse.x, dy = hex.y - mouse.y;
+        const dist = Math.sqrt(dx * dx + dy * dy);
+        if (dist < 200) alpha += 0.15 * (1 - dist / 200);
+      }
+      ctx.strokeStyle = `rgba(240,168,48,${alpha})`;
+      ctx.lineWidth = 0.8;
+      drawHex(hex.x, hex.y, hex.size);
+      ctx.stroke();
+    }
+    // Connection lines
+    for (let i = 0; i < hexes.length; i++) {
+      for (let j = i + 1; j < hexes.length; j++) {
+        const dx = hexes[i].x - hexes[j].x, dy = hexes[i].y - hexes[j].y;
+        const dist = Math.sqrt(dx * dx + dy * dy);
+        if (dist < 120) {
+          const alpha = 0.03 * (1 - dist / 120) * (0.5 + 0.5 * Math.sin(t * 0.004 + i));
+          ctx.strokeStyle = `rgba(240,168,48,${alpha})`;
+          ctx.lineWidth = 0.5;
+          ctx.beginPath();
+          ctx.moveTo(hexes[i].x, hexes[i].y);
+          ctx.lineTo(hexes[j].x, hexes[j].y);
+          ctx.stroke();
+        }
+      }
+    }
+    requestAnimationFrame(draw);
+  }
+  resize();
+  window.addEventListener('resize', resize);
+  draw();
+}
+// Scroll reveal with threshold
+const observer = new IntersectionObserver(entries => {
+  entries.forEach(e => { if (e.isIntersecting) e.target.classList.add('visible'); });
+}, { threshold: 0.15 });
+document.querySelectorAll('.section').forEach(s => observer.observe(s));
+// Feature card mouse-tracking glow
+document.querySelectorAll('.feature-card').forEach(card => {
+  card.addEventListener('mousemove', e => {
+    const r = card.getBoundingClientRect();
+    card.style.setProperty('--mx', ((e.clientX - r.left) / r.width * 100) + '%');
+    card.style.setProperty('--my', ((e.clientY - r.top) / r.height * 100) + '%');
+  });
+});
+// Floating particles in hero
+const hero = document.querySelector('.hero');
+if (hero) {
+  for (let i = 0; i < 12; i++) {
+    const p = document.createElement('div');
+    p.className = 'particle';
+    p.style.cssText = `
+      left:${Math.random()*100}%;top:${Math.random()*100}%;
+      animation-delay:${Math.random()*6}s;animation-duration:${6+Math.random()*8}s;
+    `;
+    hero.appendChild(p);
+  }
+}