@backendkit-labs/agent-web 0.1.0 → 0.3.0

package/dist/session/SessionManager.d.ts

@@ -1,6 +1,8 @@
 import type { AgentEngine } from '@backendkit-labs/agent-core';
 import { WebSocketTransport } from '../transport/WebSocketTransport';
 import type { MonitorBus } from '../monitor/MonitorBus';
+import type { MetricsCollector } from '../metrics/MetricsCollector';
+import type { SessionMetaStore } from '../store/SessionMetaStore';
 import type { WebSocket } from 'ws';
 export interface Session {
     id: string;
@@ -8,6 +10,8 @@ export interface Session {
     transport: WebSocketTransport;
     createdAt: Date;
     lastActivityAt: Date;
+    /** Set when JWT auth is active. */
+    userId?: string;
 }
 export type EngineFactory = (sessionId: string, transport: WebSocketTransport) => AgentEngine;
 export interface SessionManagerOptions {
@@ -19,6 +23,10 @@ export interface SessionManagerOptions {
     maxSessions?: number;
     /** Optional monitor bus — broadcasts all session events to connected observers. */
     monitorBus?: MonitorBus;
+    /** Optional Prometheus metrics collector. */
+    metrics?: MetricsCollector;
+    /** Optional durable store for session metadata (Redis, etc.). */
+    store?: SessionMetaStore;
 }
 export declare class SessionManager {
     private sessions;
@@ -26,13 +34,15 @@ export declare class SessionManager {
     private readonly maxSessions;
     private readonly engineFactory;
     private readonly monitorBus;
+    private readonly metrics;
+    private readonly store;
     private sweepTimer;
     constructor(opts: SessionManagerOptions);
     /** Create a new session and wire a WebSocket to it. */
-    create(socket: WebSocket): Session;
+    create(socket: WebSocket, userId?: string): Session;
     get(id: string): Session | undefined;
     destroy(id: string): void;
-    list(): Pick<Session, 'id' | 'createdAt' | 'lastActivityAt'>[];
+    list(): Pick<Session, 'id' | 'createdAt' | 'lastActivityAt' | 'userId'>[];
     get size(): number;
     close(): void;
     private sweepIdle;

package/dist/session/SessionManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionManager.d.ts","sourceRoot":"","sources":["../../src/session/SessionManager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAEpC,MAAM,WAAW,OAAO;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,SAAS,EAAE,IAAI,CAAC;IAChB,cAAc,EAAE,IAAI,CAAC;CACxB;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,kBAAkB,KAAK,WAAW,CAAC;AAE9F,MAAM,WAAW,qBAAqB;IAClC,uFAAuF;IACvF,aAAa,EAAE,aAAa,CAAC;IAC7B,0FAA0F;IAC1F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mFAAmF;IACnF,UAAU,CAAC,EAAE,UAAU,CAAC;CAC3B;AAED,qBAAa,cAAc;IACvB,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IACpD,OAAO,CAAC,UAAU,CAA+C;gBAErD,IAAI,EAAE,qBAAqB;IAWvC,uDAAuD;IACvD,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO;IAoClC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAMpC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IASzB,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,WAAW,GAAG,gBAAgB,CAAC,EAAE;IAM9D,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,KAAK,IAAI,IAAI;IAQb,OAAO,CAAC,SAAS;CAQpB"}
+{"version":3,"file":"SessionManager.d.ts","sourceRoot":"","sources":["../../src/session/SessionManager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAEpC,MAAM,WAAW,OAAO;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,SAAS,EAAE,IAAI,CAAC;IAChB,cAAc,EAAE,IAAI,CAAC;IACrB,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,kBAAkB,KAAK,WAAW,CAAC;AAE9F,MAAM,WAAW,qBAAqB;IAClC,uFAAuF;IACvF,aAAa,EAAE,aAAa,CAAC;IAC7B,0FAA0F;IAC1F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mFAAmF;IACnF,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,iEAAiE;IACjE,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC5B;AAED,qBAAa,cAAc;IACvB,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+B;IACrD,OAAO,CAAC,UAAU,CAA+C;gBAErD,IAAI,EAAE,qBAAqB;IAavC,uDAAuD;IACvD,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO;IA6CnD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAcpC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAWzB,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,WAAW,GAAG,gBAAgB,GAAG,QAAQ,CAAC,EAAE;IAMzE,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,KAAK,IAAI,IAAI;IASb,OAAO,CAAC,SAAS;CAQpB"}

package/dist/session/SessionManager.js

@@ -9,18 +9,22 @@ class SessionManager {
     maxSessions;
     engineFactory;
     monitorBus;
+    metrics;
+    store;
     sweepTimer = null;
     constructor(opts) {
         this.engineFactory = opts.engineFactory;
         this.maxIdleMs = opts.maxIdleMs ?? 30 * 60 * 1000;
         this.maxSessions = opts.maxSessions ?? 100;
         this.monitorBus = opts.monitorBus;
+        this.metrics = opts.metrics;
+        this.store = opts.store;
         // sweep idle sessions every minute
         this.sweepTimer = setInterval(() => this.sweepIdle(), 60_000);
         this.sweepTimer.unref?.();
     }
     /** Create a new session and wire a WebSocket to it. */
-    create(socket) {
+    create(socket, userId) {
         if (this.sessions.size >= this.maxSessions) {
             throw new Error(`Max concurrent sessions (${this.maxSessions}) reached`);
         }
@@ -36,22 +40,38 @@ class SessionManager {
             };
         }
         const engine = this.engineFactory(id, transport);
+        const now = new Date();
         const session = {
             id,
             engine,
             transport,
-            createdAt: new Date(),
-            lastActivityAt: new Date(),
+            createdAt: now,
+            lastActivityAt: now,
+            userId,
         };
         this.sessions.set(id, session);
         this.monitorBus?.notifySessionOpen(id);
+        this.metrics?.sessionOpened();
+        this.store?.set(id, {
+            id,
+            createdAt: now.toISOString(),
+            lastActivityAt: now.toISOString(),
+            userId,
+        }).catch(() => { });
         socket.on('close', () => this.destroy(id));
         return session;
     }
     get(id) {
         const session = this.sessions.get(id);
-        if (session)
+        if (session) {
             session.lastActivityAt = new Date();
+            this.store?.set(id, {
+                id,
+                createdAt: session.createdAt.toISOString(),
+                lastActivityAt: session.lastActivityAt.toISOString(),
+                userId: session.userId,
+            }).catch(() => { });
+        }
         return session;
     }
     destroy(id) {
@@ -68,10 +88,12 @@ class SessionManager {
         catch { /* may already be closed */ }
         this.sessions.delete(id);
         this.monitorBus?.notifySessionClose(id);
+        this.metrics?.sessionClosed();
+        this.store?.delete(id).catch(() => { });
     }
     list() {
-        return [...this.sessions.values()].map(({ id, createdAt, lastActivityAt }) => ({
-            id, createdAt, lastActivityAt,
+        return [...this.sessions.values()].map(({ id, createdAt, lastActivityAt, userId }) => ({
+            id, createdAt, lastActivityAt, userId,
         }));
     }
     get size() {
@@ -84,6 +106,7 @@ class SessionManager {
         }
         for (const id of [...this.sessions.keys()])
             this.destroy(id);
+        this.store?.close().catch(() => { });
     }
     sweepIdle() {
         const cutoff = Date.now() - this.maxIdleMs;

package/dist/session/SessionManager.js.map

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

package/dist/store/SessionMetaStore.d.ts

@@ -0,0 +1,46 @@
+export interface SessionMeta {
+    id: string;
+    createdAt: string;
+    lastActivityAt: string;
+    userId?: string;
+    /** Extra fields the application wants to track. */
+    [key: string]: unknown;
+}
+export interface SessionMetaStore {
+    set(id: string, meta: SessionMeta): Promise<void>;
+    get(id: string): Promise<SessionMeta | null>;
+    delete(id: string): Promise<void>;
+    list(): Promise<SessionMeta[]>;
+    close(): Promise<void>;
+}
+export declare class InMemorySessionMetaStore implements SessionMetaStore {
+    private data;
+    set(id: string, meta: SessionMeta): Promise<void>;
+    get(id: string): Promise<SessionMeta | null>;
+    delete(id: string): Promise<void>;
+    list(): Promise<SessionMeta[]>;
+    close(): Promise<void>;
+}
+export interface RedisLike {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, expiryMode: string, time: number): Promise<unknown>;
+    del(key: string): Promise<unknown>;
+    keys(pattern: string): Promise<string[]>;
+    quit(): Promise<unknown>;
+}
+export declare class RedisSessionMetaStore implements SessionMetaStore {
+    private readonly redis;
+    private readonly prefix;
+    private readonly ttl;
+    constructor(redis: RedisLike, opts?: {
+        prefix?: string;
+        ttlSeconds?: number;
+    });
+    private key;
+    set(id: string, meta: SessionMeta): Promise<void>;
+    get(id: string): Promise<SessionMeta | null>;
+    delete(id: string): Promise<void>;
+    list(): Promise<SessionMeta[]>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=SessionMetaStore.d.ts.map

package/dist/store/SessionMetaStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionMetaStore.d.ts","sourceRoot":"","sources":["../../src/store/SessionMetaStore.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC7B,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC7C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAID,qBAAa,wBAAyB,YAAW,gBAAgB;IAC7D,OAAO,CAAC,IAAI,CAAkC;IAExC,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAI5C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjC,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAI9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B;AAMD,MAAM,WAAW,SAAS;IACtB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpF,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5B;AAED,qBAAa,qBAAsB,YAAW,gBAAgB;IAKtD,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJ1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAGR,KAAK,EAAE,SAAS,EACjC,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO;IAMvD,OAAO,CAAC,GAAG;IAIL,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAK5C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjC,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAQ9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}

package/dist/store/SessionMetaStore.js

@@ -0,0 +1,72 @@
+"use strict";
+// ── Session metadata store ─────────────────────────────────────────────────────
+//
+// The live AgentEngine + WebSocketTransport can't be serialized, so the in-memory
+// Map in SessionManager remains the authoritative runtime store.
+//
+// SessionMetaStore persists lightweight metadata (id, userId, timestamps) to a
+// durable backend.  Use cases:
+//   - List active sessions across multiple server instances
+//   - Audit trail: who connected when, from which session id
+//   - Future: resume conversation history after reconnect
+//
+// Implementations:
+//   InMemorySessionMetaStore  — default, zero deps, single-instance
+//   RedisSessionMetaStore     — pass any Redis-like client (ioredis, node-redis)
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisSessionMetaStore = exports.InMemorySessionMetaStore = void 0;
+// ── In-memory (default) ───────────────────────────────────────────────────────
+class InMemorySessionMetaStore {
+    data = new Map();
+    async set(id, meta) {
+        this.data.set(id, meta);
+    }
+    async get(id) {
+        return this.data.get(id) ?? null;
+    }
+    async delete(id) {
+        this.data.delete(id);
+    }
+    async list() {
+        return [...this.data.values()];
+    }
+    async close() {
+        this.data.clear();
+    }
+}
+exports.InMemorySessionMetaStore = InMemorySessionMetaStore;
+class RedisSessionMetaStore {
+    redis;
+    prefix;
+    ttl;
+    constructor(redis, opts = {}) {
+        this.redis = redis;
+        this.prefix = opts.prefix ?? 'bk:session:';
+        this.ttl = opts.ttlSeconds ?? 4 * 60 * 60; // 4 h default
+    }
+    key(id) {
+        return `${this.prefix}${id}`;
+    }
+    async set(id, meta) {
+        await this.redis.set(this.key(id), JSON.stringify(meta), 'EX', this.ttl);
+    }
+    async get(id) {
+        const raw = await this.redis.get(this.key(id));
+        return raw ? JSON.parse(raw) : null;
+    }
+    async delete(id) {
+        await this.redis.del(this.key(id));
+    }
+    async list() {
+        const keys = await this.redis.keys(`${this.prefix}*`);
+        const results = await Promise.all(keys.map(k => this.redis.get(k)));
+        return results
+            .filter((r) => r !== null)
+            .map(r => JSON.parse(r));
+    }
+    async close() {
+        await this.redis.quit();
+    }
+}
+exports.RedisSessionMetaStore = RedisSessionMetaStore;
+//# sourceMappingURL=SessionMetaStore.js.map

package/dist/store/SessionMetaStore.js.map

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

package/dist/transport/HeadlessTransport.d.ts

@@ -0,0 +1,21 @@
+import type { AgentEvent, Transport, Unsubscribe } from '@backendkit-labs/agent-core';
+/**
+ * A transport with no outbound socket.
+ *
+ * Used by TriggerBus for autonomous (cron/webhook) agent runs where there is
+ * no human on the other end.  Events are buffered in memory so callers can
+ * inspect the full run after completion.
+ */
+export declare class HeadlessTransport implements Transport {
+    private readonly _events;
+    private _closed;
+    emit(event: AgentEvent): void;
+    onInput(_handler: (input: string) => void): Unsubscribe;
+    close(): void;
+    /** All events emitted during the run, in order. */
+    getEvents(): AgentEvent[];
+    /** Concatenated text output (all 'token' events). */
+    getOutput(): string;
+    get isClosed(): boolean;
+}
+//# sourceMappingURL=HeadlessTransport.d.ts.map

package/dist/transport/HeadlessTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeadlessTransport.d.ts","sourceRoot":"","sources":["../../src/transport/HeadlessTransport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAEtF;;;;;;GAMG;AACH,qBAAa,iBAAkB,YAAW,SAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,OAAO,CAAS;IAExB,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAK7B,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,WAAW;IAKvD,KAAK,IAAI,IAAI;IAIb,mDAAmD;IACnD,SAAS,IAAI,UAAU,EAAE;IAIzB,qDAAqD;IACrD,SAAS,IAAI,MAAM;IAQnB,IAAI,QAAQ,IAAI,OAAO,CAEtB;CACJ"}

package/dist/transport/HeadlessTransport.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HeadlessTransport = void 0;
+/**
+ * A transport with no outbound socket.
+ *
+ * Used by TriggerBus for autonomous (cron/webhook) agent runs where there is
+ * no human on the other end.  Events are buffered in memory so callers can
+ * inspect the full run after completion.
+ */
+class HeadlessTransport {
+    _events = [];
+    _closed = false;
+    emit(event) {
+        if (this._closed)
+            return;
+        this._events.push(event);
+    }
+    onInput(_handler) {
+        // Headless transports never receive human input mid-run.
+        return () => { };
+    }
+    close() {
+        this._closed = true;
+    }
+    /** All events emitted during the run, in order. */
+    getEvents() {
+        return [...this._events];
+    }
+    /** Concatenated text output (all 'token' events). */
+    getOutput() {
+        return this._events
+            .filter((e) => e.type === 'token' && 'content' in e)
+            .map(e => e.content)
+            .join('');
+    }
+    get isClosed() {
+        return this._closed;
+    }
+}
+exports.HeadlessTransport = HeadlessTransport;
+//# sourceMappingURL=HeadlessTransport.js.map

package/dist/transport/HeadlessTransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeadlessTransport.js","sourceRoot":"","sources":["../../src/transport/HeadlessTransport.ts"],"names":[],"mappings":";;;AAEA;;;;;;GAMG;AACH,MAAa,iBAAiB;IACT,OAAO,GAAiB,EAAE,CAAC;IACpC,OAAO,GAAG,KAAK,CAAC;IAExB,IAAI,CAAC,KAAiB;QAClB,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,CAAC,QAAiC;QACrC,yDAAyD;QACzD,OAAO,GAAG,EAAE,GAAe,CAAC,CAAC;IACjC,CAAC;IAED,KAAK;QACD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACxB,CAAC;IAED,mDAAmD;IACnD,SAAS;QACL,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED,qDAAqD;IACrD,SAAS;QACL,OAAO,IAAI,CAAC,OAAO;aACd,MAAM,CAAC,CAAC,CAAC,EAAwD,EAAE,CAChE,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,SAAS,IAAI,CAAC,CAAC;aACxC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;aACnB,IAAI,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,QAAQ;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;CACJ;AAnCD,8CAmCC"}

package/dist/trigger/TriggerBus.d.ts

@@ -0,0 +1,98 @@
+import type { FastifyInstance } from 'fastify';
+import type { AgentEngine, AgentEvent, Transport } from '@backendkit-labs/agent-core';
+import type { MonitorBus } from '../monitor/MonitorBus';
+/**
+ * Engine factory signature compatible with TriggerBus (and createEnterpriseSetup).
+ * Uses the base Transport interface so HeadlessTransport can be passed.
+ */
+export type TriggerEngineFactory = (sessionId: string, transport: Transport) => AgentEngine;
+export interface TriggerResult {
+    sessionId: string;
+    triggerName: string;
+    firedAt: Date;
+    durationMs: number;
+    output: string;
+    events: AgentEvent[];
+}
+export interface TriggerDefinition {
+    /** Human-readable name — shown in logs and MonitorBus. */
+    name: string;
+    /**
+     * Build the agent prompt from the trigger payload.
+     * For cron triggers payload is undefined; for webhooks it's the parsed body.
+     */
+    buildPrompt: (payload?: unknown) => string | Promise<string>;
+    /** Called after a successful run. */
+    onComplete?: (result: TriggerResult) => void | Promise<void>;
+    /** Called when the run throws. */
+    onError?: (err: Error, triggerName: string) => void | Promise<void>;
+}
+export interface CronTriggerDef extends TriggerDefinition {
+    /** Standard 5-field cron expression (e.g. '0 9 * * 1-5'). */
+    schedule: string;
+    /** If true, fire once immediately when TriggerBus.start() is called. */
+    runOnStart?: boolean;
+}
+export interface WebhookTriggerDef extends TriggerDefinition {
+    /**
+     * Fastify route path (e.g. '/triggers/github').
+     * Must start with '/'.
+     */
+    path: string;
+    /** HTTP method accepted. Default: 'POST'. */
+    method?: 'GET' | 'POST' | 'PUT';
+    /**
+     * Optional HMAC secret.  When set, validates the incoming request against
+     * X-Hub-Signature-256 (GitHub-compatible) before firing the trigger.
+     */
+    secret?: string;
+}
+/**
+ * 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();
+ * ```
+ */
+export declare class TriggerBus {
+    private readonly engineFactory;
+    private readonly monitorBus?;
+    private readonly cronDefs;
+    private readonly webhookDefs;
+    private cronTasks;
+    private started;
+    constructor(engineFactory: TriggerEngineFactory, monitorBus?: MonitorBus | undefined);
+    addCron(def: CronTriggerDef): this;
+    addWebhook(def: WebhookTriggerDef): this;
+    /** Register webhook routes on a Fastify instance. Called by AgentServer. */
+    registerRoutes(app: FastifyInstance): void;
+    start(): void;
+    close(): void;
+    private startCrons;
+    private fire;
+}
+//# sourceMappingURL=TriggerBus.d.ts.map

package/dist/trigger/TriggerBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TriggerBus.d.ts","sourceRoot":"","sources":["../../src/trigger/TriggerBus.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAEtF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAIxD;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,KAAK,WAAW,CAAC;AAE5F,MAAM,WAAW,aAAa;IAC1B,SAAS,EAAI,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAM,IAAI,CAAC;IAClB,UAAU,EAAG,MAAM,CAAC;IACpB,MAAM,EAAO,MAAM,CAAC;IACpB,MAAM,EAAO,UAAU,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAC9B,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,WAAW,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7D,qCAAqC;IACrC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,kCAAkC;IAClC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,cAAe,SAAQ,iBAAiB;IACrD,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IACxD;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;IAChC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,UAAU;IAQf,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IARhC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IACvD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA2B;IAEvD,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,OAAO,CAAS;gBAGH,aAAa,EAAE,oBAAoB,EACnC,UAAU,CAAC,EAAE,UAAU,YAAA;IAG5C,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI;IAKlC,UAAU,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI;IAOxC,4EAA4E;IAC5E,cAAc,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IAsB1C,KAAK,IAAI,IAAI;IAMb,KAAK,IAAI,IAAI;IAUb,OAAO,CAAC,UAAU;YAiCJ,IAAI;CAuCrB"}