reflectt-node 0.1.0

package/dist/notifications.js

@@ -0,0 +1,253 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) Reflectt AI
+/**
+ * Notification Preferences
+ *
+ * Per-agent notification configuration:
+ *   - Channel preferences (which channels each agent wants notifications from)
+ *   - Priority thresholds (minimum priority to notify)
+ *   - Quiet hours (suppress notifications during off hours)
+ *   - Delivery method preferences (inbox, mention, both)
+ *   - Event type filters (task_assigned, review_requested, etc.)
+ *
+ * Persisted in SQLite. Exposed via API for dashboard configuration.
+ */
+import { getDb } from './db.js';
+// ── Constants ──
+const DEFAULT_PREFS = {
+    enabled: true,
+    deliveryMethod: 'both',
+    priorityThreshold: 'all',
+    quietHours: {
+        enabled: false,
+        startHour: 22,
+        endHour: 7,
+        timezone: 'UTC',
+    },
+    eventFilters: {
+        taskAssigned: true,
+        taskCompleted: true,
+        reviewRequested: true,
+        reviewApproved: true,
+        mentionInChat: true,
+        taskComment: true,
+        statusChange: true,
+        webhookFailure: true,
+    },
+    channelSubscriptions: ['general', 'task-comments', 'reviews'],
+    mutedUntil: null,
+};
+// ── Schema ──
+const CREATE_TABLE = `
+  CREATE TABLE IF NOT EXISTS notification_preferences (
+    agent TEXT PRIMARY KEY,
+    enabled INTEGER NOT NULL DEFAULT 1,
+    delivery_method TEXT NOT NULL DEFAULT 'both',
+    priority_threshold TEXT NOT NULL DEFAULT 'all',
+    quiet_hours_enabled INTEGER NOT NULL DEFAULT 0,
+    quiet_hours_start INTEGER NOT NULL DEFAULT 22,
+    quiet_hours_end INTEGER NOT NULL DEFAULT 7,
+    quiet_hours_tz TEXT NOT NULL DEFAULT 'UTC',
+    event_filters TEXT NOT NULL DEFAULT '{}',
+    channel_subscriptions TEXT NOT NULL DEFAULT '[]',
+    muted_until INTEGER,
+    updated_at INTEGER NOT NULL
+  )
+`;
+// ── Notification Preferences Manager ──
+export class NotificationManager {
+    initialized = false;
+    init() {
+        if (this.initialized)
+            return;
+        const db = getDb();
+        db.exec(CREATE_TABLE);
+        this.initialized = true;
+    }
+    /** Get preferences for an agent (returns defaults if none configured) */
+    getPreferences(agent) {
+        this.ensureInit();
+        const db = getDb();
+        const row = db.prepare('SELECT * FROM notification_preferences WHERE agent = ?').get(agent);
+        if (!row) {
+            return { agent, ...DEFAULT_PREFS, updatedAt: 0 };
+        }
+        return this.rowToPrefs(row);
+    }
+    /** Get preferences for all agents */
+    getAllPreferences() {
+        this.ensureInit();
+        const db = getDb();
+        const rows = db.prepare('SELECT * FROM notification_preferences ORDER BY agent').all();
+        return rows.map(r => this.rowToPrefs(r));
+    }
+    /** Update preferences for an agent (partial update) */
+    updatePreferences(agent, patch) {
+        this.ensureInit();
+        const current = this.getPreferences(agent);
+        const now = Date.now();
+        const updated = {
+            ...current,
+            ...patch,
+            agent,
+            quietHours: {
+                ...current.quietHours,
+                ...(patch.quietHours || {}),
+            },
+            eventFilters: {
+                ...current.eventFilters,
+                ...(patch.eventFilters || {}),
+            },
+            channelSubscriptions: patch.channelSubscriptions ?? current.channelSubscriptions,
+            updatedAt: now,
+        };
+        const db = getDb();
+        db.prepare(`
+      INSERT INTO notification_preferences (
+        agent, enabled, delivery_method, priority_threshold,
+        quiet_hours_enabled, quiet_hours_start, quiet_hours_end, quiet_hours_tz,
+        event_filters, channel_subscriptions, muted_until, updated_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT(agent) DO UPDATE SET
+        enabled = excluded.enabled,
+        delivery_method = excluded.delivery_method,
+        priority_threshold = excluded.priority_threshold,
+        quiet_hours_enabled = excluded.quiet_hours_enabled,
+        quiet_hours_start = excluded.quiet_hours_start,
+        quiet_hours_end = excluded.quiet_hours_end,
+        quiet_hours_tz = excluded.quiet_hours_tz,
+        event_filters = excluded.event_filters,
+        channel_subscriptions = excluded.channel_subscriptions,
+        muted_until = excluded.muted_until,
+        updated_at = excluded.updated_at
+    `).run(updated.agent, updated.enabled ? 1 : 0, updated.deliveryMethod, updated.priorityThreshold, updated.quietHours.enabled ? 1 : 0, updated.quietHours.startHour, updated.quietHours.endHour, updated.quietHours.timezone, JSON.stringify(updated.eventFilters), JSON.stringify(updated.channelSubscriptions), updated.mutedUntil, updated.updatedAt);
+        return updated;
+    }
+    /** Delete preferences for an agent (resets to defaults) */
+    resetPreferences(agent) {
+        this.ensureInit();
+        const db = getDb();
+        db.prepare('DELETE FROM notification_preferences WHERE agent = ?').run(agent);
+    }
+    /** Mute notifications for an agent until a given time */
+    mute(agent, untilMs) {
+        return this.updatePreferences(agent, { mutedUntil: untilMs });
+    }
+    /** Unmute notifications for an agent */
+    unmute(agent) {
+        return this.updatePreferences(agent, { mutedUntil: null });
+    }
+    /**
+     * Route a notification event through an agent's preferences.
+     * Returns whether to notify and via which method.
+     */
+    shouldNotify(event) {
+        const prefs = this.getPreferences(event.agent);
+        // Check if notifications are enabled
+        if (!prefs.enabled) {
+            return { shouldNotify: false, reason: 'notifications_disabled', deliveryMethod: 'none' };
+        }
+        // Check if muted
+        if (prefs.mutedUntil && Date.now() < prefs.mutedUntil) {
+            return { shouldNotify: false, reason: 'muted', deliveryMethod: 'none' };
+        }
+        // Check quiet hours
+        if (prefs.quietHours.enabled && this.isQuietHours(prefs.quietHours)) {
+            return { shouldNotify: false, reason: 'quiet_hours', deliveryMethod: 'none' };
+        }
+        // Check priority threshold
+        if (event.priority && !this.meetsPriorityThreshold(event.priority, prefs.priorityThreshold)) {
+            return { shouldNotify: false, reason: 'below_priority_threshold', deliveryMethod: 'none' };
+        }
+        // Check event filter
+        if (!prefs.eventFilters[event.type]) {
+            return { shouldNotify: false, reason: `event_type_${event.type}_disabled`, deliveryMethod: 'none' };
+        }
+        // Check channel subscription
+        if (event.channel && prefs.channelSubscriptions.length > 0) {
+            if (!prefs.channelSubscriptions.includes(event.channel)) {
+                return { shouldNotify: false, reason: 'channel_not_subscribed', deliveryMethod: 'none' };
+            }
+        }
+        return {
+            shouldNotify: true,
+            reason: 'preferences_match',
+            deliveryMethod: prefs.deliveryMethod,
+        };
+    }
+    // ── Private ──
+    ensureInit() {
+        if (!this.initialized)
+            this.init();
+    }
+    isQuietHours(qh) {
+        // Get current hour in the configured timezone
+        let currentHour;
+        try {
+            const formatter = new Intl.DateTimeFormat('en-US', {
+                hour: 'numeric',
+                hour12: false,
+                timeZone: qh.timezone,
+            });
+            currentHour = parseInt(formatter.format(new Date()), 10);
+        }
+        catch {
+            currentHour = new Date().getUTCHours();
+        }
+        if (qh.startHour <= qh.endHour) {
+            // Same-day range (e.g., 9-17)
+            return currentHour >= qh.startHour && currentHour < qh.endHour;
+        }
+        else {
+            // Overnight range (e.g., 22-7)
+            return currentHour >= qh.startHour || currentHour < qh.endHour;
+        }
+    }
+    meetsPriorityThreshold(eventPriority, threshold) {
+        if (threshold === 'all')
+            return true;
+        const priorityOrder = ['P1', 'P2', 'P3', 'P4'];
+        const eventIdx = priorityOrder.indexOf(eventPriority);
+        const thresholdIdx = priorityOrder.indexOf(threshold);
+        if (eventIdx === -1)
+            return true; // Unknown priority → allow
+        return eventIdx <= thresholdIdx;
+    }
+    rowToPrefs(row) {
+        let eventFilters = DEFAULT_PREFS.eventFilters;
+        try {
+            eventFilters = { ...DEFAULT_PREFS.eventFilters, ...JSON.parse(row.event_filters) };
+        }
+        catch { }
+        let channelSubscriptions = DEFAULT_PREFS.channelSubscriptions;
+        try {
+            channelSubscriptions = JSON.parse(row.channel_subscriptions);
+        }
+        catch { }
+        return {
+            agent: row.agent,
+            enabled: row.enabled === 1,
+            deliveryMethod: row.delivery_method,
+            priorityThreshold: row.priority_threshold,
+            quietHours: {
+                enabled: row.quiet_hours_enabled === 1,
+                startHour: row.quiet_hours_start,
+                endHour: row.quiet_hours_end,
+                timezone: row.quiet_hours_tz,
+            },
+            eventFilters,
+            channelSubscriptions,
+            mutedUntil: row.muted_until,
+            updatedAt: row.updated_at,
+        };
+    }
+}
+// ── Singleton ──
+let _manager = null;
+export function getNotificationManager() {
+    if (!_manager) {
+        _manager = new NotificationManager();
+    }
+    return _manager;
+}
+//# sourceMappingURL=notifications.js.map

package/dist/notifications.js.map

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

package/dist/openclaw.d.ts

@@ -0,0 +1,34 @@
+import type { AgentMessage } from './types.js';
+export declare class OpenClawClient {
+    private ws;
+    private connected;
+    private reconnectTimer;
+    private pingInterval;
+    private reconnectAttempts;
+    private requestId;
+    private pendingRequests;
+    private eventHandlers;
+    private static readonly BASE_RECONNECT_MS;
+    private static readonly MAX_RECONNECT_MS;
+    private static readonly PING_INTERVAL_MS;
+    constructor();
+    private connect;
+    private startPing;
+    private stopPing;
+    private scheduleReconnect;
+    private handshake;
+    private handleMessage;
+    private request;
+    on(event: string, handler: (payload: unknown) => void): void;
+    off(event: string, handler: (payload: unknown) => void): void;
+    sendMessage(message: AgentMessage): Promise<void>;
+    runAgent(prompt: string, agentId?: string): Promise<unknown>;
+    isConnected(): boolean;
+    close(): void;
+}
+export declare const openclawClient: {
+    readonly instance: OpenClawClient;
+    close(): void;
+    isConnected(): boolean;
+};
+//# sourceMappingURL=openclaw.d.ts.map

package/dist/openclaw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw.d.ts","sourceRoot":"","sources":["../src/openclaw.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AA0B9C,qBAAa,cAAc;IACzB,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,iBAAiB,CAAI;IAC7B,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,eAAe,CAGnB;IACJ,OAAO,CAAC,aAAa,CAAqD;IAG1E,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAO;IAChD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;IAChD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;;IAMhD,OAAO,CAAC,OAAO;IAqCf,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,iBAAiB;YAcX,SAAS;IAgCvB,OAAO,CAAC,aAAa;IAsBrB,OAAO,CAAC,OAAO;IA4Bf,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI;IAOrD,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI;IAIhD,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAYjD,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQlE,WAAW,IAAI,OAAO;IAItB,KAAK;CAQN;AAID,eAAO,MAAM,cAAc;uBACT,cAAc;;;CAM/B,CAAA"}

package/dist/openclaw.js

@@ -0,0 +1,208 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) Reflectt AI
+/**
+ * OpenClaw Gateway integration
+ */
+import WebSocket from 'ws';
+import { openclawConfig } from './config.js';
+export class OpenClawClient {
+    ws = null;
+    connected = false;
+    reconnectTimer = null;
+    pingInterval = null;
+    reconnectAttempts = 0;
+    requestId = 0;
+    pendingRequests = new Map();
+    eventHandlers = new Map();
+    // Reconnect backoff: 1s, 2s, 4s, 8s, 16s, 30s (cap)
+    static BASE_RECONNECT_MS = 1000;
+    static MAX_RECONNECT_MS = 30000;
+    static PING_INTERVAL_MS = 25000; // Keep-alive ping every 25s
+    constructor() {
+        this.connect();
+    }
+    connect() {
+        console.log(`[OpenClaw] Connecting to ${openclawConfig.gatewayUrl}...`);
+        this.ws = new WebSocket(openclawConfig.gatewayUrl);
+        this.ws.on('open', () => {
+            console.log('[OpenClaw] WebSocket connected, performing handshake...');
+            this.reconnectAttempts = 0; // Reset backoff on successful connection
+            this.startPing();
+            this.handshake();
+        });
+        this.ws.on('message', (data) => {
+            try {
+                const msg = JSON.parse(data.toString());
+                this.handleMessage(msg);
+            }
+            catch (err) {
+                console.error('[OpenClaw] Failed to parse message:', err);
+            }
+        });
+        this.ws.on('close', () => {
+            console.log('[OpenClaw] Connection closed, will reconnect...');
+            this.connected = false;
+            this.stopPing();
+            this.scheduleReconnect();
+        });
+        this.ws.on('error', (err) => {
+            console.error('[OpenClaw] WebSocket error:', err.message);
+        });
+        this.ws.on('pong', () => {
+            // Keep-alive pong received — connection is healthy
+        });
+    }
+    startPing() {
+        this.stopPing();
+        this.pingInterval = setInterval(() => {
+            if (this.ws?.readyState === WebSocket.OPEN) {
+                this.ws.ping();
+            }
+        }, OpenClawClient.PING_INTERVAL_MS);
+        this.pingInterval.unref(); // Don't block process exit
+    }
+    stopPing() {
+        if (this.pingInterval) {
+            clearInterval(this.pingInterval);
+            this.pingInterval = null;
+        }
+    }
+    scheduleReconnect() {
+        if (this.reconnectTimer)
+            return;
+        const delay = Math.min(OpenClawClient.BASE_RECONNECT_MS * Math.pow(2, this.reconnectAttempts), OpenClawClient.MAX_RECONNECT_MS);
+        this.reconnectAttempts++;
+        console.log(`[OpenClaw] Reconnecting in ${delay}ms (attempt ${this.reconnectAttempts})`);
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            this.connect();
+        }, delay);
+    }
+    async handshake() {
+        try {
+            const response = await this.request('connect', {
+                minProtocol: 3,
+                maxProtocol: 3,
+                client: {
+                    id: 'cli',
+                    displayName: 'Reflectt Node',
+                    version: '0.1.0',
+                    platform: 'node',
+                    mode: 'cli',
+                },
+                role: 'operator',
+                scopes: ['operator.read', 'operator.write'],
+                caps: [],
+                commands: [],
+                permissions: {},
+                auth: openclawConfig.gatewayToken ? {
+                    token: openclawConfig.gatewayToken
+                } : undefined,
+                locale: 'en-US',
+                userAgent: 'reflectt-node/0.1.0',
+            });
+            console.log('[OpenClaw] Handshake successful:', response);
+            this.connected = true;
+        }
+        catch (err) {
+            console.error('[OpenClaw] Handshake failed:', err);
+            this.ws?.close();
+        }
+    }
+    handleMessage(msg) {
+        if (msg.type === 'res') {
+            const pending = this.pendingRequests.get(msg.id);
+            if (pending) {
+                this.pendingRequests.delete(msg.id);
+                if (msg.ok) {
+                    pending.resolve(msg.payload);
+                }
+                else {
+                    const errorMsg = typeof msg.error === 'string'
+                        ? msg.error
+                        : JSON.stringify(msg.error) || 'Request failed';
+                    pending.reject(new Error(errorMsg));
+                }
+            }
+        }
+        else if (msg.type === 'event') {
+            const handlers = this.eventHandlers.get(msg.event);
+            if (handlers) {
+                handlers.forEach(handler => handler(msg.payload));
+            }
+        }
+    }
+    request(method, params) {
+        return new Promise((resolve, reject) => {
+            if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+                reject(new Error('Not connected to OpenClaw gateway'));
+                return;
+            }
+            const id = `req-${++this.requestId}`;
+            const req = {
+                type: 'req',
+                id,
+                method,
+                params,
+            };
+            this.pendingRequests.set(id, { resolve, reject });
+            this.ws.send(JSON.stringify(req));
+            // Timeout after 30s
+            setTimeout(() => {
+                if (this.pendingRequests.has(id)) {
+                    this.pendingRequests.delete(id);
+                    reject(new Error('Request timeout'));
+                }
+            }, 30000);
+        });
+    }
+    on(event, handler) {
+        if (!this.eventHandlers.has(event)) {
+            this.eventHandlers.set(event, new Set());
+        }
+        this.eventHandlers.get(event).add(handler);
+    }
+    off(event, handler) {
+        this.eventHandlers.get(event)?.delete(handler);
+    }
+    async sendMessage(message) {
+        if (!this.connected) {
+            throw new Error('Not connected to OpenClaw');
+        }
+        // Use OpenClaw's send method to broadcast messages
+        await this.request('send', {
+            message: JSON.stringify(message),
+            target: message.to || 'broadcast',
+        });
+    }
+    async runAgent(prompt, agentId) {
+        return this.request('agent', {
+            prompt,
+            agentId: agentId || 'main',
+            stream: false,
+        });
+    }
+    isConnected() {
+        return this.connected;
+    }
+    close() {
+        this.stopPing();
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        this.ws?.close();
+    }
+}
+// Singleton instance — lazy init, doesn't crash if OpenClaw unavailable
+let _client = null;
+export const openclawClient = {
+    get instance() {
+        if (!_client)
+            _client = new OpenClawClient();
+        return _client;
+    },
+    close() { _client?.close(); },
+    isConnected() { return _client?.isConnected() ?? false; },
+};
+//# sourceMappingURL=openclaw.js.map

package/dist/openclaw.js.map

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

package/dist/pause-controls.d.ts

@@ -0,0 +1,31 @@
+export interface PauseEntry {
+    target: string;
+    paused: boolean;
+    pausedAt: number;
+    pausedUntil: number | null;
+    pausedBy: string;
+    reason: string;
+}
+export interface PauseStatus {
+    paused: boolean;
+    entry: PauseEntry | null;
+    remainingMs: number | null;
+    message: string;
+}
+/** Pause an agent or the team */
+export declare function pauseTarget(target: string, opts: {
+    pausedUntil?: number | null;
+    pausedBy: string;
+    reason: string;
+}): PauseEntry;
+/** Unpause an agent or the team */
+export declare function unpauseTarget(target: string): {
+    success: boolean;
+};
+/** Check if an agent is paused (directly or via team pause) */
+export declare function checkPauseStatus(agent: string): PauseStatus;
+/** List all pause entries (active + expired) */
+export declare function listPauseEntries(): PauseEntry[];
+/** Get team pause status specifically */
+export declare function getTeamPauseStatus(): PauseStatus;
+//# sourceMappingURL=pause-controls.d.ts.map

package/dist/pause-controls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pause-controls.d.ts","sourceRoot":"","sources":["../src/pause-controls.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,CAAA;IACf,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,OAAO,EAAE,MAAM,CAAA;CAChB;AA0ED,iCAAiC;AACjC,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,UAAU,CAG/H;AAED,mCAAmC;AACnC,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAGlE;AAED,+DAA+D;AAC/D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAsC3D;AAED,gDAAgD;AAChD,wBAAgB,gBAAgB,IAAI,UAAU,EAAE,CAY/C;AAED,yCAAyC;AACzC,wBAAgB,kBAAkB,IAAI,WAAW,CAEhD"}