@backendkit-labs/agent-web 0.1.0 → 0.3.0

package/dist/trigger/TriggerBus.js

@@ -0,0 +1,206 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TriggerBus = void 0;
+const crypto = __importStar(require("crypto"));
+const uuid_1 = require("uuid");
+const HeadlessTransport_1 = require("../transport/HeadlessTransport");
+// ── TriggerBus ────────────────────────────────────────────────────────────────
+/**
+ * Orchestrates autonomous agent runs triggered by cron schedules or
+ * inbound HTTP webhooks.
+ *
+ * Integrates with AgentServer via the `triggers` option so webhook routes
+ * are registered on the same Fastify instance and cron jobs start alongside
+ * the server.  Can also be used standalone (no AgentServer required).
+ *
+ * All runs are broadcast to the MonitorBus (if supplied) so the kanban board
+ * shows autonomous runs alongside interactive chat sessions.
+ *
+ * Usage:
+ * ```ts
+ * const triggers = new TriggerBus(enterprise.engineFactory)
+ *   .addCron({
+ *     name:        'daily-report',
+ *     schedule:    '0 9 * * 1-5',
+ *     buildPrompt: () => 'Generate the daily ops summary.',
+ *     onComplete:  ({ output }) => console.log(output),
+ *   })
+ *   .addWebhook({
+ *     name:        'github-issue',
+ *     path:        '/triggers/github',
+ *     secret:      process.env.GITHUB_WEBHOOK_SECRET,
+ *     buildPrompt: (body) => `New GitHub issue: ${JSON.stringify(body)}`,
+ *   });
+ *
+ * const server = new AgentServer({ port: 4001, engineFactory, triggers });
+ * await server.start();
+ * ```
+ */
+class TriggerBus {
+    engineFactory;
+    monitorBus;
+    cronDefs = [];
+    webhookDefs = [];
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    cronTasks = []; // node-cron ScheduledTask — loaded lazily
+    started = false;
+    constructor(engineFactory, monitorBus) {
+        this.engineFactory = engineFactory;
+        this.monitorBus = monitorBus;
+    }
+    addCron(def) {
+        this.cronDefs.push(def);
+        return this;
+    }
+    addWebhook(def) {
+        this.webhookDefs.push(def);
+        return this;
+    }
+    // ── Fastify integration ───────────────────────────────────────────────────
+    /** Register webhook routes on a Fastify instance. Called by AgentServer. */
+    registerRoutes(app) {
+        for (const def of this.webhookDefs) {
+            const method = (def.method ?? 'POST').toLowerCase();
+            app[method](def.path, async (req, reply) => {
+                if (def.secret) {
+                    const sig = (req.headers['x-hub-signature-256'] ?? '');
+                    const rawBody = JSON.stringify(req.body);
+                    if (!verifyHmac(rawBody, sig, def.secret)) {
+                        return reply.code(401).send({ error: 'Invalid webhook signature' });
+                    }
+                }
+                // Fire async — respond immediately so the caller doesn't time out
+                void this.fire(def, req.body).catch(err => def.onError?.(err instanceof Error ? err : new Error(String(err)), def.name));
+                return reply.code(202).send({ queued: true, trigger: def.name });
+            });
+        }
+    }
+    // ── Lifecycle ─────────────────────────────────────────────────────────────
+    start() {
+        if (this.started)
+            return;
+        this.started = true;
+        this.startCrons();
+    }
+    close() {
+        for (const task of this.cronTasks) {
+            try {
+                task.stop();
+            }
+            catch { /* already stopped */ }
+        }
+        this.cronTasks = [];
+        this.started = false;
+    }
+    // ── Internal ──────────────────────────────────────────────────────────────
+    startCrons() {
+        let nodeCron = null;
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            nodeCron = require('node-cron');
+        }
+        catch {
+            if (this.cronDefs.length > 0) {
+                console.warn('[TriggerBus] node-cron not found — cron triggers disabled. Run: npm i node-cron');
+            }
+            return;
+        }
+        for (const def of this.cronDefs) {
+            if (!nodeCron.validate(def.schedule)) {
+                console.error(`[TriggerBus] Invalid cron schedule for "${def.name}": ${def.schedule}`);
+                continue;
+            }
+            const task = nodeCron.schedule(def.schedule, () => {
+                void this.fire(def).catch(err => def.onError?.(err instanceof Error ? err : new Error(String(err)), def.name));
+            });
+            this.cronTasks.push(task);
+            if (def.runOnStart) {
+                void this.fire(def).catch(err => def.onError?.(err instanceof Error ? err : new Error(String(err)), def.name));
+            }
+        }
+    }
+    async fire(def, payload) {
+        const sessionId = `trigger-${(0, uuid_1.v4)()}`;
+        const firedAt = new Date();
+        const startMs = Date.now();
+        const transport = new HeadlessTransport_1.HeadlessTransport();
+        // Fan out to MonitorBus so the kanban shows autonomous runs
+        if (this.monitorBus) {
+            const bus = this.monitorBus;
+            const origEmit = transport.emit.bind(transport);
+            transport.emit = (event) => {
+                origEmit(event);
+                bus.broadcast(sessionId, event);
+            };
+            bus.notifySessionOpen(sessionId);
+        }
+        try {
+            const engine = this.engineFactory(sessionId, transport);
+            const prompt = await def.buildPrompt(payload);
+            await engine.run(prompt);
+            const result = {
+                sessionId,
+                triggerName: def.name,
+                firedAt,
+                durationMs: Date.now() - startMs,
+                output: transport.getOutput(),
+                events: transport.getEvents(),
+            };
+            await def.onComplete?.(result);
+        }
+        finally {
+            this.monitorBus?.notifySessionClose(sessionId);
+            transport.close();
+        }
+    }
+}
+exports.TriggerBus = TriggerBus;
+// ── HMAC helper ───────────────────────────────────────────────────────────────
+function verifyHmac(body, signature, secret) {
+    if (!signature)
+        return false;
+    const expected = `sha256=${crypto
+        .createHmac('sha256', secret)
+        .update(body)
+        .digest('hex')}`;
+    try {
+        return crypto.timingSafeEqual(Buffer.from(signature, 'utf8'), Buffer.from(expected, 'utf8'));
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=TriggerBus.js.map

package/dist/trigger/TriggerBus.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backendkit-labs/agent-web",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "HTTP/WebSocket server layer for agent-core — browser-ready streaming agent sessions",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -21,10 +21,18 @@
   "dependencies": {
     "@fastify/websocket": "^11.0.0",
     "fastify": "^5.0.0",
+    "jsonwebtoken": "^9.0.0",
+    "prom-client": "^15.0.0",
     "uuid": "^10.0.0"
   },
+  "optionalDependencies": {
+    "@fastify/rate-limit": "^9.0.0",
+    "node-cron": "^3.0.0"
+  },
   "devDependencies": {
     "@backendkit-labs/agent-core": "*",
+    "@types/jsonwebtoken": "^9.0.0",
+    "@types/node-cron": "^3.0.0",
     "@types/node": "^20.0.0",
     "@types/uuid": "^10.0.0",
     "@types/ws": "^8.0.0",