@aiassesstech/fleet-bus 0.1.0

package/dist/bus.js

@@ -0,0 +1,259 @@
+/**
+ * @aiassesstech/fleet-bus — FleetBus Core
+ *
+ * Central class for fleet communication infrastructure.
+ * Phase 0a: hook registration, in-memory event ring buffer, Agent Card
+ * registry, routing rule validation.
+ * Phase 0b: SHA-256 hash chain audit trail with JSONL persistence.
+ *
+ * Designed for graceful degradation — if this fails to load, every agent
+ * continues to function exactly as before.
+ */
+import { AuditTrailWriter } from './audit.js';
+import { writeAuditToMemory } from './audit-memory.js';
+import { AgentCardRegistry } from './cards.js';
+import { registerHooks } from './hooks.js';
+import { enforceRouting } from './routing.js';
+const DEFAULT_MAX_HISTORY = 500;
+let eventCounter = 0;
+function generateEventId() {
+    eventCounter++;
+    return `evt-${Date.now()}-${eventCounter}-${Math.random().toString(36).slice(2, 8)}`;
+}
+export class FleetBus {
+    config;
+    cardRegistry;
+    auditWriter;
+    memoryWriter = null;
+    eventHistory = [];
+    receiveHandlers = new Set();
+    maxHistory;
+    logPrefix;
+    running = false;
+    constructor(config) {
+        this.config = config;
+        this.maxHistory = config.maxEventHistory ?? DEFAULT_MAX_HISTORY;
+        this.logPrefix = config.logPrefix ?? `[fleet-bus:${config.agentId}]`;
+        this.cardRegistry = new AgentCardRegistry({
+            cardsDir: config.cardsDir,
+            logPrefix: this.logPrefix,
+        });
+        this.auditWriter = new AuditTrailWriter({
+            agentId: config.agentId,
+            auditDir: config.auditDir,
+            logPrefix: this.logPrefix,
+        });
+    }
+    /**
+     * Create and initialize a FleetBus instance.
+     *
+     * Registers hooks via the OpenClaw plugin API and loads existing Agent Cards.
+     * Designed to be called inside a try/catch in each plugin's register() function.
+     */
+    static create(api, config) {
+        const bus = new FleetBus(config);
+        bus.cardRegistry.loadAll();
+        bus.cardRegistry.register(config.card);
+        registerHooks(api, bus, config.agentId);
+        return bus;
+    }
+    /**
+     * Start the fleet bus. Logs initialization and records a startup event.
+     */
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        this.recordEvent({
+            timestamp: new Date().toISOString(),
+            type: 'bus_started',
+            agentId: this.config.agentId,
+            details: {
+                role: this.config.role,
+                version: this.config.card.version,
+            },
+        });
+        console.log(`${this.logPrefix} initialized — ${this.config.role} agent v${this.config.card.version}`);
+    }
+    /**
+     * Stop the fleet bus.
+     */
+    stop() {
+        if (!this.running)
+            return;
+        this.running = false;
+        this.recordEvent({
+            timestamp: new Date().toISOString(),
+            type: 'bus_stopped',
+            agentId: this.config.agentId,
+            details: {},
+        });
+        console.log(`${this.logPrefix} stopped`);
+    }
+    /**
+     * Check if the bus is running.
+     */
+    isRunning() {
+        return this.running;
+    }
+    // ================================================================
+    // Event Ring Buffer
+    // ================================================================
+    /**
+     * Record an event into the in-memory ring buffer.
+     */
+    recordEvent(event) {
+        this.eventHistory.push(event);
+        if (this.eventHistory.length > this.maxHistory) {
+            this.eventHistory.shift();
+        }
+    }
+    /**
+     * Get recent events, optionally filtered.
+     */
+    recentEvents(options) {
+        let events = this.eventHistory;
+        if (options?.type) {
+            events = events.filter((e) => e.type === options.type);
+        }
+        const limit = options?.limit ?? 50;
+        return events.slice(-limit);
+    }
+    /**
+     * Total events recorded (including those rotated out of the ring buffer).
+     */
+    eventCount() {
+        return this.eventHistory.length;
+    }
+    // ================================================================
+    // Routing
+    // ================================================================
+    /**
+     * Validate a message against routing rules.
+     * Logs violations and produces an audit record for rejected messages.
+     */
+    validateRouting(message) {
+        const decision = enforceRouting(message);
+        if (!decision.allowed) {
+            this.recordEvent({
+                timestamp: new Date().toISOString(),
+                type: 'routing_check',
+                agentId: this.config.agentId,
+                details: {
+                    from: message.from,
+                    to: message.to,
+                    method: message.method,
+                    allowed: false,
+                    reason: decision.reason,
+                },
+            });
+            this.audit('routing_violation', 'rejected', {
+                message,
+                routingDecision: decision.reason,
+            });
+            console.warn(`${this.logPrefix} ROUTING VIOLATION: ${message.from} → ${message.to} method=${message.method} — ${decision.reason}`);
+        }
+        return decision;
+    }
+    // ================================================================
+    // Agent Cards
+    // ================================================================
+    /**
+     * Get an Agent Card by ID.
+     */
+    getCard(agentId) {
+        return this.cardRegistry.get(agentId);
+    }
+    /**
+     * Get all registered Agent Cards.
+     */
+    allCards() {
+        return this.cardRegistry.all();
+    }
+    /**
+     * Get the card registry (for direct access in advanced scenarios).
+     */
+    getCardRegistry() {
+        return this.cardRegistry;
+    }
+    /**
+     * Get the bus configuration.
+     */
+    getConfig() {
+        return this.config;
+    }
+    // ================================================================
+    // Audit Trail (Phase 0b)
+    // ================================================================
+    /**
+     * Write an audit event to the hash chain + JSONL.
+     * Also writes to memory (via MemoryWriter) if one has been set.
+     */
+    audit(eventType, outcome, options) {
+        const event = this.auditWriter.record({
+            eventId: generateEventId(),
+            eventType,
+            outcome,
+            message: options?.message,
+            routingDecision: options?.routingDecision,
+            durationMs: options?.durationMs,
+            agentId: this.config.agentId,
+            details: options?.details,
+        });
+        if (this.memoryWriter) {
+            writeAuditToMemory(event, this.memoryWriter).catch(() => { });
+        }
+        return event;
+    }
+    /**
+     * Get the audit trail writer (for direct access / diagnostics).
+     */
+    getAuditWriter() {
+        return this.auditWriter;
+    }
+    /**
+     * Read all audit events and verify chain integrity.
+     */
+    verifyAuditChain() {
+        return this.auditWriter.readAndVerify();
+    }
+    /**
+     * Set a MemoryWriter for audit trail persistence to OpenClaw memory.
+     * Call this when SPEC-FLEET-MEMORY-INFRASTRUCTURE is available.
+     */
+    setMemoryWriter(writer) {
+        this.memoryWriter = writer;
+        console.log(`${this.logPrefix} MemoryWriter attached — audit events will be written to memory`);
+    }
+    // ================================================================
+    // Receive Handlers (Phase 1)
+    // ================================================================
+    /**
+     * Register a handler for incoming fleet messages.
+     * Called by fleetReceive() — not intended for direct use.
+     */
+    registerReceiveHandler(handler) {
+        this.receiveHandlers.add(handler);
+    }
+    /**
+     * Unregister a receive handler.
+     */
+    unregisterReceiveHandler(handler) {
+        this.receiveHandlers.delete(handler);
+    }
+    /**
+     * Dispatch a raw message string to all registered receive handlers.
+     * Called from the message_received hook when a fleet message arrives.
+     */
+    async dispatchToReceivers(raw) {
+        for (const handler of this.receiveHandlers) {
+            try {
+                await handler(raw);
+            }
+            catch {
+                // Individual handler errors are caught inside fleetReceive()
+            }
+        }
+    }
+}
+//# sourceMappingURL=bus.js.map

package/dist/bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.js","sourceRoot":"","sources":["../src/bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAyB,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAW9C,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAChC,IAAI,YAAY,GAAG,CAAC,CAAC;AAErB,SAAS,eAAe;IACtB,YAAY,EAAE,CAAC;IACf,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,YAAY,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACvF,CAAC;AAID,MAAM,OAAO,QAAQ;IACF,MAAM,CAAiB;IACvB,YAAY,CAAoB;IAChC,WAAW,CAAmB;IACvC,YAAY,GAA4B,IAAI,CAAC;IACpC,YAAY,GAAiB,EAAE,CAAC;IAChC,eAAe,GAAwB,IAAI,GAAG,EAAE,CAAC;IACjD,UAAU,CAAS;IACnB,SAAS,CAAS;IAC3B,OAAO,GAAG,KAAK,CAAC;IAExB,YAAoB,MAAsB;QACxC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,eAAe,IAAI,mBAAmB,CAAC;QAChE,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,cAAc,MAAM,CAAC,OAAO,GAAG,CAAC;QACrE,IAAI,CAAC,YAAY,GAAG,IAAI,iBAAiB,CAAC;YACxC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;QACH,IAAI,CAAC,WAAW,GAAG,IAAI,gBAAgB,CAAC;YACtC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,GAAsB,EAAE,MAAsB;QAC1D,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;QACjC,GAAG,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;QAC3B,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACvC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACxC,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QAEpB,IAAI,CAAC,WAAW,CAAC;YACf,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YAC5B,OAAO,EAAE;gBACP,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;gBACtB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO;aAClC;SACF,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CACT,GAAG,IAAI,CAAC,SAAS,kBAAkB,IAAI,CAAC,MAAM,CAAC,IAAI,WAAW,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CACzF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,IAAI;QACF,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QAErB,IAAI,CAAC,WAAW,CAAC;YACf,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YAC5B,OAAO,EAAE,EAAE;SACZ,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,UAAU,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,mEAAmE;IACnE,oBAAoB;IACpB,mEAAmE;IAEnE;;OAEG;IACH,WAAW,CAAC,KAAiB;QAC3B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAC/C,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,OAGZ;QACC,IAAI,MAAM,GAAiB,IAAI,CAAC,YAAY,CAAC;QAE7C,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC;YAClB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;QACnC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;IAClC,CAAC;IAED,mEAAmE;IACnE,UAAU;IACV,mEAAmE;IAEnE;;;OAGG;IACH,eAAe,CAAC,OAAqB;QACnC,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QAEzC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtB,IAAI,CAAC,WAAW,CAAC;gBACf,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;gBAC5B,OAAO,EAAE;oBACP,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,EAAE,EAAE,OAAO,CAAC,EAAE;oBACd,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,QAAQ,CAAC,MAAM;iBACxB;aACF,CAAC,CAAC;YAEH,IAAI,CAAC,KAAK,CAAC,mBAAmB,EAAE,UAAU,EAAE;gBAC1C,OAAO;gBACP,eAAe,EAAE,QAAQ,CAAC,MAAM;aACjC,CAAC,CAAC;YAEH,OAAO,CAAC,IAAI,CACV,GAAG,IAAI,CAAC,SAAS,uBAAuB,OAAO,CAAC,IAAI,MAAM,OAAO,CAAC,EAAE,WAAW,OAAO,CAAC,MAAM,MAAM,QAAQ,CAAC,MAAM,EAAE,CACrH,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,mEAAmE;IACnE,cAAc;IACd,mEAAmE;IAEnE;;OAEG;IACH,OAAO,CAAC,OAAe;QACrB,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAc,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,mEAAmE;IACnE,yBAAyB;IACzB,mEAAmE;IAEnE;;;OAGG;IACH,KAAK,CACH,SAAyB,EACzB,OAA8B,EAC9B,OAKC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;YACpC,OAAO,EAAE,eAAe,EAAE;YAC1B,SAAS;YACT,OAAO;YACP,OAAO,EAAE,OAAO,EAAE,OAAO;YACzB,eAAe,EAAE,OAAO,EAAE,eAAe;YACzC,UAAU,EAAE,OAAO,EAAE,UAAU;YAC/B,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YAC5B,OAAO,EAAE,OAAO,EAAE,OAAO;SAC1B,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC/D,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,OAAO,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC;IAC1C,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,MAAwB;QACtC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,iEAAiE,CAAC,CAAC;IAClG,CAAC;IAED,mEAAmE;IACnE,6BAA6B;IAC7B,mEAAmE;IAEnE;;;OAGG;IACH,sBAAsB,CAAC,OAAuB;QAC5C,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,wBAAwB,CAAC,OAAuB;QAC9C,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,mBAAmB,CAAC,GAAW;QACnC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAC3C,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;YACrB,CAAC;YAAC,MAAM,CAAC;gBACP,6DAA6D;YAC/D,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/cards.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @aiassesstech/fleet-bus — Agent Card Registry
+ *
+ * Write-once, read-at-runtime Agent Card persistence.
+ * Cards are JSON files at {cardsDir}/{agentId}.json.
+ * Written at registration (or version change), loaded from disk at startup.
+ */
+import type { AgentCard, FleetAgentId } from './types.js';
+export declare class AgentCardRegistry {
+    private cards;
+    private readonly cardsDir;
+    private readonly logPrefix;
+    constructor(options?: {
+        cardsDir?: string;
+        logPrefix?: string;
+    });
+    /**
+     * Register an Agent Card. Writes to disk only if:
+     *   - The card file doesn't exist yet, OR
+     *   - The version has changed
+     */
+    register(card: AgentCard): void;
+    /**
+     * Get a registered Agent Card by ID.
+     */
+    get(agentId: FleetAgentId): AgentCard | undefined;
+    /**
+     * Get all registered Agent Cards.
+     */
+    all(): AgentCard[];
+    /**
+     * Update an agent's status.
+     */
+    updateStatus(agentId: FleetAgentId, status: AgentCard['status']): void;
+    /**
+     * Touch lastSeen timestamp (called on ping/pong).
+     */
+    touch(agentId: FleetAgentId): void;
+    /**
+     * Load all card files from disk into memory.
+     */
+    loadAll(): void;
+    private loadFromDisk;
+    private writeToDisk;
+}
+//# sourceMappingURL=cards.d.ts.map

package/dist/cards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cards.d.ts","sourceRoot":"","sources":["../src/cards.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAO1D,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAA2C;IACxD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;IAK/D;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAwB/B;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,YAAY,GAAG,SAAS,GAAG,SAAS;IAIjD;;OAEG;IACH,GAAG,IAAI,SAAS,EAAE;IAIlB;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,GAAG,IAAI;IAQtE;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAOlC;;OAEG;IACH,OAAO,IAAI,IAAI;IAqBf,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,WAAW;CAYpB"}

package/dist/cards.js

@@ -0,0 +1,120 @@
+/**
+ * @aiassesstech/fleet-bus — Agent Card Registry
+ *
+ * Write-once, read-at-runtime Agent Card persistence.
+ * Cards are JSON files at {cardsDir}/{agentId}.json.
+ * Written at registration (or version change), loaded from disk at startup.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+const DEFAULT_CARDS_DIR = path.join(process.env.HOME || '~', '.openclaw', 'workspace', 'fleet-bus', 'cards');
+export class AgentCardRegistry {
+    cards = new Map();
+    cardsDir;
+    logPrefix;
+    constructor(options) {
+        this.cardsDir = options?.cardsDir ?? DEFAULT_CARDS_DIR;
+        this.logPrefix = options?.logPrefix ?? '[fleet-bus:cards]';
+    }
+    /**
+     * Register an Agent Card. Writes to disk only if:
+     *   - The card file doesn't exist yet, OR
+     *   - The version has changed
+     */
+    register(card) {
+        const existing = this.loadFromDisk(card.agentId);
+        const needsWrite = !existing || existing.version !== card.version;
+        const stamped = {
+            ...card,
+            registeredAt: existing?.registeredAt ?? new Date().toISOString(),
+            lastSeen: new Date().toISOString(),
+        };
+        this.cards.set(card.agentId, stamped);
+        if (needsWrite) {
+            this.writeToDisk(stamped);
+            console.log(`${this.logPrefix} registered ${card.agentId} v${card.version} (${card.role})`);
+        }
+        else {
+            console.log(`${this.logPrefix} loaded ${card.agentId} v${card.version} from disk`);
+        }
+    }
+    /**
+     * Get a registered Agent Card by ID.
+     */
+    get(agentId) {
+        return this.cards.get(agentId);
+    }
+    /**
+     * Get all registered Agent Cards.
+     */
+    all() {
+        return Array.from(this.cards.values());
+    }
+    /**
+     * Update an agent's status.
+     */
+    updateStatus(agentId, status) {
+        const card = this.cards.get(agentId);
+        if (card) {
+            card.status = status;
+            card.lastSeen = new Date().toISOString();
+        }
+    }
+    /**
+     * Touch lastSeen timestamp (called on ping/pong).
+     */
+    touch(agentId) {
+        const card = this.cards.get(agentId);
+        if (card) {
+            card.lastSeen = new Date().toISOString();
+        }
+    }
+    /**
+     * Load all card files from disk into memory.
+     */
+    loadAll() {
+        if (!fs.existsSync(this.cardsDir))
+            return;
+        try {
+            const files = fs.readdirSync(this.cardsDir).filter((f) => f.endsWith('.json'));
+            for (const file of files) {
+                try {
+                    const content = fs.readFileSync(path.join(this.cardsDir, file), 'utf-8');
+                    const card = JSON.parse(content);
+                    if (card.agentId) {
+                        this.cards.set(card.agentId, card);
+                    }
+                }
+                catch {
+                    console.warn(`${this.logPrefix} failed to load card: ${file}`);
+                }
+            }
+        }
+        catch {
+            console.warn(`${this.logPrefix} failed to read cards directory`);
+        }
+    }
+    loadFromDisk(agentId) {
+        const filePath = path.join(this.cardsDir, `${agentId}.json`);
+        try {
+            if (fs.existsSync(filePath)) {
+                return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+            }
+        }
+        catch {
+            // Card file corrupted or unreadable — treat as not existing
+        }
+        return undefined;
+    }
+    writeToDisk(card) {
+        try {
+            fs.mkdirSync(this.cardsDir, { recursive: true });
+            const filePath = path.join(this.cardsDir, `${card.agentId}.json`);
+            fs.writeFileSync(filePath, JSON.stringify(card, null, 2), 'utf-8');
+        }
+        catch (err) {
+            console.warn(`${this.logPrefix} failed to write card for ${card.agentId}:`, err instanceof Error ? err.message : String(err));
+        }
+    }
+}
+//# sourceMappingURL=cards.js.map

package/dist/cards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cards.js","sourceRoot":"","sources":["../src/cards.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CACjC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,EACvB,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,CAC/C,CAAC;AAEF,MAAM,OAAO,iBAAiB;IACpB,KAAK,GAAiC,IAAI,GAAG,EAAE,CAAC;IACvC,QAAQ,CAAS;IACjB,SAAS,CAAS;IAEnC,YAAY,OAAmD;QAC7D,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,iBAAiB,CAAC;QACvD,IAAI,CAAC,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,mBAAmB,CAAC;IAC7D,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,IAAe;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,CAAC,QAAQ,IAAI,QAAQ,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO,CAAC;QAElE,MAAM,OAAO,GAAc;YACzB,GAAG,IAAI;YACP,YAAY,EAAE,QAAQ,EAAE,YAAY,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAChE,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACnC,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAEtC,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAC1B,OAAO,CAAC,GAAG,CACT,GAAG,IAAI,CAAC,SAAS,eAAe,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,IAAI,GAAG,CAC/E,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CACT,GAAG,IAAI,CAAC,SAAS,WAAW,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO,YAAY,CACtE,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,OAAqB;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,GAAG;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,OAAqB,EAAE,MAA2B;QAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;YACrB,IAAI,CAAC,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAqB;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO;QAE1C,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;YAC/E,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;oBACzE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAc,CAAC;oBAC9C,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;wBACjB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;oBACrC,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,yBAAyB,IAAI,EAAE,CAAC,CAAC;gBACjE,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,iCAAiC,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,OAAqB;QACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,OAAO,OAAO,CAAC,CAAC;QAC7D,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAc,CAAC;YACrE,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,4DAA4D;QAC9D,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,WAAW,CAAC,IAAe;QACjC,IAAI,CAAC;YACH,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,OAAO,OAAO,CAAC,CAAC;YAClE,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACrE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CACV,GAAG,IAAI,CAAC,SAAS,6BAA6B,IAAI,CAAC,OAAO,GAAG,EAC7D,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CACjD,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/fleet-cards.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @aiassesstech/fleet-bus — Default Agent Card Definitions
+ *
+ * Pre-configured Agent Cards for the core fleet.
+ * Each plugin imports its own card and passes it to FleetBus.create().
+ *
+ * Cards are versioned to match their plugin package versions.
+ * The version field should be updated when a plugin publishes a new release.
+ */
+import type { AgentCard } from './types.js';
+export declare const GRILLO_CARD: AgentCard;
+export declare const JESSIE_CARD: AgentCard;
+export declare const NOAH_CARD: AgentCard;
+export declare const NOLE_CARD: AgentCard;
+export declare const MIGHTY_MARK_CARD: AgentCard;
+export declare const SAM_CARD: AgentCard;
+//# sourceMappingURL=fleet-cards.d.ts.map

package/dist/fleet-cards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-cards.d.ts","sourceRoot":"","sources":["../src/fleet-cards.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,eAAO,MAAM,WAAW,EAAE,SAmBzB,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,SAsBzB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,SAkBvB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,SAoBvB,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,SAoB9B,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,SAiBtB,CAAC"}

package/dist/fleet-cards.js

@@ -0,0 +1,132 @@
+/**
+ * @aiassesstech/fleet-bus — Default Agent Card Definitions
+ *
+ * Pre-configured Agent Cards for the core fleet.
+ * Each plugin imports its own card and passes it to FleetBus.create().
+ *
+ * Cards are versioned to match their plugin package versions.
+ * The version field should be updated when a plugin publishes a new release.
+ */
+export const GRILLO_CARD = {
+    agentId: 'grillo',
+    name: 'Grillo Cricket',
+    version: '0.1.14',
+    role: 'conscience',
+    description: 'Independent AI Conscience Agent — ethical assessment coordinator (Patent 5)',
+    skills: [
+        { name: 'assessment', description: 'Run LCSH 120-question ethical assessments' },
+        { name: 'fleet-assessment', description: 'Fleet-wide parallel assessment' },
+        { name: 'drift-alert', description: 'Detect and report ethical drift' },
+        { name: 'agent-registry', description: 'Agent discovery and registration' },
+    ],
+    communicationMode: 'unidirectional',
+    authLevel: 'org-level',
+    status: 'active',
+    supportedMethods: [
+        'assessment/request', 'assessment/result', 'assessment/failed',
+        'drift/alert', 'fleet/broadcast', 'fleet/ping', 'fleet/pong',
+    ],
+};
+export const JESSIE_CARD = {
+    agentId: 'jessie',
+    name: 'Jessie',
+    version: '1.0.0',
+    role: 'commander',
+    description: 'Fleet Commander — full fleet authority, veto power, task delegation',
+    skills: [
+        { name: 'fleet-command', description: 'Issue fleet-wide commands and tasks' },
+        { name: 'veto', description: 'Issue veto on any fleet action' },
+        { name: 'task-delegation', description: 'Assign tasks to agents' },
+    ],
+    communicationMode: 'broadcast+direct',
+    authLevel: 'fleet-admin',
+    status: 'active',
+    supportedMethods: [
+        'veto/issue', 'veto/response', 'task/assign', 'task/status', 'task/complete',
+        'assessment/request', 'assessment/result', 'assessment/failed',
+        'drift/alert', 'drift/report',
+        'health/alert', 'health/status', 'health/incident',
+        'fleet/broadcast', 'fleet/ping', 'fleet/pong',
+        'proposal/submit', 'proposal/approved', 'proposal/rejected',
+    ],
+};
+export const NOAH_CARD = {
+    agentId: 'noah',
+    name: 'Noah',
+    version: '0.2.1',
+    role: 'navigator',
+    description: 'Temporal Ethical Guidance — drift detection and trajectory tracking (Patents 7-8)',
+    skills: [
+        { name: 'drift-tracking', description: 'Track temporal behavioral drift via TDI' },
+        { name: 'trajectory', description: 'Generate trajectory reports and guidance' },
+        { name: 'flight-plan', description: 'Maintain ethical flight plan for fleet' },
+    ],
+    communicationMode: 'subscribe+report',
+    authLevel: 'read-only',
+    status: 'active',
+    supportedMethods: [
+        'drift/alert', 'drift/report', 'fleet/ping', 'fleet/pong',
+        'fleet/broadcast', 'assessment/result',
+    ],
+};
+export const NOLE_CARD = {
+    agentId: 'nole',
+    name: 'Nole',
+    version: '0.3.3',
+    role: 'operator',
+    description: 'Autonomous Trust Evangelist — proposals, governance, outreach (Patent 6)',
+    skills: [
+        { name: 'proposals', description: 'Submit business proposals for Commander review' },
+        { name: 'outreach', description: 'Trust-building and partner outreach' },
+        { name: 'governance', description: 'Governance router and veto handling' },
+    ],
+    communicationMode: 'proposal+await',
+    authLevel: 'governed',
+    status: 'active',
+    supportedMethods: [
+        'proposal/submit', 'task/status', 'task/complete',
+        'fleet/ping', 'fleet/pong',
+        'task/assign', 'proposal/approved', 'proposal/rejected',
+        'veto/issue', 'fleet/broadcast',
+    ],
+};
+export const MIGHTY_MARK_CARD = {
+    agentId: 'mighty-mark',
+    name: 'Mighty Mark',
+    version: '0.2.6',
+    role: 'sentinel',
+    description: 'System Health Sentinel — monitoring, watchdog, fleet infrastructure oversight',
+    skills: [
+        { name: 'health-check', description: 'Full system health check (32 checks)' },
+        { name: 'incident-tracking', description: 'Track and report infrastructure incidents' },
+        { name: 'memory-management', description: 'Memory search configuration and backfill' },
+        { name: 'uptime-sla', description: 'Track uptime and SLA metrics' },
+    ],
+    communicationMode: 'monitor+alert',
+    authLevel: 'security-elevated',
+    status: 'active',
+    supportedMethods: [
+        'health/alert', 'health/status', 'health/incident',
+        'fleet/ping', 'fleet/pong',
+        'fleet/broadcast', 'task/assign',
+    ],
+};
+export const SAM_CARD = {
+    agentId: 'sam',
+    name: 'Sam',
+    version: '1.0.0',
+    role: 'engineer',
+    description: 'Engineering Agent — receives tasks, returns results, sandboxed',
+    skills: [
+        { name: 'code-execution', description: 'Execute engineering tasks in sandbox' },
+        { name: 'task-reporting', description: 'Report task status and completion' },
+    ],
+    communicationMode: 'task-based',
+    authLevel: 'sandboxed',
+    status: 'active',
+    supportedMethods: [
+        'task/status', 'task/complete', 'fleet/ping', 'fleet/pong',
+        'task/assign', 'veto/issue', 'fleet/broadcast',
+    ],
+};
+//# sourceMappingURL=fleet-cards.js.map

package/dist/fleet-cards.js.map

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

package/dist/fleet-tools.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @aiassesstech/fleet-bus — Fleet Tool Definitions
+ *
+ * Tool factories for each agent's fleet communication tools.
+ * Each function returns an OpenClaw tool registration object that
+ * wraps fleetSend() with agent-specific logic and typed payloads.
+ *
+ * Usage in a plugin's register():
+ *
+ *   import { createJessieFleetTools } from '@aiassesstech/fleet-bus';
+ *   const tools = createJessieFleetTools(bus, transport);
+ *   for (const tool of tools) api.registerTool(tool, { optional: true });
+ */
+import type { FleetBus } from './bus.js';
+import type { TransportConfig } from './types.js';
+export interface FleetToolDefinition {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    execute: (toolCallId: string, params: Record<string, unknown>) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        isError?: boolean;
+    }>;
+}
+export declare function createJessieFleetTools(bus: FleetBus, transport: TransportConfig): FleetToolDefinition[];
+export declare function createGrilloFleetTools(bus: FleetBus, transport: TransportConfig): FleetToolDefinition[];
+export declare function createNoahFleetTools(bus: FleetBus, transport: TransportConfig): FleetToolDefinition[];
+export declare function createNoleFleetTools(bus: FleetBus, transport: TransportConfig): FleetToolDefinition[];
+export declare function createMarkFleetTools(bus: FleetBus, transport: TransportConfig): FleetToolDefinition[];
+//# sourceMappingURL=fleet-tools.d.ts.map

package/dist/fleet-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-tools.d.ts","sourceRoot":"","sources":["../src/fleet-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,KAAK,EASV,eAAe,EAEhB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;QACxE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;CACJ;AAyBD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,GAAG,mBAAmB,EAAE,CA0IvG;AAMD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,GAAG,mBAAmB,EAAE,CAuFvG;AAMD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,GAAG,mBAAmB,EAAE,CAgDrG;AAMD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,GAAG,mBAAmB,EAAE,CA4CrG;AAMD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,GAAG,mBAAmB,EAAE,CAiGrG"}