@peonai/swarm 0.1.0

package/docs/style.css

@@ -0,0 +1,418 @@
+:root {
+  --bg: #0a0a0f;
+  --bg2: #12121a;
+  --surface: #1a1a25;
+  --border: #2a2a3a;
+  --text: #e8e8ed;
+  --text2: #9898a8;
+  --amber: #f0a830;
+  --amber2: #d4922a;
+  --amber-glow: rgba(240,168,48,0.15);
+  --green: #34d399;
+  --blue: #60a5fa;
+  --red: #f87171;
+  --font: 'Inter', -apple-system, sans-serif;
+  --mono: 'JetBrains Mono', monospace;
+}
+
+*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+
+html { scroll-behavior: smooth; }
+
+body {
+  font-family: var(--font);
+  background: var(--bg);
+  color: var(--text);
+  line-height: 1.6;
+  -webkit-font-smoothing: antialiased;
+}
+
+.container { max-width: 1100px; margin: 0 auto; padding: 0 24px; }
+
+a { color: var(--amber); text-decoration: none; }
+a:hover { color: var(--amber2); }
+
+/* Nav */
+.nav {
+  position: fixed; top: 0; left: 0; right: 0; z-index: 100;
+  background: rgba(10,10,15,0.85);
+  backdrop-filter: blur(12px);
+  border-bottom: 1px solid var(--border);
+}
+.nav-inner {
+  max-width: 1100px; margin: 0 auto; padding: 0 24px;
+  display: flex; align-items: center; justify-content: space-between; height: 60px;
+}
+.nav-logo {
+  display: flex; align-items: center; gap: 10px;
+  color: var(--text); font-weight: 600; font-size: 1.1rem;
+}
+.nav-logo svg { color: var(--amber); }
+.nav-links { display: flex; align-items: center; gap: 28px; }
+.nav-links a { color: var(--text2); font-size: 0.9rem; transition: color 0.2s; }
+.nav-links a:hover { color: var(--text); }
+.nav-cta {
+  background: var(--amber); color: var(--bg) !important; padding: 6px 16px;
+  border-radius: 6px; font-weight: 600; font-size: 0.85rem;
+}
+.nav-cta:hover { background: var(--amber2); }
+
+/* Hero */
+.hero {
+  position: relative; min-height: 100vh; display: flex; align-items: center;
+  justify-content: center; overflow: hidden; padding-top: 60px;
+}
+#hexCanvas {
+  position: absolute; inset: 0; width: 100%; height: 100%; opacity: 0.4;
+}
+.hero-content {
+  position: relative; z-index: 1; text-align: center; max-width: 700px; padding: 0 24px;
+}
+.hero-eyebrow {
+  font-size: 0.85rem; text-transform: uppercase; letter-spacing: 3px;
+  color: var(--amber); margin-bottom: 20px; font-weight: 500;
+}
+.hero h1 {
+  font-size: clamp(2.4rem, 6vw, 4rem); font-weight: 700; line-height: 1.15;
+  margin-bottom: 24px;
+  background: linear-gradient(135deg, var(--text) 0%, var(--amber) 100%);
+  -webkit-background-clip: text; -webkit-text-fill-color: transparent;
+  background-clip: text;
+}
+.hero-sub { font-size: 1.15rem; color: var(--text2); max-width: 540px; margin: 0 auto 36px; }
+.hero-actions { display: flex; gap: 16px; justify-content: center; }
+.hero-code {
+  background: rgba(240,168,48,0.08); border: 1px solid rgba(240,168,48,0.2);
+  border-radius: 8px; padding: 14px 28px; font-family: var(--mono); font-size: 1.1rem;
+  color: var(--amber); margin: 0 auto 28px; width: fit-content;
+}
+.hero-code code { background: none; padding: 0; }
+
+.btn {
+  display: inline-flex; align-items: center; padding: 12px 28px;
+  border-radius: 8px; font-weight: 600; font-size: 0.95rem; transition: all 0.2s;
+}
+.btn-primary { background: var(--amber); color: var(--bg); }
+.btn-primary:hover { background: var(--amber2); transform: translateY(-1px); box-shadow: 0 8px 30px var(--amber-glow); }
+.btn-ghost { border: 1px solid var(--border); color: var(--text); }
+.btn-ghost:hover { border-color: var(--amber); color: var(--amber); }
+
+/* Sections */
+.section { padding: 120px 0; }
+.section-label {
+  font-size: 0.8rem; text-transform: uppercase; letter-spacing: 3px;
+  color: var(--amber); margin-bottom: 16px; font-weight: 500;
+}
+.section h2 { font-size: clamp(1.8rem, 4vw, 2.6rem); font-weight: 700; margin-bottom: 20px; line-height: 1.2; }
+.section-desc { font-size: 1.1rem; color: var(--text2); max-width: 640px; margin-bottom: 48px; }
+
+/* Problem */
+.section-problem { background: var(--bg2); }
+.silo-grid { display: grid; grid-template-columns: repeat(4, 1fr); gap: 20px; }
+.silo-card {
+  background: var(--surface); border: 1px solid var(--border); border-radius: 12px;
+  padding: 32px 24px; text-align: center; transition: transform 0.3s, border-color 0.3s;
+}
+.silo-card:hover { transform: translateY(-4px); }
+.silo-card h3 { font-size: 1rem; margin: 16px 0 8px; }
+.silo-card p { font-size: 0.9rem; color: var(--text2); font-style: italic; }
+.silo-card-accent { border-color: var(--amber); background: linear-gradient(135deg, var(--surface), rgba(240,168,48,0.08)); }
+.silo-card-accent p { color: var(--amber); font-style: normal; font-weight: 500; }
+.silo-icon { color: var(--text2); }
+.silo-card-accent .silo-icon { color: var(--amber); }
+
+/* Features */
+.feature-grid { display: grid; grid-template-columns: repeat(3, 1fr); gap: 24px; margin-top: 48px; }
+.feature-card {
+  background: var(--surface); border: 1px solid var(--border); border-radius: 12px;
+  padding: 28px; transition: transform 0.3s, border-color 0.3s;
+}
+.feature-card:hover { transform: translateY(-4px); border-color: rgba(240,168,48,0.3); }
+.feature-icon { margin-bottom: 16px; }
+.feature-card h3 { font-size: 1.05rem; margin-bottom: 8px; }
+.feature-card p { font-size: 0.9rem; color: var(--text2); }
+
+/* CTA */
+.section-cta { padding: 100px 0; background: linear-gradient(180deg, var(--bg) 0%, var(--bg2) 100%); }
+
+/* Steps */
+.steps { display: grid; grid-template-columns: repeat(3, 1fr); gap: 40px; margin-top: 48px; }
+.step { position: relative; }
+.step-num {
+  font-size: 3rem; font-weight: 700; color: var(--amber); opacity: 0.3;
+  line-height: 1; margin-bottom: 16px;
+}
+.step-line {
+  width: 40px; height: 2px; background: var(--amber); margin-bottom: 16px; opacity: 0.5;
+}
+.step h3 { font-size: 1.2rem; margin-bottom: 10px; }
+.step p { color: var(--text2); font-size: 0.95rem; }
+
+/* Architecture */
+.section-arch { background: var(--bg2); }
+.arch-diagram { text-align: center; margin-top: 48px; }
+.arch-agents { display: flex; justify-content: center; gap: 24px; margin-bottom: 32px; }
+.arch-node {
+  background: var(--surface); border: 1px solid var(--border); border-radius: 8px;
+  padding: 12px 24px; font-size: 0.9rem; font-weight: 500;
+}
+.arch-lines { height: 60px; max-width: 400px; margin: 0 auto; }
+.arch-lines svg { width: 100%; height: 100%; }
+.arch-center { margin-bottom: 24px; }
+.arch-server {
+  display: inline-block; background: linear-gradient(135deg, var(--amber), var(--amber2));
+  color: var(--bg); padding: 20px 40px; border-radius: 12px;
+  font-weight: 700; font-size: 1.1rem;
+  box-shadow: 0 12px 40px var(--amber-glow);
+}
+.arch-server span { display: block; font-size: 0.8rem; font-weight: 400; opacity: 0.8; margin-top: 4px; }
+.arch-layers { display: flex; justify-content: center; gap: 12px; margin-top: 24px; }
+.arch-layer {
+  background: var(--surface); border: 1px solid var(--border); border-radius: 6px;
+  padding: 8px 18px; font-size: 0.8rem; color: var(--text2);
+}
+
+/* Integration */
+.section-integration { background: var(--bg); }
+.integration-grid { display: grid; grid-template-columns: repeat(2, 1fr); gap: 20px; }
+.integration-card {
+  background: var(--surface); border: 1px solid var(--border); border-radius: 12px; padding: 28px;
+}
+.integration-card h3 { font-size: 1.05rem; margin-bottom: 8px; color: var(--amber); }
+.integration-card p { font-size: 0.9rem; color: var(--text2); margin-bottom: 12px; }
+.integration-card pre {
+  background: var(--bg); border: 1px solid var(--border); border-radius: 8px;
+  padding: 12px 16px; overflow-x: auto;
+}
+.integration-card code { font-family: var(--mono); font-size: 0.82rem; color: var(--green); }
+
+/* Profile */
+.section-profile { background: var(--bg2); }
+.profile-demo { display: grid; grid-template-columns: 1fr 1fr; gap: 40px; margin-top: 48px; }
+.profile-layer {
+  background: var(--surface); border: 1px solid var(--border); border-radius: 10px;
+  margin-bottom: 16px; overflow: hidden;
+}
+.layer-header {
+  padding: 10px 16px; font-family: var(--mono); font-size: 0.85rem; font-weight: 500;
+  background: rgba(240,168,48,0.08); border-bottom: 1px solid var(--border); color: var(--amber);
+}
+.ttl-badge {
+  font-size: 0.7rem; background: rgba(248,113,113,0.15); color: var(--red);
+  padding: 2px 8px; border-radius: 4px; margin-left: 8px;
+}
+.layer-body { padding: 12px 16px; }
+.layer-field {
+  display: flex; align-items: center; gap: 12px; padding: 6px 0;
+  font-size: 0.85rem; border-bottom: 1px solid rgba(42,42,58,0.5);
+}
+.layer-field:last-child { border-bottom: none; }
+.field-key { font-family: var(--mono); color: var(--blue); min-width: 100px; }
+.field-val { font-family: var(--mono); color: var(--green); flex: 1; }
+.field-meta { font-size: 0.75rem; color: var(--text2); }
+.profile-info h3 { font-size: 1rem; margin: 20px 0 6px; color: var(--text); }
+.profile-info h3:first-child { margin-top: 0; }
+.profile-info p { font-size: 0.9rem; color: var(--text2); }
+
+/* API */
+.api-table-wrap { overflow-x: auto; margin-top: 40px; }
+.api-table { width: 100%; border-collapse: collapse; }
+.api-table th {
+  text-align: left; padding: 12px 16px; font-size: 0.8rem; text-transform: uppercase;
+  letter-spacing: 1px; color: var(--text2); border-bottom: 2px solid var(--border);
+}
+.api-table td { padding: 14px 16px; border-bottom: 1px solid var(--border); font-size: 0.9rem; }
+.method {
+  font-family: var(--mono); font-size: 0.75rem; font-weight: 600; padding: 3px 8px;
+  border-radius: 4px;
+}
+.method.get { background: rgba(96,165,250,0.15); color: var(--blue); }
+.method.post { background: rgba(52,211,153,0.15); color: var(--green); }
+.method.patch { background: rgba(240,168,48,0.15); color: var(--amber); }
+.api-example {
+  margin-top: 32px; background: var(--surface); border: 1px solid var(--border); border-radius: 12px; overflow: hidden;
+}
+.api-example-header {
+  padding: 12px 20px; font-size: 0.85rem; font-weight: 500;
+  background: rgba(240,168,48,0.06); border-bottom: 1px solid var(--border);
+}
+.api-example pre { padding: 20px; overflow-x: auto; }
+.api-example code { font-family: var(--mono); font-size: 0.82rem; color: var(--text); }
+
+/* Quickstart */
+.section-start { background: var(--bg2); }
+.start-steps { margin-top: 48px; }
+.start-step {
+  display: flex; gap: 24px; margin-bottom: 32px; align-items: flex-start;
+}
+.start-step-num {
+  width: 40px; height: 40px; border-radius: 50%; flex-shrink: 0;
+  background: var(--amber); color: var(--bg); display: flex; align-items: center;
+  justify-content: center; font-weight: 700; font-size: 1rem;
+}
+.start-step-content { flex: 1; }
+.start-step-content h3 { font-size: 1.05rem; margin-bottom: 12px; }
+.start-step-content pre {
+  background: var(--bg); border: 1px solid var(--border); border-radius: 8px;
+  padding: 16px 20px; overflow-x: auto;
+}
+.start-step-content code { font-family: var(--mono); font-size: 0.82rem; color: var(--green); }
+
+/* Footer */
+.footer { padding: 48px 0; border-top: 1px solid var(--border); }
+.footer-inner { display: flex; align-items: center; justify-content: space-between; flex-wrap: wrap; gap: 16px; }
+.footer-brand { display: flex; align-items: center; gap: 8px; color: var(--text2); font-weight: 500; }
+.footer-brand svg { color: var(--amber); }
+.footer-links { display: flex; gap: 24px; }
+.footer-links a { color: var(--text2); font-size: 0.9rem; }
+.footer-links a:hover { color: var(--amber); }
+.footer-copy { color: var(--text2); font-size: 0.8rem; }
+
+/* ===== Animations ===== */
+
+/* Hero entrance */
+.hero-content { opacity: 0; animation: heroIn 1s ease-out 0.3s forwards; }
+@keyframes heroIn {
+  from { opacity: 0; transform: translateY(30px); }
+  to { opacity: 1; transform: translateY(0); }
+}
+.hero-eyebrow { opacity: 0; animation: fadeSlideUp 0.6s ease-out 0.5s forwards; }
+.hero h1 { opacity: 0; animation: fadeSlideUp 0.8s ease-out 0.7s forwards; }
+.hero-sub { opacity: 0; animation: fadeSlideUp 0.6s ease-out 1s forwards; }
+.hero-actions { opacity: 0; animation: fadeSlideUp 0.6s ease-out 1.2s forwards; }
+
+@keyframes fadeSlideUp {
+  from { opacity: 0; transform: translateY(20px); }
+  to { opacity: 1; transform: translateY(0); }
+}
+
+/* Accent card glow pulse */
+.silo-card-accent { animation: glowPulse 3s ease-in-out infinite; }
+@keyframes glowPulse {
+  0%, 100% { box-shadow: 0 0 20px rgba(240,168,48,0.1); }
+  50% { box-shadow: 0 0 40px rgba(240,168,48,0.25), 0 0 80px rgba(240,168,48,0.08); }
+}
+
+/* Staggered children reveal */
+.section .stagger { opacity: 0; transform: translateY(24px); transition: opacity 0.5s ease-out, transform 0.5s ease-out; }
+.section.visible .stagger { opacity: 1; transform: translateY(0); }
+.section.visible .stagger:nth-child(1) { transition-delay: 0.1s; }
+.section.visible .stagger:nth-child(2) { transition-delay: 0.2s; }
+.section.visible .stagger:nth-child(3) { transition-delay: 0.3s; }
+.section.visible .stagger:nth-child(4) { transition-delay: 0.4s; }
+.section.visible .stagger:nth-child(5) { transition-delay: 0.5s; }
+.section.visible .stagger:nth-child(6) { transition-delay: 0.6s; }
+
+/* Step line grow */
+.step-line { width: 0; transition: width 0.8s ease-out; }
+.section.visible .step .step-line { width: 40px; }
+.section.visible .step:nth-child(1) .step-line { transition-delay: 0.2s; }
+.section.visible .step:nth-child(2) .step-line { transition-delay: 0.4s; }
+.section.visible .step:nth-child(3) .step-line { transition-delay: 0.6s; }
+
+/* Feature card hover glow */
+.feature-card { position: relative; overflow: hidden; }
+.feature-card::after {
+  content: ''; position: absolute; inset: 0; border-radius: 12px;
+  background: radial-gradient(circle at var(--mx, 50%) var(--my, 50%), rgba(240,168,48,0.08) 0%, transparent 60%);
+  opacity: 0; transition: opacity 0.3s;
+}
+.feature-card:hover::after { opacity: 1; }
+
+/* Arch server pulse */
+.arch-server { animation: serverGlow 4s ease-in-out infinite; }
+@keyframes serverGlow {
+  0%, 100% { box-shadow: 0 12px 40px rgba(240,168,48,0.15); }
+  50% { box-shadow: 0 16px 60px rgba(240,168,48,0.35); }
+}
+
+/* Arch node hover */
+.arch-node { transition: transform 0.3s, border-color 0.3s, box-shadow 0.3s; }
+.arch-node:hover {
+  transform: translateY(-3px); border-color: var(--amber);
+  box-shadow: 0 4px 20px rgba(240,168,48,0.1);
+}
+
+/* Data flow dots on arch lines */
+@keyframes flowDot {
+  0% { offset-distance: 0%; opacity: 0; }
+  10% { opacity: 1; }
+  90% { opacity: 1; }
+  100% { offset-distance: 100%; opacity: 0; }
+}
+
+/* Nav slide in */
+.nav { animation: navSlide 0.5s ease-out; }
+@keyframes navSlide {
+  from { transform: translateY(-100%); }
+  to { transform: translateY(0); }
+}
+
+/* Floating particles */
+.particle {
+  position: absolute; width: 3px; height: 3px; border-radius: 50%;
+  background: var(--amber); opacity: 0; z-index: 0;
+  animation: particleFloat linear infinite;
+}
+@keyframes particleFloat {
+  0% { opacity: 0; transform: translateY(0) scale(0); }
+  15% { opacity: 0.6; transform: scale(1); }
+  85% { opacity: 0.3; }
+  100% { opacity: 0; transform: translateY(-120px) scale(0.5); }
+}
+
+/* Scroll animations */
+.section { opacity: 0; transform: translateY(30px); transition: opacity 0.6s ease-out, transform 0.6s ease-out; }
+.section.visible { opacity: 1; transform: translateY(0); }
+
+/* Responsive */
+@media (max-width: 768px) {
+  .nav-links a:not(.nav-cta) { display: none; }
+  .silo-grid { grid-template-columns: repeat(2, 1fr); }
+  .steps { grid-template-columns: 1fr; gap: 32px; }
+  .arch-agents { flex-wrap: wrap; }
+  .integration-grid { grid-template-columns: 1fr; }
+  .profile-demo { grid-template-columns: 1fr; }
+  .arch-layers { flex-wrap: wrap; }
+  .feature-grid { grid-template-columns: 1fr; }
+  .section { padding: 80px 0; }
+  .docs-sidebar { display: none; }
+  .docs-main { margin-left: 0; }
+}
+
+/* Docs page layout */
+.docs-page { padding-top: 60px; }
+.docs-layout { display: flex; min-height: calc(100vh - 60px); }
+.docs-sidebar {
+  position: fixed; top: 60px; left: 0; bottom: 0; width: 240px;
+  background: var(--bg2); border-right: 1px solid var(--border);
+  padding: 32px 20px; overflow-y: auto;
+}
+.sidebar-section { margin-bottom: 28px; }
+.sidebar-title {
+  font-size: 0.7rem; text-transform: uppercase; letter-spacing: 2px;
+  color: var(--text2); margin-bottom: 10px; font-weight: 600;
+}
+.docs-sidebar a {
+  display: block; padding: 5px 0; font-size: 0.88rem; color: var(--text2); transition: color 0.2s;
+}
+.docs-sidebar a:hover { color: var(--amber); }
+.docs-main {
+  margin-left: 240px; flex: 1; padding: 48px 56px; max-width: 860px;
+}
+.doc-section { margin-bottom: 72px; }
+.doc-section h1 { font-size: 2rem; margin-bottom: 12px; }
+.doc-section h2 { font-size: 1.3rem; margin: 36px 0 12px; color: var(--text); }
+.doc-section p { color: var(--text2); margin-bottom: 16px; line-height: 1.7; }
+.doc-section ul { color: var(--text2); margin: 0 0 16px 20px; }
+.doc-section li { margin-bottom: 6px; }
+.doc-section pre {
+  background: var(--surface); border: 1px solid var(--border); border-radius: 8px;
+  padding: 16px 20px; overflow-x: auto; margin-bottom: 20px;
+}
+.doc-section code { font-family: var(--mono); font-size: 0.85rem; }
+.doc-section p code {
+  background: var(--surface); padding: 2px 6px; border-radius: 4px; font-size: 0.82rem;
+}
+.doc-section pre code { color: var(--green); }
+.method.delete { background: rgba(248,113,113,0.15); color: var(--red); }

package/lib/auth.ts

@@ -0,0 +1,63 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { jwtVerify } from 'jose';
+import { getAgentByKey } from './schema';
+
+const JWT_SECRET = new TextEncoder().encode(process.env.SWARM_JWT_SECRET || 'swarm-dev-secret');
+
+async function verifyJwt(token: string): Promise<{ userId: string } | null> {
+  try {
+    const { payload } = await jwtVerify(token, JWT_SECRET);
+    return payload.userId ? { userId: payload.userId as string } : null;
+  } catch { return null; }
+}
+
+export function withAuth(handler: (req: NextRequest, agent: { id: string; userId: string; permissions: string }) => Promise<NextResponse>) {
+  return async (req: NextRequest) => {
+    const key = req.headers.get('authorization')?.replace('Bearer ', '');
+    if (!key) return NextResponse.json({ error: 'Missing API key' }, { status: 401 });
+    const agent = await getAgentByKey(key);
+    if (!agent) return NextResponse.json({ error: 'Invalid API key' }, { status: 401 });
+    return handler(req, agent);
+  };
+}
+
+export function withAdmin(handler: (req: NextRequest, userId: string) => Promise<NextResponse>) {
+  return async (req: NextRequest) => {
+    // Accept admin token OR JWT from admin user
+    const token = req.headers.get('x-admin-token') || req.nextUrl.searchParams.get('token');
+    if (token === (process.env.SWARM_ADMIN_TOKEN || 'swarm-admin-dev')) {
+      const { ensureDefaultUser } = await import('./schema');
+      return handler(req, await ensureDefaultUser());
+    }
+    const jwt = req.headers.get('authorization')?.replace('Bearer ', '');
+    if (jwt) {
+      const payload = await verifyJwt(jwt);
+      if (payload?.userId) return handler(req, payload.userId);
+    }
+    return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
+  };
+}
+
+export { initSchema } from './schema';
+
+export function withAuthOrAdmin(handler: (req: NextRequest, agent: { id: string; userId: string; permissions: string }) => Promise<NextResponse>) {
+  return async (req: NextRequest) => {
+    // Try agent API key first
+    const key = req.headers.get('authorization')?.replace('Bearer ', '');
+    if (key) {
+      const agent = await getAgentByKey(key);
+      if (agent) return handler(req, agent);
+      // Try JWT
+      const payload = await verifyJwt(key);
+      if (payload?.userId) return handler(req, { id: 'admin', userId: payload.userId, permissions: 'read,write' });
+    }
+    // Try admin token
+    const token = req.headers.get('x-admin-token') || req.nextUrl.searchParams.get('token');
+    if (token === (process.env.SWARM_ADMIN_TOKEN || 'swarm-admin-dev')) {
+      const { ensureDefaultUser } = await import('./schema');
+      const userId = await ensureDefaultUser();
+      return handler(req, { id: 'admin', userId, permissions: 'read,write' });
+    }
+    return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
+  };
+}

package/lib/db.ts

@@ -0,0 +1,63 @@
+/* db.ts — dual backend: SQLite (dev) / PostgreSQL (prod)
+   All methods return Promises for uniform async interface */
+import { mkdirSync } from 'fs';
+import { join, dirname } from 'path';
+
+const DATABASE_URL = process.env.DATABASE_URL;
+
+export interface Stmt {
+  run(...p: any[]): Promise<any>;
+  get(...p: any[]): Promise<any>;
+  all(...p: any[]): Promise<any[]>;
+}
+
+export interface DB {
+  exec(sql: string): Promise<void>;
+  prepare(sql: string): Stmt;
+}
+
+let db: DB;
+
+if (DATABASE_URL) {
+  /* ── PostgreSQL ── */
+  // eslint-disable-next-line @typescript-eslint/no-require-imports
+  const { Pool } = require('pg');
+  const pool = new Pool({ connectionString: DATABASE_URL });
+
+  db = {
+    async exec(sql: string) { await pool.query(sql); },
+    prepare(sql: string) {
+      let idx = 0;
+      const pgSql = sql.replace(/\?/g, () => `$${++idx}`);
+      return {
+        async run(...params: any[]) { return pool.query(pgSql, params); },
+        async get(...params: any[]) { const r = await pool.query(pgSql, params); return r.rows[0] || null; },
+        async all(...params: any[]) { const r = await pool.query(pgSql, params); return r.rows; },
+      };
+    },
+  };
+} else {
+  /* ── SQLite ── */
+  // eslint-disable-next-line @typescript-eslint/no-require-imports
+  const { DatabaseSync } = require('node:sqlite');
+  const DB_PATH = process.env.SWARM_DB_PATH || join(process.cwd(), 'data/swarm.db');
+  mkdirSync(dirname(DB_PATH), { recursive: true });
+  const sqlite = new DatabaseSync(DB_PATH);
+  sqlite.exec('PRAGMA journal_mode = WAL');
+  sqlite.exec('PRAGMA foreign_keys = ON');
+
+  db = {
+    async exec(sql: string) { sqlite.exec(sql); },
+    prepare(sql: string) {
+      const stmt = sqlite.prepare(sql);
+      return {
+        async run(...p: any[]) { return stmt.run(...p); },
+        async get(...p: any[]) { return stmt.get(...p); },
+        async all(...p: any[]) { return stmt.all(...p); },
+      };
+    },
+  };
+}
+
+export default db;
+export const isPg = !!DATABASE_URL;

package/lib/embedding.ts

@@ -0,0 +1,29 @@
+/* embedding.ts — OpenAI-compatible embedding API, graceful fallback */
+const EMBED_URL = process.env.EMBED_URL || '';
+const EMBED_KEY = process.env.EMBED_KEY || '';
+const EMBED_MODEL = process.env.EMBED_MODEL || 'text-embedding-3-small';
+
+export const embeddingEnabled = !!(EMBED_URL && EMBED_KEY);
+
+export async function embed(text: string): Promise<number[]> {
+  if (!embeddingEnabled) return [];
+  const res = await fetch(EMBED_URL, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${EMBED_KEY}` },
+    body: JSON.stringify({ model: EMBED_MODEL, input: text }),
+  });
+  if (!res.ok) throw new Error(`Embedding API ${res.status}`);
+  const data = await res.json();
+  return data.data[0].embedding;
+}
+
+export function cosine(a: number[], b: number[]): number {
+  if (!a.length || !b.length) return 0;
+  let dot = 0, na = 0, nb = 0;
+  for (let i = 0; i < a.length; i++) { dot += a[i] * b[i]; na += a[i] * a[i]; nb += b[i] * b[i]; }
+  return dot / (Math.sqrt(na) * Math.sqrt(nb) || 1);
+}
+
+export function getEmbeddingConfig() {
+  return { url: EMBED_URL, model: EMBED_MODEL, enabled: embeddingEnabled };
+}