@advicenxt/sbp-server 0.1.0

package/dist/server.js

@@ -0,0 +1,401 @@
+/**
+ * SBP HTTP Server
+ * Streamable HTTP with SSE (following MCP transport patterns)
+ */
+import Fastify from "fastify";
+import { Blackboard } from "./blackboard.js";
+import { v7 as uuidv7 } from "uuid";
+import { validateEnvelope, validateParams } from "./validation.js";
+import { createAuthHook } from "./auth.js";
+import { createRateLimitHook } from "./rate-limiter.js";
+export class SbpServer {
+    app;
+    blackboard;
+    options;
+    sseClients = new Map();
+    sessions = new Map();
+    eventCounter = 0;
+    constructor(options = {}) {
+        this.options = {
+            port: options.port ?? 3000,
+            host: options.host ?? "localhost",
+            cors: options.cors ?? true,
+            logging: options.logging ?? false,
+            evaluationInterval: options.evaluationInterval ?? 100,
+            defaultDecay: options.defaultDecay ?? { type: "exponential", half_life_ms: 300000 },
+            defaultTtlFloor: options.defaultTtlFloor ?? 0.01,
+            maxPheromones: options.maxPheromones ?? 100000,
+            trackEmissionHistory: options.trackEmissionHistory ?? true,
+            emissionHistoryWindow: options.emissionHistoryWindow ?? 60000,
+            auth: options.auth,
+            rateLimit: options.rateLimit,
+        };
+        this.blackboard = new Blackboard(this.options);
+        this.app = Fastify({ logger: this.options.logging });
+        this.setupRoutes();
+    }
+    setupRoutes() {
+        // Authentication hook
+        if (this.options.auth?.requireAuth) {
+            this.app.addHook("onRequest", createAuthHook(this.options.auth));
+        }
+        // Rate limiting hook
+        if (this.options.rateLimit) {
+            this.app.addHook("onRequest", createRateLimitHook(this.options.rateLimit));
+        }
+        // CORS
+        if (this.options.cors) {
+            this.app.addHook("onRequest", async (request, reply) => {
+                reply.header("Access-Control-Allow-Origin", "*");
+                reply.header("Access-Control-Allow-Methods", "POST, GET, DELETE, OPTIONS");
+                reply.header("Access-Control-Allow-Headers", "Content-Type, Accept, Authorization, Sbp-Protocol-Version, Sbp-Session-Id, Sbp-Agent-Id, Last-Event-ID");
+                if (request.method === "OPTIONS") {
+                    reply.status(204).send();
+                }
+            });
+        }
+        // Health check
+        this.app.get("/health", async () => {
+            const stats = this.blackboard.inspect({ include: ["stats"] });
+            return {
+                status: "ok",
+                version: "0.1.0",
+                transport: "streamable-http-sse",
+                ...stats.stats,
+            };
+        });
+        // Main SBP endpoint - POST for client->server messages
+        this.app.post("/sbp", async (request, reply) => {
+            return this.handlePost(request, reply);
+        });
+        // Main SBP endpoint - GET for SSE stream (server->client)
+        this.app.get("/sbp", async (request, reply) => {
+            return this.handleSSE(request, reply);
+        });
+        // Legacy JSON-RPC endpoint (for backwards compatibility)
+        this.app.post("/rpc", async (request, reply) => {
+            const body = request.body;
+            const response = await this.handleRpc(body, request);
+            reply.header("Content-Type", "application/json");
+            return response;
+        });
+        // Convenience REST endpoints
+        this.app.post("/emit", async (request) => {
+            const params = request.body;
+            return this.blackboard.emit(params);
+        });
+        this.app.post("/sniff", async (request) => {
+            const params = request.body;
+            return this.blackboard.sniff(params);
+        });
+        this.app.post("/scents", async (request) => {
+            const params = request.body;
+            return this.blackboard.registerScent(params);
+        });
+        this.app.delete("/scents/:scent_id", async (request) => {
+            const { scent_id } = request.params;
+            return this.blackboard.deregisterScent({ scent_id });
+        });
+        this.app.get("/inspect", async (request) => {
+            const query = request.query;
+            const include = query.include?.split(",");
+            return this.blackboard.inspect({ include });
+        });
+    }
+    /**
+     * Handle POST requests (client -> server messages)
+     */
+    async handlePost(request, reply) {
+        // Validate JSON-RPC envelope
+        const envelopeResult = validateEnvelope(request.body);
+        if (!envelopeResult.ok) {
+            reply.header("Content-Type", "application/json");
+            return {
+                jsonrpc: "2.0",
+                id: null,
+                error: envelopeResult.error,
+            };
+        }
+        const body = envelopeResult.request;
+        // Validate method-specific params
+        const paramsResult = validateParams(body.method, body.params);
+        if (!paramsResult.ok) {
+            reply.header("Content-Type", "application/json");
+            return {
+                jsonrpc: "2.0",
+                id: body.id,
+                error: paramsResult.error,
+            };
+        }
+        // Replace params with validated (parsed) params
+        const validatedRequest = {
+            ...body,
+            params: paramsResult.params,
+        };
+        // Get or create session
+        let sessionId = request.headers["sbp-session-id"];
+        if (!sessionId) {
+            sessionId = uuidv7();
+            this.sessions.set(sessionId, {
+                agentId: request.headers["sbp-agent-id"] || "unknown",
+                createdAt: Date.now(),
+            });
+        }
+        // Handle JSON-RPC request
+        const response = await this.handleRpc(validatedRequest, request);
+        // Set session header
+        reply.header("Sbp-Session-Id", sessionId);
+        reply.header("Content-Type", "application/json");
+        return response;
+    }
+    /**
+     * Handle GET requests - open SSE stream for triggers
+     */
+    async handleSSE(request, reply) {
+        const accept = request.headers.accept || "";
+        if (!accept.includes("text/event-stream")) {
+            reply.status(406).send({ error: "Accept header must include text/event-stream" });
+            return;
+        }
+        const sessionId = request.headers["sbp-session-id"] || uuidv7();
+        const lastEventId = request.headers["last-event-id"];
+        const clientId = uuidv7();
+        // Set up SSE headers
+        reply.raw.writeHead(200, {
+            "Content-Type": "text/event-stream",
+            "Cache-Control": "no-cache",
+            Connection: "keep-alive",
+            "Sbp-Session-Id": sessionId,
+            "Access-Control-Allow-Origin": "*",
+        });
+        // Register SSE client
+        const client = {
+            id: clientId,
+            sessionId,
+            reply,
+            scents: new Set(),
+            lastEventId: lastEventId ? parseInt(lastEventId, 10) : 0,
+        };
+        this.sseClients.set(clientId, client);
+        // Send initial connection event
+        this.sendSSEEvent(client, "connected", { client_id: clientId, session_id: sessionId });
+        // Handle client disconnect
+        request.raw.on("close", () => {
+            this.sseClients.delete(clientId);
+            // Unregister scent handlers for this client
+            for (const scentId of client.scents) {
+                this.blackboard.offTrigger(scentId);
+            }
+        });
+        // Keep connection alive with periodic comments
+        const keepAlive = setInterval(() => {
+            if (reply.raw.writable) {
+                reply.raw.write(": keepalive\n\n");
+            }
+            else {
+                clearInterval(keepAlive);
+            }
+        }, 30000);
+        request.raw.on("close", () => clearInterval(keepAlive));
+    }
+    /**
+     * Send an SSE event to a client
+     */
+    sendSSEEvent(client, event, data) {
+        if (!client.reply.raw.writable)
+            return;
+        const eventId = ++this.eventCounter;
+        const payload = JSON.stringify(data);
+        client.reply.raw.write(`event: ${event}\n`);
+        client.reply.raw.write(`id: ${eventId}\n`);
+        client.reply.raw.write(`data: ${payload}\n\n`);
+        client.lastEventId = eventId;
+    }
+    /**
+     * Send a JSON-RPC notification via SSE
+     */
+    sendSSENotification(client, method, params) {
+        const message = {
+            jsonrpc: "2.0",
+            method,
+            params,
+        };
+        this.sendSSEEvent(client, "message", message);
+    }
+    /**
+     * Handle JSON-RPC requests
+     */
+    async handleRpc(request, httpRequest) {
+        const { id, method, params } = request;
+        const sessionId = httpRequest.headers["sbp-session-id"];
+        try {
+            let result;
+            switch (method) {
+                case "sbp/emit":
+                    result = this.blackboard.emit(params);
+                    break;
+                case "sbp/sniff":
+                    result = this.blackboard.sniff(params);
+                    break;
+                case "sbp/register_scent": {
+                    const scentParams = params;
+                    result = this.blackboard.registerScent(scentParams);
+                    // Set up trigger forwarding
+                    if (sessionId) {
+                        this.setupSSETrigger(scentParams.scent_id, sessionId);
+                    }
+                    // If agent_endpoint is provided, set up webhook delivery
+                    if (scentParams.agent_endpoint) {
+                        this.setupWebhookTrigger(scentParams.scent_id, scentParams.agent_endpoint);
+                    }
+                    break;
+                }
+                case "sbp/deregister_scent":
+                    result = this.blackboard.deregisterScent(params);
+                    break;
+                case "sbp/evaporate":
+                    result = this.blackboard.evaporate(params);
+                    break;
+                case "sbp/inspect":
+                    result = this.blackboard.inspect(params);
+                    break;
+                case "sbp/subscribe": {
+                    // Subscribe to scent triggers (used after SSE stream is open)
+                    const { scent_id } = params;
+                    if (sessionId) {
+                        this.setupSSETrigger(scent_id, sessionId);
+                        // Mark scent subscription for all clients in this session
+                        for (const client of this.sseClients.values()) {
+                            if (client.sessionId === sessionId) {
+                                client.scents.add(scent_id);
+                            }
+                        }
+                    }
+                    result = { subscribed: scent_id };
+                    break;
+                }
+                case "sbp/unsubscribe": {
+                    const { scent_id } = params;
+                    this.blackboard.offTrigger(scent_id);
+                    // Remove from client scent sets
+                    for (const client of this.sseClients.values()) {
+                        if (client.sessionId === sessionId) {
+                            client.scents.delete(scent_id);
+                        }
+                    }
+                    result = { unsubscribed: scent_id };
+                    break;
+                }
+                default:
+                    return {
+                        jsonrpc: "2.0",
+                        id,
+                        error: {
+                            code: -32601,
+                            message: "Method not found",
+                            data: { method },
+                        },
+                    };
+            }
+            return {
+                jsonrpc: "2.0",
+                id,
+                result,
+            };
+        }
+        catch (err) {
+            const error = err;
+            return {
+                jsonrpc: "2.0",
+                id,
+                error: {
+                    code: -32603,
+                    message: error.message,
+                },
+            };
+        }
+    }
+    /**
+     * Set up trigger forwarding to SSE clients
+     */
+    setupSSETrigger(scentId, sessionId) {
+        this.blackboard.onTrigger(scentId, async (payload) => {
+            // Send to all SSE clients in this session
+            for (const client of this.sseClients.values()) {
+                if (client.sessionId === sessionId || client.scents.has(scentId)) {
+                    this.sendSSENotification(client, "sbp/trigger", payload);
+                }
+            }
+        });
+    }
+    /**
+     * Set up webhook trigger delivery to an agent endpoint
+     */
+    setupWebhookTrigger(scentId, endpoint) {
+        this.blackboard.onTrigger(scentId, async (payload) => {
+            // Attempt webhook delivery with one retry
+            for (let attempt = 0; attempt < 2; attempt++) {
+                try {
+                    const response = await fetch(endpoint, {
+                        method: "POST",
+                        headers: {
+                            "Content-Type": "application/json",
+                            "Sbp-Protocol-Version": "0.1",
+                        },
+                        body: JSON.stringify({
+                            jsonrpc: "2.0",
+                            method: "sbp/trigger",
+                            params: payload,
+                        }),
+                        signal: AbortSignal.timeout(10000),
+                    });
+                    if (response.ok)
+                        return; // Success
+                    // Retry on 5xx
+                    if (response.status >= 500 && attempt === 0) {
+                        await new Promise((r) => setTimeout(r, 1000));
+                        continue;
+                    }
+                    break; // Don't retry on 4xx
+                }
+                catch {
+                    // Network error — retry once
+                    if (attempt === 0) {
+                        await new Promise((r) => setTimeout(r, 1000));
+                    }
+                }
+            }
+        });
+    }
+    async start() {
+        // Start blackboard evaluation loop
+        this.blackboard.start();
+        // Start HTTP server
+        await this.app.listen({ port: this.options.port, host: this.options.host });
+        console.log(`[SBP] Server listening on http://${this.options.host}:${this.options.port}`);
+        console.log(`[SBP] Streamable HTTP endpoint: POST/GET ${this.address}/sbp`);
+        console.log(`[SBP] Transport: SSE (Server-Sent Events)`);
+        if (this.options.auth?.requireAuth) {
+            console.log(`[SBP] Authentication: API key required`);
+        }
+        if (this.options.rateLimit) {
+            console.log(`[SBP] Rate limiting: ${this.options.rateLimit.maxRequests ?? 1000} req/${(this.options.rateLimit.windowMs ?? 60000) / 1000}s`);
+        }
+    }
+    async stop() {
+        this.blackboard.stop();
+        // Close all SSE connections
+        for (const client of this.sseClients.values()) {
+            if (client.reply.raw.writable) {
+                client.reply.raw.end();
+            }
+        }
+        this.sseClients.clear();
+        await this.app.close();
+        console.log("[SBP] Server stopped");
+    }
+    get address() {
+        return `http://${this.options.host}:${this.options.port}`;
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/store.d.ts

@@ -0,0 +1,54 @@
+/**
+ * SBP Pheromone Store - Persistence Adapter Interface
+ *
+ * Abstraction layer for pluggable storage backends.
+ * Default implementation: MemoryStore (in-process Map).
+ */
+import type { Pheromone } from "./types.js";
+/**
+ * Abstract storage interface for pheromones.
+ * Implementations MUST be synchronous-safe for the core Blackboard operations.
+ * Async-capable stores (Redis, SQLite) should pre-load into a local cache.
+ */
+export interface PheromoneStore {
+    /** Get a pheromone by ID. Returns undefined if not found. */
+    get(id: string): Pheromone | undefined;
+    /** Store or update a pheromone. */
+    set(id: string, pheromone: Pheromone): void;
+    /** Delete a pheromone by ID. Returns true if existed. */
+    delete(id: string): boolean;
+    /** Check if a pheromone exists. */
+    has(id: string): boolean;
+    /** Iterate over all stored pheromones. */
+    values(): IterableIterator<Pheromone>;
+    /** Iterate over all [id, pheromone] pairs. */
+    entries(): IterableIterator<[string, Pheromone]>;
+    /** Number of stored pheromones. */
+    readonly size: number;
+    /** Remove all pheromones. */
+    clear(): void;
+}
+/**
+ * In-memory pheromone store backed by a Map.
+ * This is the default store and provides the fastest access.
+ * Data is lost on process restart — acceptable for ephemeral signals.
+ */
+export declare class MemoryStore implements PheromoneStore {
+    private data;
+    get(id: string): Pheromone | undefined;
+    set(id: string, pheromone: Pheromone): void;
+    delete(id: string): boolean;
+    has(id: string): boolean;
+    values(): IterableIterator<Pheromone>;
+    entries(): IterableIterator<[string, Pheromone]>;
+    get size(): number;
+    clear(): void;
+}
+export type StoreType = "memory";
+/**
+ * Create a pheromone store of the specified type.
+ * Currently only "memory" is built-in. Additional stores (Redis, SQLite)
+ * can be added by implementing the PheromoneStore interface.
+ */
+export declare function createStore(type?: StoreType): PheromoneStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAM5C;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC3B,6DAA6D;IAC7D,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IAEvC,mCAAmC;IACnC,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IAE5C,yDAAyD;IACzD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAE5B,mCAAmC;IACnC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAEzB,0CAA0C;IAC1C,MAAM,IAAI,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAEtC,8CAA8C;IAC9C,OAAO,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAEjD,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,6BAA6B;IAC7B,KAAK,IAAI,IAAI,CAAC;CACjB;AAMD;;;;GAIG;AACH,qBAAa,WAAY,YAAW,cAAc;IAC9C,OAAO,CAAC,IAAI,CAAgC;IAE5C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAItC,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;IAI3C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI3B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB,MAAM,IAAI,gBAAgB,CAAC,SAAS,CAAC;IAIrC,OAAO,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAIhD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,KAAK,IAAI,IAAI;CAGhB;AAMD,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC;AAEjC;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,GAAE,SAAoB,GAAG,cAAc,CAOtE"}

package/dist/store.js

@@ -0,0 +1,55 @@
+/**
+ * SBP Pheromone Store - Persistence Adapter Interface
+ *
+ * Abstraction layer for pluggable storage backends.
+ * Default implementation: MemoryStore (in-process Map).
+ */
+// ============================================================================
+// MEMORY STORE
+// ============================================================================
+/**
+ * In-memory pheromone store backed by a Map.
+ * This is the default store and provides the fastest access.
+ * Data is lost on process restart — acceptable for ephemeral signals.
+ */
+export class MemoryStore {
+    data = new Map();
+    get(id) {
+        return this.data.get(id);
+    }
+    set(id, pheromone) {
+        this.data.set(id, pheromone);
+    }
+    delete(id) {
+        return this.data.delete(id);
+    }
+    has(id) {
+        return this.data.has(id);
+    }
+    values() {
+        return this.data.values();
+    }
+    entries() {
+        return this.data.entries();
+    }
+    get size() {
+        return this.data.size;
+    }
+    clear() {
+        this.data.clear();
+    }
+}
+/**
+ * Create a pheromone store of the specified type.
+ * Currently only "memory" is built-in. Additional stores (Redis, SQLite)
+ * can be added by implementing the PheromoneStore interface.
+ */
+export function createStore(type = "memory") {
+    switch (type) {
+        case "memory":
+            return new MemoryStore();
+        default:
+            throw new Error(`Unknown store type: ${type}`);
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuCH,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,OAAO,WAAW;IACZ,IAAI,GAAG,IAAI,GAAG,EAAqB,CAAC;IAE5C,GAAG,CAAC,EAAU;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED,GAAG,CAAC,EAAU,EAAE,SAAoB;QAChC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,CAAC,EAAU;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,GAAG,CAAC,EAAU;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM;QACF,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IAC9B,CAAC;IAED,OAAO;QACH,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;IAC/B,CAAC;IAED,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED,KAAK;QACD,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;CACJ;AAQD;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,OAAkB,QAAQ;IAClD,QAAQ,IAAI,EAAE,CAAC;QACX,KAAK,QAAQ;YACT,OAAO,IAAI,WAAW,EAAE,CAAC;QAC7B;YACI,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;AACL,CAAC"}