@hasna/microservices 0.0.18 → 0.0.19

package/bin/index.js

@@ -2511,6 +2511,18 @@ var MICROSERVICES = [
     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",
@@ -2558,6 +2570,78 @@ 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: "knowledge",
+    displayName: "Knowledge",
+    description: "RAG pipeline: document ingestion, chunking (fixed/paragraph/sentence/recursive), embedding via pgvector, retrieval with source attribution and scoring.",
+    category: "AI",
+    package: "@hasna/microservice-knowledge",
+    binary: "microservice-knowledge",
+    schemaPrefix: "knowledge",
+    tags: ["knowledge", "rag", "chunking", "ingestion", "retrieval", "documents", "pgvector"],
+    requiredEnv: ["DATABASE_URL"],
+    optionalEnv: ["OPENAI_API_KEY", "KNOWLEDGE_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) {

package/bin/mcp.js

@@ -19607,6 +19607,18 @@ var MICROSERVICES = [
     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",
@@ -19654,6 +19666,78 @@ 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: "knowledge",
+    displayName: "Knowledge",
+    description: "RAG pipeline: document ingestion, chunking (fixed/paragraph/sentence/recursive), embedding via pgvector, retrieval with source attribution and scoring.",
+    category: "AI",
+    package: "@hasna/microservice-knowledge",
+    binary: "microservice-knowledge",
+    schemaPrefix: "knowledge",
+    tags: ["knowledge", "rag", "chunking", "ingestion", "retrieval", "documents", "pgvector"],
+    requiredEnv: ["DATABASE_URL"],
+    optionalEnv: ["OPENAI_API_KEY", "KNOWLEDGE_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) {

package/dist/index.js

@@ -144,6 +144,18 @@ var MICROSERVICES = [
     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",
@@ -191,6 +203,78 @@ 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: "knowledge",
+    displayName: "Knowledge",
+    description: "RAG pipeline: document ingestion, chunking (fixed/paragraph/sentence/recursive), embedding via pgvector, retrieval with source attribution and scoring.",
+    category: "AI",
+    package: "@hasna/microservice-knowledge",
+    binary: "microservice-knowledge",
+    schemaPrefix: "knowledge",
+    tags: ["knowledge", "rag", "chunking", "ingestion", "retrieval", "documents", "pgvector"],
+    requiredEnv: ["DATABASE_URL"],
+    optionalEnv: ["OPENAI_API_KEY", "KNOWLEDGE_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) {

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.19",
+  "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",
@@ -74,7 +74,13 @@
     "@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"