reflectt-node 0.1.0

package/dist/telemetry.js

@@ -0,0 +1,256 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) Reflectt AI
+/**
+ * Telemetry Module — Opt-in usage metrics + error reporting
+ *
+ * Privacy-first design:
+ * - Explicit opt-in via REFLECTT_TELEMETRY=true or config.json
+ * - No PII collected — all metrics are anonymous/aggregatable
+ * - Clear documentation of what is collected
+ * - Can be disabled at any time
+ *
+ * Collects:
+ * - Endpoint usage (hit counts, response times)
+ * - Team size (agent count)
+ * - Feature adoption (which endpoints are used)
+ * - Task throughput (tasks created/completed per period)
+ * - Error reporting (crashes, failed API calls, timeouts — no PII)
+ * - Health metrics (uptime, response times)
+ */
+import { taskManager } from './tasks.js';
+import { presenceManager } from './presence.js';
+// ── State ──
+const startedAt = Date.now();
+let config = {
+    enabled: false,
+    cloudUrl: '',
+    hostId: 'unknown',
+    reportIntervalMs: 5 * 60 * 1000, // 5 minutes
+};
+// Rolling metrics (reset each reporting period)
+let periodStart = Date.now();
+const endpointHits = new Map();
+const errorLog = new Map();
+const featureUsage = new Map();
+let tasksCreatedInPeriod = 0;
+let tasksCompletedInPeriod = 0;
+let totalRequests = 0;
+let totalErrors = 0;
+let totalDurationMs = 0;
+let reportTimer = null;
+// ── Public API ──
+/** Initialize telemetry with config */
+export function initTelemetry(cfg) {
+    config = { ...config, ...cfg };
+    if (!config.enabled) {
+        console.log('[Telemetry] Disabled (opt-in via REFLECTT_TELEMETRY=true)');
+        return;
+    }
+    console.log(`[Telemetry] Enabled — reporting to ${config.cloudUrl || 'local only'} every ${config.reportIntervalMs / 1000}s`);
+    // Start periodic reporting
+    if (reportTimer)
+        clearInterval(reportTimer);
+    reportTimer = setInterval(() => {
+        if (config.cloudUrl) {
+            reportToCloud().catch(err => {
+                console.error('[Telemetry] Report failed:', err.message);
+            });
+        }
+    }, config.reportIntervalMs);
+}
+/** Stop telemetry reporting */
+export function stopTelemetry() {
+    if (reportTimer) {
+        clearInterval(reportTimer);
+        reportTimer = null;
+    }
+}
+/** Track an HTTP request (call from onResponse hook) */
+export function trackRequest(method, path, statusCode, durationMs) {
+    if (!config.enabled)
+        return;
+    // Normalize path (strip IDs to group endpoints)
+    const normalizedPath = normalizePath(path);
+    const key = `${method} ${normalizedPath}`;
+    const existing = endpointHits.get(key) || { hits: 0, errors: 0, durations: [] };
+    existing.hits++;
+    existing.durations.push(durationMs);
+    if (statusCode >= 400)
+        existing.errors++;
+    endpointHits.set(key, existing);
+    totalRequests++;
+    totalDurationMs += durationMs;
+    if (statusCode >= 400)
+        totalErrors++;
+    // Track feature adoption
+    trackFeatureFromPath(method, normalizedPath);
+}
+/** Track an error (no PII — just type + endpoint) */
+export function trackError(type, endpoint) {
+    if (!config.enabled)
+        return;
+    const sanitized = endpoint ? normalizePath(endpoint) : 'unknown';
+    const key = `${type}:${sanitized}`;
+    const existing = errorLog.get(key) || { count: 0, lastSeen: 0 };
+    existing.count++;
+    existing.lastSeen = Date.now();
+    errorLog.set(key, existing);
+}
+/** Track a task event */
+export function trackTaskEvent(event) {
+    if (!config.enabled)
+        return;
+    if (event === 'created')
+        tasksCreatedInPeriod++;
+    if (event === 'completed')
+        tasksCompletedInPeriod++;
+}
+/** Get current telemetry snapshot (also used by GET /telemetry endpoint) */
+export function getSnapshot() {
+    const now = Date.now();
+    const allTasks = taskManager.listTasks();
+    const agents = presenceManager.getAllPresence();
+    const byStatus = {};
+    for (const t of allTasks) {
+        byStatus[t.status] = (byStatus[t.status] || 0) + 1;
+    }
+    const completedTasks = allTasks.filter(t => t.status === 'done');
+    const cycleTimes = completedTasks
+        .map(t => t.updatedAt - t.createdAt)
+        .filter(ct => ct > 0);
+    const avgCycleTimeMs = cycleTimes.length > 0
+        ? Math.round(cycleTimes.reduce((s, v) => s + v, 0) / cycleTimes.length)
+        : 0;
+    // Build endpoint metrics
+    const endpoints = [];
+    for (const [key, data] of endpointHits) {
+        const [method, path] = key.split(' ', 2);
+        const sorted = data.durations.slice().sort((a, b) => a - b);
+        const p95Index = Math.floor(sorted.length * 0.95);
+        endpoints.push({
+            path,
+            method,
+            hits: data.hits,
+            errors: data.errors,
+            totalDurationMs: sorted.reduce((s, v) => s + v, 0),
+            avgDurationMs: sorted.length > 0 ? Math.round(sorted.reduce((s, v) => s + v, 0) / sorted.length) : 0,
+            p95DurationMs: sorted[p95Index] || 0,
+            lastHit: now,
+        });
+    }
+    endpoints.sort((a, b) => b.hits - a.hits);
+    // Build error entries
+    const errors = [];
+    for (const [key, data] of errorLog) {
+        const [type, endpoint] = key.split(':', 2);
+        errors.push({ type, endpoint, count: data.count, lastSeen: data.lastSeen });
+    }
+    // Features
+    const features = {};
+    for (const [feat, count] of featureUsage) {
+        features[feat] = count;
+    }
+    return {
+        version: '1.0.0',
+        hostId: config.hostId,
+        timestamp: now,
+        uptime: now - startedAt,
+        period: { startMs: periodStart, endMs: now },
+        team: {
+            agentCount: agents.length,
+            activeAgentCount: agents.filter(a => a.status === 'working' || a.status === 'reviewing').length,
+        },
+        tasks: {
+            total: allTasks.length,
+            created: tasksCreatedInPeriod,
+            completed: tasksCompletedInPeriod,
+            avgCycleTimeMs,
+            byStatus,
+        },
+        endpoints: endpoints.slice(0, 50), // Top 50 endpoints
+        features,
+        errors: errors.slice(0, 50),
+        health: {
+            uptimeMs: now - startedAt,
+            avgResponseTimeMs: totalRequests > 0 ? Math.round(totalDurationMs / totalRequests) : 0,
+            errorRate: totalRequests > 0 ? Math.round((totalErrors / totalRequests) * 10000) / 10000 : 0,
+            requestsTotal: totalRequests,
+        },
+    };
+}
+/** Check if telemetry is enabled */
+export function isTelemetryEnabled() {
+    return config.enabled;
+}
+/** Get telemetry config (safe — no secrets) */
+export function getTelemetryConfig() {
+    return {
+        enabled: config.enabled,
+        cloudUrl: config.cloudUrl ? config.cloudUrl.replace(/\/\/[^@]+@/, '//***@') : '', // mask credentials
+        reportIntervalMs: config.reportIntervalMs,
+    };
+}
+// ── Internals ──
+function normalizePath(path) {
+    // Strip query params
+    const base = path.split('?')[0];
+    // Replace UUIDs and task IDs with :id
+    return base
+        .replace(/\/task-\d+-[a-z0-9]+/g, '/:id')
+        .replace(/\/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/g, '/:uuid')
+        .replace(/\/msg-\d+-[a-z0-9]+/g, '/:msgId')
+        .replace(/\/\d{10,}/g, '/:timestamp');
+}
+function trackFeatureFromPath(method, path) {
+    // Map endpoints to feature names
+    const featureMap = {
+        'GET /tasks': 'task-management',
+        'POST /tasks': 'task-creation',
+        'PATCH /tasks/:id': 'task-updates',
+        'GET /analytics': 'analytics',
+        'GET /presence': 'presence',
+        'GET /chat': 'chat',
+        'POST /chat': 'chat',
+        'GET /dashboard': 'dashboard',
+        'GET /agents': 'agent-roles',
+        'POST /tasks/suggest-assignee': 'auto-assignment',
+        'GET /inbox': 'inbox',
+        'GET /health': 'health-monitoring',
+    };
+    for (const [pattern, feature] of Object.entries(featureMap)) {
+        const [m, p] = pattern.split(' ', 2);
+        if (method === m && path.startsWith(p)) {
+            featureUsage.set(feature, (featureUsage.get(feature) || 0) + 1);
+            return;
+        }
+    }
+}
+async function reportToCloud() {
+    const snapshot = getSnapshot();
+    try {
+        const url = `${config.cloudUrl.replace(/\/+$/, '')}/api/telemetry/ingest`;
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(snapshot),
+            signal: AbortSignal.timeout(10000),
+        });
+        if (!res.ok) {
+            console.error(`[Telemetry] Cloud report failed: ${res.status} ${res.statusText}`);
+        }
+    }
+    catch (err) {
+        // Silent fail — telemetry should never break the app
+    }
+    // Reset period counters
+    periodStart = Date.now();
+    endpointHits.clear();
+    errorLog.clear();
+    featureUsage.clear();
+    tasksCreatedInPeriod = 0;
+    tasksCompletedInPeriod = 0;
+    totalRequests = 0;
+    totalErrors = 0;
+    totalDurationMs = 0;
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,4BAA4B;AAE5B;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AA4D/C,cAAc;AAEd,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;AAC5B,IAAI,MAAM,GAAoB;IAC5B,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE,EAAE;IACZ,MAAM,EAAE,SAAS;IACjB,gBAAgB,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,YAAY;CAC9C,CAAA;AAED,gDAAgD;AAChD,IAAI,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;AAC5B,MAAM,YAAY,GAAG,IAAI,GAAG,EAAiE,CAAA;AAC7F,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA+C,CAAA;AACvE,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAA;AAC9C,IAAI,oBAAoB,GAAG,CAAC,CAAA;AAC5B,IAAI,sBAAsB,GAAG,CAAC,CAAA;AAC9B,IAAI,aAAa,GAAG,CAAC,CAAA;AACrB,IAAI,WAAW,GAAG,CAAC,CAAA;AACnB,IAAI,eAAe,GAAG,CAAC,CAAA;AAEvB,IAAI,WAAW,GAA0C,IAAI,CAAA;AAE7D,mBAAmB;AAEnB,uCAAuC;AACvC,MAAM,UAAU,aAAa,CAAC,GAA6B;IACzD,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,GAAG,GAAG,EAAE,CAAA;IAE9B,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAA;QACxE,OAAM;IACR,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,sCAAsC,MAAM,CAAC,QAAQ,IAAI,YAAY,UAAU,MAAM,CAAC,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAA;IAE7H,2BAA2B;IAC3B,IAAI,WAAW;QAAE,aAAa,CAAC,WAAW,CAAC,CAAA;IAC3C,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,aAAa,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;gBAC1B,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAG,GAAa,CAAC,OAAO,CAAC,CAAA;YACrE,CAAC,CAAC,CAAA;QACJ,CAAC;IACH,CAAC,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAA;AAC7B,CAAC;AAED,+BAA+B;AAC/B,MAAM,UAAU,aAAa;IAC3B,IAAI,WAAW,EAAE,CAAC;QAChB,aAAa,CAAC,WAAW,CAAC,CAAA;QAC1B,WAAW,GAAG,IAAI,CAAA;IACpB,CAAC;AACH,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,IAAY,EAAE,UAAkB,EAAE,UAAkB;IAC/F,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAM;IAE3B,gDAAgD;IAChD,MAAM,cAAc,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;IAC1C,MAAM,GAAG,GAAG,GAAG,MAAM,IAAI,cAAc,EAAE,CAAA;IAEzC,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAA;IAC/E,QAAQ,CAAC,IAAI,EAAE,CAAA;IACf,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACnC,IAAI,UAAU,IAAI,GAAG;QAAE,QAAQ,CAAC,MAAM,EAAE,CAAA;IACxC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;IAE/B,aAAa,EAAE,CAAA;IACf,eAAe,IAAI,UAAU,CAAA;IAC7B,IAAI,UAAU,IAAI,GAAG;QAAE,WAAW,EAAE,CAAA;IAEpC,yBAAyB;IACzB,oBAAoB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;AAC9C,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,QAAiB;IACxD,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAM;IAE3B,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAChE,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,SAAS,EAAE,CAAA;IAClC,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAA;IAC/D,QAAQ,CAAC,KAAK,EAAE,CAAA;IAChB,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IAC9B,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;AAC7B,CAAC;AAED,yBAAyB;AACzB,MAAM,UAAU,cAAc,CAAC,KAA8B;IAC3D,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAM;IAC3B,IAAI,KAAK,KAAK,SAAS;QAAE,oBAAoB,EAAE,CAAA;IAC/C,IAAI,KAAK,KAAK,WAAW;QAAE,sBAAsB,EAAE,CAAA;AACrD,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,WAAW;IACzB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IACtB,MAAM,QAAQ,GAAG,WAAW,CAAC,SAAS,EAAE,CAAA;IACxC,MAAM,MAAM,GAAG,eAAe,CAAC,cAAc,EAAE,CAAA;IAE/C,MAAM,QAAQ,GAA2B,EAAE,CAAA;IAC3C,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;IACpD,CAAC;IAED,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAA;IAChE,MAAM,UAAU,GAAG,cAAc;SAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC;SACnC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;IACvB,MAAM,cAAc,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC;QAC1C,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC;QACvE,CAAC,CAAC,CAAC,CAAA;IAEL,yBAAyB;IACzB,MAAM,SAAS,GAAqB,EAAE,CAAA;IACtC,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,YAAY,EAAE,CAAC;QACvC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;QACxC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;QAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;QACjD,SAAS,CAAC,IAAI,CAAC;YACb,IAAI;YACJ,MAAM;YACN,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,eAAe,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAClD,aAAa,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACpG,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;YACpC,OAAO,EAAE,GAAG;SACb,CAAC,CAAA;IACJ,CAAC;IACD,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAA;IAEzC,sBAAsB;IACtB,MAAM,MAAM,GAAiB,EAAE,CAAA;IAC/B,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;QAC1C,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAA;IAC7E,CAAC;IAED,WAAW;IACX,MAAM,QAAQ,GAA2B,EAAE,CAAA;IAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,YAAY,EAAE,CAAC;QACzC,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAA;IACxB,CAAC;IAED,OAAO;QACL,OAAO,EAAE,OAAO;QAChB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,SAAS,EAAE,GAAG;QACd,MAAM,EAAE,GAAG,GAAG,SAAS;QACvB,MAAM,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,EAAE;QAC5C,IAAI,EAAE;YACJ,UAAU,EAAE,MAAM,CAAC,MAAM;YACzB,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM;SAChG;QACD,KAAK,EAAE;YACL,KAAK,EAAE,QAAQ,CAAC,MAAM;YACtB,OAAO,EAAE,oBAAoB;YAC7B,SAAS,EAAE,sBAAsB;YACjC,cAAc;YACd,QAAQ;SACT;QACD,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,mBAAmB;QACtD,QAAQ;QACR,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,EAAE;YACN,QAAQ,EAAE,GAAG,GAAG,SAAS;YACzB,iBAAiB,EAAE,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;YACtF,SAAS,EAAE,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,GAAG,aAAa,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAC5F,aAAa,EAAE,aAAa;SAC7B;KACF,CAAA;AACH,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,kBAAkB;IAChC,OAAO,MAAM,CAAC,OAAO,CAAA;AACvB,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,mBAAmB;QACrG,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;KAC1C,CAAA;AACH,CAAC;AAED,kBAAkB;AAElB,SAAS,aAAa,CAAC,IAAY;IACjC,qBAAqB;IACrB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IAC/B,sCAAsC;IACtC,OAAO,IAAI;SACR,OAAO,CAAC,uBAAuB,EAAE,MAAM,CAAC;SACxC,OAAO,CAAC,iEAAiE,EAAE,QAAQ,CAAC;SACpF,OAAO,CAAC,sBAAsB,EAAE,SAAS,CAAC;SAC1C,OAAO,CAAC,YAAY,EAAE,aAAa,CAAC,CAAA;AACzC,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAc,EAAE,IAAY;IACxD,iCAAiC;IACjC,MAAM,UAAU,GAA2B;QACzC,YAAY,EAAE,iBAAiB;QAC/B,aAAa,EAAE,eAAe;QAC9B,kBAAkB,EAAE,cAAc;QAClC,gBAAgB,EAAE,WAAW;QAC7B,eAAe,EAAE,UAAU;QAC3B,WAAW,EAAE,MAAM;QACnB,YAAY,EAAE,MAAM;QACpB,gBAAgB,EAAE,WAAW;QAC7B,aAAa,EAAE,aAAa;QAC5B,8BAA8B,EAAE,iBAAiB;QACjD,YAAY,EAAE,OAAO;QACrB,aAAa,EAAE,mBAAmB;KACnC,CAAA;IAED,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5D,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;QACpC,IAAI,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;YACvC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;YAC/D,OAAM;QACR,CAAC;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa;IAC1B,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAA;IAE9B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,uBAAuB,CAAA;QACzE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;YAC9B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC;SACnC,CAAC,CAAA;QAEF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,CAAC,oCAAoC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,CAAA;QACnF,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,qDAAqD;IACvD,CAAC;IAED,wBAAwB;IACxB,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IACxB,YAAY,CAAC,KAAK,EAAE,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,CAAA;IAChB,YAAY,CAAC,KAAK,EAAE,CAAA;IACpB,oBAAoB,GAAG,CAAC,CAAA;IACxB,sBAAsB,GAAG,CAAC,CAAA;IAC1B,aAAa,GAAG,CAAC,CAAA;IACjB,WAAW,GAAG,CAAC,CAAA;IACf,eAAe,GAAG,CAAC,CAAA;AACrB,CAAC"}

package/dist/test-task-filter.d.ts

@@ -0,0 +1,21 @@
+import type { Task } from './types.js';
+/**
+ * Returns true if a task is a test-harness-generated task.
+ *
+ * Classification rules:
+ * 1. metadata.is_test === true
+ * 2. metadata.source_reflection starts with 'ref-test-'
+ * 3. metadata.source_insight starts with 'ins-test-'
+ * 4. Title matches "test run <13-digit-timestamp>"
+ * 5. Task ID starts with 'test-' or matches 'task-test-*'
+ */
+export declare function isTestHarnessTask(task: Task): boolean;
+/**
+ * SQL WHERE clause fragment to exclude test-harness tasks at the DB level.
+ * Use for raw SQL queries that can't go through listTasks().
+ *
+ * Usage: `SELECT ... FROM tasks WHERE ${TEST_TASK_EXCLUDE_SQL}`
+ * Pair with include_test parameter: `WHERE (? = 1 OR ${TEST_TASK_EXCLUDE_SQL})`
+ */
+export declare const TEST_TASK_EXCLUDE_SQL = "(\n  json_extract(metadata, '$.is_test') IS NOT 1\n  AND (json_extract(metadata, '$.source_reflection') IS NULL OR json_extract(metadata, '$.source_reflection') NOT LIKE 'ref-test-%')\n  AND (json_extract(metadata, '$.source_insight') IS NULL OR json_extract(metadata, '$.source_insight') NOT LIKE 'ins-test-%')\n  AND title NOT LIKE '%test run 1%'\n  AND id NOT LIKE 'test-%'\n  AND id NOT LIKE 'task-test-%'\n)";
+//# sourceMappingURL=test-task-filter.d.ts.map

package/dist/test-task-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-task-filter.d.ts","sourceRoot":"","sources":["../src/test-task-filter.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAEtC;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAUrD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,iaAOhC,CAAA"}

package/dist/test-task-filter.js

@@ -0,0 +1,48 @@
+// SPDX-License-Identifier: Apache-2.0
+// Shared utility: classify test-harness tasks
+//
+// Test tasks are created by pipeline validation runs (intake tests, bridge tests,
+// working-contract tests, etc.) and must be excluded from production metrics,
+// board health, and stats by default.
+/**
+ * Returns true if a task is a test-harness-generated task.
+ *
+ * Classification rules:
+ * 1. metadata.is_test === true
+ * 2. metadata.source_reflection starts with 'ref-test-'
+ * 3. metadata.source_insight starts with 'ins-test-'
+ * 4. Title matches "test run <13-digit-timestamp>"
+ * 5. Task ID starts with 'test-' or matches 'task-test-*'
+ */
+export function isTestHarnessTask(task) {
+    const meta = (task.metadata || {});
+    if (meta.is_test === true)
+        return true;
+    if (typeof meta.source_reflection === 'string' && meta.source_reflection.startsWith('ref-test-'))
+        return true;
+    if (typeof meta.source_insight === 'string' && meta.source_insight.startsWith('ins-test-'))
+        return true;
+    if (/test run \d{13}/i.test(task.title || ''))
+        return true;
+    // ID-based classification: task IDs created by test harnesses
+    const id = task.id || '';
+    if (id.startsWith('test-') || /^task-test-/i.test(id))
+        return true;
+    return false;
+}
+/**
+ * SQL WHERE clause fragment to exclude test-harness tasks at the DB level.
+ * Use for raw SQL queries that can't go through listTasks().
+ *
+ * Usage: `SELECT ... FROM tasks WHERE ${TEST_TASK_EXCLUDE_SQL}`
+ * Pair with include_test parameter: `WHERE (? = 1 OR ${TEST_TASK_EXCLUDE_SQL})`
+ */
+export const TEST_TASK_EXCLUDE_SQL = `(
+  json_extract(metadata, '$.is_test') IS NOT 1
+  AND (json_extract(metadata, '$.source_reflection') IS NULL OR json_extract(metadata, '$.source_reflection') NOT LIKE 'ref-test-%')
+  AND (json_extract(metadata, '$.source_insight') IS NULL OR json_extract(metadata, '$.source_insight') NOT LIKE 'ins-test-%')
+  AND title NOT LIKE '%test run 1%'
+  AND id NOT LIKE 'test-%'
+  AND id NOT LIKE 'task-test-%'
+)`;
+//# sourceMappingURL=test-task-filter.js.map

package/dist/test-task-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-task-filter.js","sourceRoot":"","sources":["../src/test-task-filter.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,8CAA8C;AAC9C,EAAE;AACF,kFAAkF;AAClF,8EAA8E;AAC9E,sCAAsC;AAItC;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAU;IAC1C,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAA4B,CAAA;IAC7D,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IACtC,IAAI,OAAO,IAAI,CAAC,iBAAiB,KAAK,QAAQ,IAAI,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAA;IAC7G,IAAI,OAAO,IAAI,CAAC,cAAc,KAAK,QAAQ,IAAI,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAA;IACvG,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAAE,OAAO,IAAI,CAAA;IAC1D,8DAA8D;IAC9D,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,EAAE,CAAA;IACxB,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAA;IAClE,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;EAOnC,CAAA"}

package/dist/types.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Core types for reflectt-node
+ */
+export interface ChatAttachment {
+    id: string;
+    name: string;
+    size: number;
+    mimeType: string;
+    url: string;
+}
+export interface AgentMessage {
+    id: string;
+    from: string;
+    to?: string;
+    content: string;
+    timestamp: number;
+    channel?: string;
+    reactions?: Record<string, string[]>;
+    threadId?: string;
+    replyCount?: number;
+    metadata?: Record<string, unknown>;
+    attachments?: ChatAttachment[];
+}
+export interface Task {
+    id: string;
+    title: string;
+    description?: string;
+    status: 'todo' | 'doing' | 'blocked' | 'validating' | 'done';
+    assignee?: string;
+    reviewer?: string;
+    done_criteria?: string[];
+    createdBy: string;
+    createdAt: number;
+    updatedAt: number;
+    priority?: 'P0' | 'P1' | 'P2' | 'P3';
+    blocked_by?: string[];
+    epic_id?: string;
+    tags?: string[];
+    metadata?: Record<string, unknown>;
+    teamId?: string;
+}
+export type TaskHistoryEventType = 'created' | 'assigned' | 'status_changed' | 'commented' | 'lane_transition';
+export interface TaskComment {
+    id: string;
+    taskId: string;
+    author: string;
+    content: string;
+    timestamp: number;
+    /** Optional comms categorization (used by comms_policy enforcement) */
+    category?: string | null;
+    /** If true, comment is stored for audit but suppressed from default feeds */
+    suppressed?: boolean;
+    /** Human-readable suppression reason (e.g., missing_category, non_whitelisted_category:<x>) */
+    suppressedReason?: string | null;
+    /** Policy rule that caused suppression (if any) */
+    suppressedRule?: string | null;
+}
+export interface TaskHistoryEvent {
+    id: string;
+    taskId: string;
+    type: TaskHistoryEventType;
+    actor: string;
+    timestamp: number;
+    data?: Record<string, unknown>;
+}
+export type RecurringTaskSchedule = {
+    kind: 'weekly';
+    dayOfWeek: number;
+    hour?: number;
+    minute?: number;
+} | {
+    kind: 'interval';
+    everyMs: number;
+    anchorAt?: number;
+};
+export interface RecurringTask {
+    id: string;
+    title: string;
+    description?: string;
+    assignee?: string;
+    reviewer?: string;
+    done_criteria?: string[];
+    createdBy: string;
+    priority?: 'P0' | 'P1' | 'P2' | 'P3';
+    blocked_by?: string[];
+    epic_id?: string;
+    tags?: string[];
+    metadata?: Record<string, unknown>;
+    schedule: RecurringTaskSchedule;
+    enabled: boolean;
+    status?: 'todo' | 'doing' | 'blocked' | 'validating' | 'done';
+    lastRunAt?: number;
+    lastSkipAt?: number;
+    lastSkipReason?: string;
+    nextRunAt: number;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface OpenClawConfig {
+    gatewayUrl: string;
+    gatewayToken?: string;
+    agentId: string;
+}
+export interface ServerConfig {
+    port: number;
+    host: string;
+    corsEnabled: boolean;
+}
+export interface ChatRoom {
+    id: string;
+    name: string;
+    participants: string[];
+    createdAt: number;
+}
+export interface InboxMessage extends AgentMessage {
+    priority: 'high' | 'medium' | 'low';
+    reason: 'mention' | 'dm' | 'subscribed' | 'general';
+}
+export interface InboxState {
+    agent: string;
+    subscriptions: string[];
+    ackedMessageIds: string[];
+    lastReadTimestamp?: number;
+    lastUpdated: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) Reflectt AI
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,4BAA4B"}

package/dist/usage-tracking.d.ts

@@ -0,0 +1,101 @@
+export interface UsageEvent {
+    id: string;
+    agent: string;
+    task_id?: string;
+    model: string;
+    provider: string;
+    input_tokens: number;
+    output_tokens: number;
+    estimated_cost_usd: number;
+    category: 'task_work' | 'heartbeat' | 'reflection' | 'chat' | 'review' | 'other';
+    timestamp: number;
+    team_id?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface SpendCap {
+    id: string;
+    scope: 'global' | 'agent' | 'team';
+    scope_id?: string;
+    period: 'daily' | 'weekly' | 'monthly';
+    limit_usd: number;
+    action: 'warn' | 'throttle' | 'block';
+    enabled: boolean;
+    created_at: number;
+    updated_at: number;
+}
+export interface UsageSummary {
+    period: string;
+    total_cost_usd: number;
+    total_input_tokens: number;
+    total_output_tokens: number;
+    event_count: number;
+}
+export interface AgentUsage {
+    agent: string;
+    total_cost_usd: number;
+    total_input_tokens: number;
+    total_output_tokens: number;
+    event_count: number;
+    top_model: string;
+}
+export interface CapStatus {
+    cap: SpendCap;
+    current_spend_usd: number;
+    remaining_usd: number;
+    utilization_pct: number;
+    breached: boolean;
+}
+export declare function estimateCost(model: string, inputTokens: number, outputTokens: number): number;
+export declare function ensureUsageTables(): void;
+export declare function recordUsage(event: Omit<UsageEvent, 'id' | 'estimated_cost_usd'> & {
+    estimated_cost_usd?: number;
+}): UsageEvent;
+export declare function recordUsageBatch(events: Array<Omit<UsageEvent, 'id' | 'estimated_cost_usd'> & {
+    estimated_cost_usd?: number;
+}>): UsageEvent[];
+export declare function getUsageSummary(options?: {
+    since?: number;
+    until?: number;
+    agent?: string;
+    team_id?: string;
+    group_by?: 'day' | 'week' | 'month';
+}): UsageSummary[];
+export declare function getUsageByAgent(options?: {
+    since?: number;
+    until?: number;
+}): AgentUsage[];
+export declare function getUsageByModel(options?: {
+    since?: number;
+    until?: number;
+}): Array<{
+    model: string;
+    total_cost_usd: number;
+    total_input_tokens: number;
+    total_output_tokens: number;
+    event_count: number;
+}>;
+export declare function getUsageByTask(options?: {
+    since?: number;
+    until?: number;
+    limit?: number;
+}): Array<{
+    task_id: string;
+    total_cost_usd: number;
+    event_count: number;
+}>;
+export declare function setCap(cap: Omit<SpendCap, 'id' | 'created_at' | 'updated_at'>): SpendCap;
+export declare function listCaps(): SpendCap[];
+export declare function deleteCap(id: string): boolean;
+export declare function checkCaps(event?: UsageEvent): CapStatus[];
+export declare function getRoutingSuggestions(options?: {
+    since?: number;
+}): Array<{
+    category: string;
+    current_model: string;
+    suggested_model: string;
+    current_cost_usd: number;
+    projected_cost_usd: number;
+    savings_usd: number;
+    savings_pct: number;
+}>;
+//# sourceMappingURL=usage-tracking.d.ts.map

package/dist/usage-tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-tracking.d.ts","sourceRoot":"","sources":["../src/usage-tracking.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,QAAQ,EAAE,WAAW,GAAG,WAAW,GAAG,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;IAChF,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAA;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAA;IACtC,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAA;IACrC,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,MAAM,CAAA;IACtB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,cAAc,EAAE,MAAM,CAAA;IACtB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,QAAQ,CAAA;IACb,iBAAiB,EAAE,MAAM,CAAA;IACzB,aAAa,EAAE,MAAM,CAAA;IACrB,eAAe,EAAE,MAAM,CAAA;IACvB,QAAQ,EAAE,OAAO,CAAA;CAClB;AAeD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAQ7F;AAID,wBAAgB,iBAAiB,IAAI,IAAI,CAkCxC;AAID,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,oBAAoB,CAAC,GAAG;IAAE,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,UAAU,CAqC9H;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,oBAAoB,CAAC,GAAG;IAAE,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,UAAU,EAAE,CAE7I;AAID,wBAAgB,eAAe,CAAC,OAAO,GAAE;IACvC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAA;CAC/B,GAAG,YAAY,EAAE,CAyBtB;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,UAAU,EAAE,CAsB9F;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,KAAK,CAAC;IACvF,KAAK,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CACpH,CAAC,CAgBD;AAED,wBAAgB,cAAc,CAAC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,KAAK,CAAC;IACtG,OAAO,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAC7D,CAAC,CAgBD;AAID,wBAAgB,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,YAAY,GAAG,YAAY,CAAC,GAAG,QAAQ,CAcxF;AAED,wBAAgB,QAAQ,IAAI,QAAQ,EAAE,CAMrC;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAK7C;AAeD,wBAAgB,SAAS,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,EAAE,CAqDzD;AAID,wBAAgB,qBAAqB,CAAC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,KAAK,CAAC;IAC7E,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,EAAE,MAAM,CAAA;IACrB,eAAe,EAAE,MAAM,CAAA;IACvB,gBAAgB,EAAE,MAAM,CAAA;IACxB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;CACpB,CAAC,CAwCD"}