@hasna/microservices 0.0.18 → 0.0.20

package/dist/index.js

@@ -1,4 +1,7 @@
 // @bun
+// src/lib/installer.ts
+import { execFileSync, execSync } from "child_process";
+
 // src/lib/registry.ts
 var CATEGORIES = [
   "Identity",
@@ -20,9 +23,24 @@ var MICROSERVICES = [
     package: "@hasna/microservice-auth",
     binary: "microservice-auth",
     schemaPrefix: "auth",
-    tags: ["auth", "users", "sessions", "jwt", "oauth", "2fa", "api-keys", "magic-links"],
+    tags: [
+      "auth",
+      "users",
+      "sessions",
+      "jwt",
+      "oauth",
+      "2fa",
+      "api-keys",
+      "magic-links"
+    ],
     requiredEnv: ["DATABASE_URL", "JWT_SECRET"],
-    optionalEnv: ["GITHUB_CLIENT_ID", "GITHUB_CLIENT_SECRET", "GOOGLE_CLIENT_ID", "GOOGLE_CLIENT_SECRET", "AUTH_PORT"]
+    optionalEnv: [
+      "GITHUB_CLIENT_ID",
+      "GITHUB_CLIENT_SECRET",
+      "GOOGLE_CLIENT_ID",
+      "GOOGLE_CLIENT_SECRET",
+      "AUTH_PORT"
+    ]
   },
   {
     name: "teams",
@@ -32,7 +50,14 @@ var MICROSERVICES = [
     package: "@hasna/microservice-teams",
     binary: "microservice-teams",
     schemaPrefix: "teams",
-    tags: ["teams", "workspaces", "rbac", "invites", "permissions", "multi-tenancy"],
+    tags: [
+      "teams",
+      "workspaces",
+      "rbac",
+      "invites",
+      "permissions",
+      "multi-tenancy"
+    ],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["TEAMS_PORT"]
   },
@@ -44,7 +69,15 @@ var MICROSERVICES = [
     package: "@hasna/microservice-billing",
     binary: "microservice-billing",
     schemaPrefix: "billing",
-    tags: ["billing", "stripe", "subscriptions", "plans", "invoices", "usage", "webhooks"],
+    tags: [
+      "billing",
+      "stripe",
+      "subscriptions",
+      "plans",
+      "invoices",
+      "usage",
+      "webhooks"
+    ],
     requiredEnv: ["DATABASE_URL", "STRIPE_SECRET_KEY", "STRIPE_WEBHOOK_SECRET"],
     optionalEnv: ["BILLING_PORT"]
   },
@@ -56,9 +89,26 @@ var MICROSERVICES = [
     package: "@hasna/microservice-notify",
     binary: "microservice-notify",
     schemaPrefix: "notify",
-    tags: ["notifications", "email", "sms", "in-app", "webhooks", "templates", "sse"],
+    tags: [
+      "notifications",
+      "email",
+      "sms",
+      "in-app",
+      "webhooks",
+      "templates",
+      "sse"
+    ],
     requiredEnv: ["DATABASE_URL"],
-    optionalEnv: ["RESEND_API_KEY", "SMTP_HOST", "SMTP_PORT", "SMTP_USER", "SMTP_PASS", "TWILIO_ACCOUNT_SID", "TWILIO_AUTH_TOKEN", "NOTIFY_PORT"]
+    optionalEnv: [
+      "RESEND_API_KEY",
+      "SMTP_HOST",
+      "SMTP_PORT",
+      "SMTP_USER",
+      "SMTP_PASS",
+      "TWILIO_ACCOUNT_SID",
+      "TWILIO_AUTH_TOKEN",
+      "NOTIFY_PORT"
+    ]
   },
   {
     name: "files",
@@ -68,9 +118,24 @@ var MICROSERVICES = [
     package: "@hasna/microservice-files",
     binary: "microservice-files",
     schemaPrefix: "files",
-    tags: ["files", "uploads", "s3", "storage", "images", "presigned-urls", "cdn"],
+    tags: [
+      "files",
+      "uploads",
+      "s3",
+      "storage",
+      "images",
+      "presigned-urls",
+      "cdn"
+    ],
     requiredEnv: ["DATABASE_URL"],
-    optionalEnv: ["S3_BUCKET", "S3_REGION", "AWS_ACCESS_KEY_ID", "AWS_SECRET_ACCESS_KEY", "FILES_STORAGE", "FILES_PORT"]
+    optionalEnv: [
+      "S3_BUCKET",
+      "S3_REGION",
+      "AWS_ACCESS_KEY_ID",
+      "AWS_SECRET_ACCESS_KEY",
+      "FILES_STORAGE",
+      "FILES_PORT"
+    ]
   },
   {
     name: "audit",
@@ -92,7 +157,13 @@ var MICROSERVICES = [
     package: "@hasna/microservice-flags",
     binary: "microservice-flags",
     schemaPrefix: "flags",
-    tags: ["feature-flags", "experiments", "rollouts", "ab-testing", "targeting"],
+    tags: [
+      "feature-flags",
+      "experiments",
+      "rollouts",
+      "ab-testing",
+      "targeting"
+    ],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["FLAGS_PORT"]
   },
@@ -104,7 +175,15 @@ var MICROSERVICES = [
     package: "@hasna/microservice-jobs",
     binary: "microservice-jobs",
     schemaPrefix: "jobs",
-    tags: ["jobs", "queues", "background", "cron", "scheduling", "workers", "retry"],
+    tags: [
+      "jobs",
+      "queues",
+      "background",
+      "cron",
+      "scheduling",
+      "workers",
+      "retry"
+    ],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["JOBS_PORT", "JOBS_WORKER_CONCURRENCY"]
   },
@@ -116,9 +195,23 @@ var MICROSERVICES = [
     package: "@hasna/microservice-llm",
     binary: "microservice-llm",
     schemaPrefix: "llm",
-    tags: ["llm", "openai", "anthropic", "groq", "ai", "gateway", "cost-tracking", "rate-limiting"],
+    tags: [
+      "llm",
+      "openai",
+      "anthropic",
+      "groq",
+      "ai",
+      "gateway",
+      "cost-tracking",
+      "rate-limiting"
+    ],
     requiredEnv: ["DATABASE_URL"],
-    optionalEnv: ["OPENAI_API_KEY", "ANTHROPIC_API_KEY", "GROQ_API_KEY", "LLM_PORT"]
+    optionalEnv: [
+      "OPENAI_API_KEY",
+      "ANTHROPIC_API_KEY",
+      "GROQ_API_KEY",
+      "LLM_PORT"
+    ]
   },
   {
     name: "memory",
@@ -128,7 +221,15 @@ var MICROSERVICES = [
     package: "@hasna/microservice-memory",
     binary: "microservice-memory",
     schemaPrefix: "memory",
-    tags: ["memory", "embeddings", "pgvector", "semantic-search", "rag", "ai-agents", "recall"],
+    tags: [
+      "memory",
+      "embeddings",
+      "pgvector",
+      "semantic-search",
+      "rag",
+      "ai-agents",
+      "recall"
+    ],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["OPENAI_API_KEY", "MEMORY_PORT"]
   },
@@ -140,10 +241,38 @@ var MICROSERVICES = [
     package: "@hasna/microservice-search",
     binary: "microservice-search",
     schemaPrefix: "search",
-    tags: ["search", "full-text", "semantic", "vector", "pgvector", "hybrid", "rag"],
+    tags: [
+      "search",
+      "full-text",
+      "semantic",
+      "vector",
+      "pgvector",
+      "hybrid",
+      "rag"
+    ],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["OPENAI_API_KEY", "SEARCH_PORT"]
   },
+  {
+    name: "knowledge",
+    displayName: "Knowledge",
+    description: "RAG knowledge base: document ingestion, chunking (fixed/paragraph/sentence/recursive), embedding, and semantic/text/hybrid retrieval with source attribution.",
+    category: "AI",
+    package: "@hasna/microservice-knowledge",
+    binary: "microservice-knowledge",
+    schemaPrefix: "knowledge",
+    tags: [
+      "knowledge",
+      "rag",
+      "chunking",
+      "embeddings",
+      "retrieval",
+      "pgvector",
+      "documents"
+    ],
+    requiredEnv: ["DATABASE_URL"],
+    optionalEnv: ["OPENAI_API_KEY", "KNOWLEDGE_PORT"]
+  },
   {
     name: "usage",
     displayName: "Usage",
@@ -164,7 +293,14 @@ var MICROSERVICES = [
     package: "@hasna/microservice-webhooks",
     binary: "microservice-webhooks",
     schemaPrefix: "webhooks",
-    tags: ["webhooks", "outbound", "delivery", "retry", "signing", "integrations"],
+    tags: [
+      "webhooks",
+      "outbound",
+      "delivery",
+      "retry",
+      "signing",
+      "integrations"
+    ],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["WEBHOOKS_PORT"]
   },
@@ -191,6 +327,104 @@ var MICROSERVICES = [
     tags: ["waitlist", "referral", "invites", "launch", "growth"],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["WAITLIST_PORT"]
+  },
+  {
+    name: "sessions",
+    displayName: "Sessions",
+    description: "AI conversation history: message threads, context window management, multi-turn state, fork/pin, full-text search across messages, export as markdown/JSON.",
+    category: "AI",
+    package: "@hasna/microservice-sessions",
+    binary: "microservice-sessions",
+    schemaPrefix: "sessions",
+    tags: [
+      "sessions",
+      "conversations",
+      "chat",
+      "messages",
+      "context-window",
+      "history"
+    ],
+    requiredEnv: ["DATABASE_URL"],
+    optionalEnv: ["SESSIONS_PORT"]
+  },
+  {
+    name: "guardrails",
+    displayName: "Guardrails",
+    description: "AI safety layer: prompt injection detection, PII scanning (email/phone/SSN/CC), toxicity check, configurable per-workspace policies, violation logging.",
+    category: "AI",
+    package: "@hasna/microservice-guardrails",
+    binary: "microservice-guardrails",
+    schemaPrefix: "guardrails",
+    tags: [
+      "guardrails",
+      "safety",
+      "pii",
+      "injection",
+      "toxicity",
+      "moderation",
+      "policy"
+    ],
+    requiredEnv: ["DATABASE_URL"],
+    optionalEnv: ["GUARDRAILS_PORT"]
+  },
+  {
+    name: "traces",
+    displayName: "Traces",
+    description: "Agent observability: span-based distributed tracing for LLM calls, tool calls, and decisions. Duration, token, and cost tracking per span. Stats with percentiles.",
+    category: "Observability",
+    package: "@hasna/microservice-traces",
+    binary: "microservice-traces",
+    schemaPrefix: "traces",
+    tags: [
+      "traces",
+      "tracing",
+      "spans",
+      "observability",
+      "latency",
+      "debugging",
+      "agent-ops"
+    ],
+    requiredEnv: ["DATABASE_URL"],
+    optionalEnv: ["TRACES_PORT"]
+  },
+  {
+    name: "agents",
+    displayName: "Agents",
+    description: "Agent registry and orchestration: register agents with capabilities, health tracking via heartbeat, capability-based task routing, agent-to-agent messaging.",
+    category: "AI",
+    package: "@hasna/microservice-agents",
+    binary: "microservice-agents",
+    schemaPrefix: "agents",
+    tags: [
+      "agents",
+      "registry",
+      "orchestration",
+      "routing",
+      "multi-agent",
+      "capabilities",
+      "heartbeat"
+    ],
+    requiredEnv: ["DATABASE_URL"],
+    optionalEnv: ["AGENTS_PORT"]
+  },
+  {
+    name: "prompts",
+    displayName: "Prompts",
+    description: "Versioned prompt management: auto-incrementing versions, per-workspace/user/agent overrides, A/B experiment variants, rollback, variable interpolation, diff.",
+    category: "AI",
+    package: "@hasna/microservice-prompts",
+    binary: "microservice-prompts",
+    schemaPrefix: "prompts",
+    tags: [
+      "prompts",
+      "templates",
+      "versioning",
+      "ab-testing",
+      "overrides",
+      "rollback"
+    ],
+    requiredEnv: ["DATABASE_URL"],
+    optionalEnv: ["PROMPTS_PORT"]
   }
 ];
 function getMicroservice(name) {
@@ -204,8 +438,8 @@ function searchMicroservices(query) {
   const q = query.toLowerCase();
   return MICROSERVICES.filter((m) => m.name.includes(q) || m.displayName.toLowerCase().includes(q) || m.description.toLowerCase().includes(q) || m.category.toLowerCase().includes(q) || m.tags.some((t) => t.includes(q)));
 }
+
 // src/lib/installer.ts
-import { execSync, execFileSync } from "child_process";
 function microserviceExists(name) {
   const meta = getMicroservice(name);
   if (!meta)
@@ -222,7 +456,9 @@ function getMicroserviceVersion(name) {
   if (!meta)
     return null;
   try {
-    const out = execFileSync(meta.binary, ["--version"], { encoding: "utf8" }).trim();
+    const out = execFileSync(meta.binary, ["--version"], {
+      encoding: "utf8"
+    }).trim();
     return out || null;
   } catch {
     return null;
@@ -231,7 +467,11 @@ function getMicroserviceVersion(name) {
 function installMicroservice(name, options = {}) {
   const meta = getMicroservice(name);
   if (!meta) {
-    return { microservice: name, success: false, error: `Unknown microservice '${name}'` };
+    return {
+      microservice: name,
+      success: false,
+      error: `Unknown microservice '${name}'`
+    };
   }
   if (microserviceExists(name) && !options.force) {
     const version = getMicroserviceVersion(name);
@@ -279,7 +519,12 @@ import { execFile } from "child_process";
 async function runMicroserviceCommand(name, args, timeout = 30000) {
   const meta = getMicroservice(name);
   if (!meta) {
-    return { success: false, stdout: "", stderr: `Unknown microservice '${name}'`, exitCode: 1 };
+    return {
+      success: false,
+      stdout: "",
+      stderr: `Unknown microservice '${name}'`,
+      exitCode: 1
+    };
   }
   if (!microserviceExists(name)) {
     return {
@@ -292,7 +537,12 @@ async function runMicroserviceCommand(name, args, timeout = 30000) {
   return new Promise((resolve) => {
     execFile(meta.binary, args, { timeout, maxBuffer: 10 * 1024 * 1024 }, (error, stdout, stderr) => {
       if (error && "killed" in error && error.killed) {
-        resolve({ success: false, stdout: "", stderr: "Command timed out", exitCode: 1 });
+        resolve({
+          success: false,
+          stdout: "",
+          stderr: "Command timed out",
+          exitCode: 1
+        });
         return;
       }
       const exitCode = error?.code ? typeof error.code === "number" ? error.code : 1 : 0;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hasna/microservices",
-  "version": "0.0.18",
-  "description": "Production-grade microservice building blocks for SaaS apps — 15 services covering identity, billing, AI, storage, search, and more. Each with PostgreSQL, HTTP API, MCP server, and CLI.",
+  "version": "0.0.20",
+  "description": "21 production-grade microservice building blocks for AI-native SaaS — auth, billing, LLM gateway, agent registry, RAG, guardrails, tracing, and more. Each with PostgreSQL, HTTP API, MCP server, and CLI.",
   "type": "module",
   "bin": {
     "microservices": "./bin/index.js",
@@ -23,10 +23,18 @@
   "types": "./dist/index.d.ts",
   "scripts": {
     "build": "bun build ./src/cli/index.tsx --outfile ./bin/index.js --target bun && bun build ./src/mcp/index.ts --outfile ./bin/mcp.js --target bun && bun build ./src/index.ts --outdir ./dist --target bun",
+    "build:all": "bun run build && bun run --filter '*' build",
     "dev": "bun run ./src/cli/index.tsx",
+    "gateway": "bun run gateway.ts",
     "typecheck": "tsc --noEmit",
+    "typecheck:all": "bun run typecheck && bun run --filter '*' typecheck",
     "test": "bun test",
-    "prepublishOnly": "bun run build",
+    "test:all": "bun test && bun run --filter '*' test",
+    "lint": "bunx biome check .",
+    "format": "bunx biome format --write .",
+    "clean": "rm -rf dist bin microservices/*/dist microservices/*/bin node_modules microservices/*/node_modules",
+    "pre-commit": "bun run lint && bun run format",
+    "prepublishOnly": "bun run build:all",
     "postinstall": "true"
   },
   "keywords": [
@@ -50,6 +58,7 @@
   "author": "Hasna",
   "license": "Apache-2.0",
   "devDependencies": {
+    "@biomejs/biome": "^2.4.10",
     "@types/bun": "latest",
     "typescript": "^5"
   },
@@ -74,11 +83,20 @@
     "@hasna/microservice-usage": "^0.0.1",
     "@hasna/microservice-webhooks": "^0.0.1",
     "@hasna/microservice-onboarding": "^0.0.1",
-    "@hasna/microservice-waitlist": "^0.0.1"
+    "@hasna/microservice-waitlist": "^0.0.1",
+    "@hasna/microservice-sessions": "^0.0.1",
+    "@hasna/microservice-guardrails": "^0.0.1",
+    "@hasna/microservice-knowledge": "^0.0.1",
+    "@hasna/microservice-traces": "^0.0.1",
+    "@hasna/microservice-agents": "^0.0.1",
+    "@hasna/microservice-prompts": "^0.0.1"
   },
   "engines": {
     "bun": ">=1.0.0"
   },
+  "workspaces": [
+    "microservices/*"
+  ],
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
     "access": "public"