reflectt-node 0.1.0

package/dist/team-doctor.js

@@ -0,0 +1,270 @@
+// SPDX-License-Identifier: Apache-2.0
+// Team Doctor — diagnostic checks for onboarding and ongoing health.
+import { getDb } from './db.js';
+import { DATA_DIR } from './config.js';
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+/**
+ * Run all team doctor checks and return a diagnostic report.
+ * This is designed for onboarding (first-run) and ongoing health monitoring.
+ */
+export function runTeamDoctor(opts) {
+    const checks = [];
+    // 1. Check: reflectt-node is running (implicit — if this code runs, the node is up)
+    checks.push({
+        name: 'node_running',
+        status: 'pass',
+        message: 'reflectt-node is running',
+    });
+    // 2. Check: SQLite database is accessible
+    checks.push(checkDatabase());
+    // 3. Check: agents are configured
+    checks.push(checkAgentsPresent());
+    // 4. Check: gateway connection
+    checks.push(checkGateway(opts?.gatewayUrl));
+    // 5. Check: model/LLM auth
+    checks.push(checkModelAuth(opts?.modelProvider));
+    // 6. Check: OpenClaw workspace bootstrap bloat (duplicate MEMORY.md/memory.md, oversized injected files)
+    checks.push(checkOpenClawBootstrap());
+    // 7. Check: at least one chat channel has messages (agents are communicating)
+    checks.push(checkChatActivity());
+    // Compute overall status
+    const hasFailure = checks.some(c => c.status === 'fail');
+    const hasWarn = checks.some(c => c.status === 'warn');
+    const overall = hasFailure ? 'fail' : hasWarn ? 'warn' : 'pass';
+    // Determine next action from first failing check
+    const firstFail = checks.find(c => c.status === 'fail');
+    const firstWarn = checks.find(c => c.status === 'warn');
+    const nextAction = firstFail?.fix || firstWarn?.fix;
+    return {
+        timestamp: Date.now(),
+        overall,
+        checks,
+        nextAction,
+    };
+}
+function checkDatabase() {
+    try {
+        const db = getDb();
+        const row = db.prepare('SELECT 1 as ok').get();
+        if (row?.ok === 1) {
+            return { name: 'database', status: 'pass', message: 'SQLite database is accessible' };
+        }
+        return { name: 'database', status: 'fail', message: 'SQLite query returned unexpected result', fix: 'Check ~/.reflectt/data/ permissions' };
+    }
+    catch (err) {
+        return { name: 'database', status: 'fail', message: `SQLite error: ${String(err)}`, fix: 'Ensure better-sqlite3 is installed and ~/.reflectt/data/ is writable' };
+    }
+}
+function checkAgentsPresent() {
+    try {
+        const db = getDb();
+        // Check if any agents have posted messages (proxy for "agents are active")
+        const row = db.prepare('SELECT COUNT(DISTINCT "from") as count FROM chat_messages').get();
+        const chatAgentCount = row?.count ?? 0;
+        // Also check filesystem for agent dirs (avoids bootstrap paradox:
+        // agents created by starter team won't have chat messages yet)
+        let dirAgentCount = 0;
+        try {
+            const agentsDir = join(DATA_DIR, 'agents');
+            const entries = readdirSync(agentsDir);
+            dirAgentCount = entries.filter(name => {
+                try {
+                    return statSync(join(agentsDir, name)).isDirectory();
+                }
+                catch {
+                    return false;
+                }
+            }).length;
+        }
+        catch {
+            // agents dir may not exist yet — that's fine
+        }
+        const agentCount = Math.max(chatAgentCount, dirAgentCount);
+        const source = chatAgentCount >= dirAgentCount ? 'chat history' : 'agent directories';
+        if (agentCount >= 2) {
+            return { name: 'agents_present', status: 'pass', message: `${agentCount} agents detected (via ${source})` };
+        }
+        if (agentCount === 1) {
+            return {
+                name: 'agents_present',
+                status: 'warn',
+                message: `Only 1 agent detected (via ${source}) — teams work best with 2+`,
+                fix: 'Add another agent workspace or use the starter team template',
+            };
+        }
+        return {
+            name: 'agents_present',
+            status: 'fail',
+            message: 'No agents detected (checked chat history + agent directories)',
+            fix: 'Run the starter team template to create default agents, or manually create agent workspaces',
+        };
+    }
+    catch {
+        return { name: 'agents_present', status: 'warn', message: 'Could not check for agents (DB not ready)', fix: 'Start the node and let it initialize' };
+    }
+}
+function checkGateway(gatewayUrl) {
+    // Check if gateway env vars / config exist
+    const url = gatewayUrl || process.env.OPENCLAW_GATEWAY_URL || process.env.CLAWD_GATEWAY_URL;
+    const token = process.env.OPENCLAW_GATEWAY_TOKEN || process.env.CLAWD_GATEWAY_TOKEN;
+    if (!url) {
+        return {
+            name: 'gateway',
+            status: 'fail',
+            message: 'No gateway URL configured',
+            fix: 'Set OPENCLAW_GATEWAY_URL in .env or run `openclaw setup`',
+        };
+    }
+    if (!token) {
+        return {
+            name: 'gateway',
+            status: 'warn',
+            message: `Gateway URL set (${url}) but no token configured`,
+            fix: 'Set OPENCLAW_GATEWAY_TOKEN in .env (find it in ~/.openclaw/openclaw.json)',
+        };
+    }
+    return {
+        name: 'gateway',
+        status: 'pass',
+        message: `Gateway configured: ${url}`,
+    };
+}
+function checkModelAuth(provider) {
+    // Check for common LLM provider API keys
+    const providers = [
+        { name: 'Anthropic', keys: ['ANTHROPIC_API_KEY'] },
+        { name: 'OpenAI', keys: ['OPENAI_API_KEY'] },
+        { name: 'Google', keys: ['GOOGLE_API_KEY', 'GEMINI_API_KEY'] },
+    ];
+    const configured = [];
+    for (const p of providers) {
+        if (p.keys.some(k => process.env[k]?.trim())) {
+            configured.push(p.name);
+        }
+    }
+    if (configured.length === 0) {
+        return {
+            name: 'model_auth',
+            status: 'fail',
+            message: 'No LLM API keys found (checked ANTHROPIC_API_KEY, OPENAI_API_KEY, GOOGLE_API_KEY)',
+            fix: 'Add at least one LLM API key to your .env file (e.g. ANTHROPIC_API_KEY=sk-...)',
+        };
+    }
+    return {
+        name: 'model_auth',
+        status: 'pass',
+        message: `LLM providers configured: ${configured.join(', ')}`,
+    };
+}
+function checkOpenClawBootstrap() {
+    try {
+        const stateDir = process.env.OPENCLAW_STATE_DIR || join(homedir(), '.openclaw');
+        const candidates = [];
+        const mainWorkspace = join(stateDir, 'workspace');
+        if (existsSync(mainWorkspace))
+            candidates.push(mainWorkspace);
+        // workspace-<agent>
+        try {
+            for (const name of readdirSync(stateDir)) {
+                if (!name.startsWith('workspace-'))
+                    continue;
+                const full = join(stateDir, name);
+                try {
+                    if (statSync(full).isDirectory())
+                        candidates.push(full);
+                }
+                catch {
+                    // ignore
+                }
+            }
+        }
+        catch {
+            // ignore
+        }
+        if (candidates.length === 0) {
+            return {
+                name: 'openclaw_bootstrap',
+                status: 'warn',
+                message: `No OpenClaw workspaces found under ${stateDir}`,
+                fix: 'If OpenClaw is installed, ensure OPENCLAW_STATE_DIR is set correctly (or create ~/.openclaw/workspace)',
+            };
+        }
+        const bootstrapFiles = ['AGENTS.md', 'SOUL.md', 'TOOLS.md', 'IDENTITY.md', 'USER.md', 'HEARTBEAT.md', 'BOOTSTRAP.md', 'MEMORY.md', 'memory.md'];
+        const dupes = [];
+        const large = [];
+        for (const ws of candidates) {
+            const memA = join(ws, 'MEMORY.md');
+            const memB = join(ws, 'memory.md');
+            if (existsSync(memA) && existsSync(memB)) {
+                dupes.push({ ws, a: memA, b: memB });
+            }
+            for (const f of bootstrapFiles) {
+                const p = join(ws, f);
+                if (!existsSync(p))
+                    continue;
+                try {
+                    const bytes = statSync(p).size;
+                    // Heuristic: once any injected bootstrap file grows past ~8KB, it starts to materially bloat prompt tokens.
+                    if (bytes > 8000)
+                        large.push({ ws, file: f, bytes });
+                }
+                catch {
+                    // ignore
+                }
+            }
+        }
+        if (dupes.length === 0 && large.length === 0) {
+            return {
+                name: 'openclaw_bootstrap',
+                status: 'pass',
+                message: `OpenClaw bootstrap looks sane across ${candidates.length} workspace(s)`,
+            };
+        }
+        const parts = [];
+        if (dupes.length)
+            parts.push(`${dupes.length} workspace(s) have both MEMORY.md + memory.md (injected twice)`);
+        if (large.length) {
+            const worst = large.sort((a, b) => b.bytes - a.bytes)[0];
+            parts.push(`largest injected bootstrap file: ${worst.file} (${worst.bytes} bytes) in ${worst.ws}`);
+        }
+        return {
+            name: 'openclaw_bootstrap',
+            status: 'warn',
+            message: `OpenClaw bootstrap bloat risk: ${parts.join('; ')}`,
+            fix: 'Delete one of MEMORY.md/memory.md (keep only one), and keep injected bootstrap files concise (esp. TOOLS.md, AGENTS.md, MEMORY.md). Use daily notes in memory/YYYY-MM-DD.md instead of growing a root memory file.',
+        };
+    }
+    catch (err) {
+        return {
+            name: 'openclaw_bootstrap',
+            status: 'warn',
+            message: `Could not check OpenClaw bootstrap files: ${String(err)}`,
+            fix: 'Set OPENCLAW_STATE_DIR correctly and ensure the process can read workspace bootstrap files',
+        };
+    }
+}
+function checkChatActivity() {
+    try {
+        const db = getDb();
+        const row = db.prepare('SELECT COUNT(*) as count FROM chat_messages').get();
+        const count = row?.count ?? 0;
+        if (count > 10) {
+            return { name: 'chat_activity', status: 'pass', message: `${count} messages in chat history` };
+        }
+        if (count > 0) {
+            return { name: 'chat_activity', status: 'warn', message: `Only ${count} messages — agents may not be active yet`, fix: 'Send a test message via the chat API or wait for agents to start their heartbeats' };
+        }
+        return {
+            name: 'chat_activity',
+            status: 'warn',
+            message: 'No chat messages yet',
+            fix: 'This is normal on first run — agents will start communicating once configured and running',
+        };
+    }
+    catch {
+        return { name: 'chat_activity', status: 'warn', message: 'Could not check chat activity' };
+    }
+}
+//# sourceMappingURL=team-doctor.js.map

package/dist/team-doctor.js.map

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

package/dist/team-pulse.d.ts

@@ -0,0 +1,52 @@
+export interface TeamPulseConfig {
+    enabled: boolean;
+    /** Interval between pulses in minutes */
+    intervalMin: number;
+    /** Channel to post pulse to */
+    channel: string;
+    /** Active hours (24h format): only post during these hours */
+    activeHoursStart: number;
+    activeHoursEnd: number;
+    /** Agents to include in pulse */
+    agents: string[];
+    /** Minimum doing/todo tasks to suppress "idle team" warnings */
+    minActiveThreshold: number;
+}
+export interface AgentPulseStatus {
+    agent: string;
+    doingCount: number;
+    doingTitles: string[];
+    todoCount: number;
+    recentShips: number;
+    lastActivity: number | null;
+    status: 'active' | 'idle' | 'blocked';
+}
+export interface TeamPulseSnapshot {
+    timestamp: number;
+    agents: AgentPulseStatus[];
+    totalDoing: number;
+    totalTodo: number;
+    totalRecentShips: number;
+    teamStatus: 'healthy' | 'slow' | 'stalled';
+    queueDepth: number;
+}
+export declare function configureTeamPulse(partial: Partial<TeamPulseConfig>): void;
+export declare function getTeamPulseConfig(): TeamPulseConfig;
+/**
+ * Compute the current team pulse snapshot.
+ */
+export declare function computeTeamPulse(now?: number): TeamPulseSnapshot;
+/**
+ * Format a pulse snapshot into a readable message.
+ */
+export declare function formatPulseMessage(pulse: TeamPulseSnapshot): string;
+/**
+ * Post a team pulse to the configured channel.
+ */
+export declare function postTeamPulse(now?: number): Promise<TeamPulseSnapshot>;
+export declare function startTeamPulse(): void;
+export declare function stopTeamPulse(): void;
+export declare function getTeamPulseHistory(): TeamPulseSnapshot[];
+export declare function getLastPulseAt(): number;
+export declare function _resetTeamPulse(): void;
+//# sourceMappingURL=team-pulse.d.ts.map

package/dist/team-pulse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-pulse.d.ts","sourceRoot":"","sources":["../src/team-pulse.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAA;IAChB,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAA;IACnB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,8DAA8D;IAC9D,gBAAgB,EAAE,MAAM,CAAA;IACxB,cAAc,EAAE,MAAM,CAAA;IACtB,iCAAiC;IACjC,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,gEAAgE;IAChE,kBAAkB,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAA;CACtC;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,gBAAgB,EAAE,CAAA;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,gBAAgB,EAAE,MAAM,CAAA;IACxB,UAAU,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAAA;IAC1C,UAAU,EAAE,MAAM,CAAA;CACnB;AAqBD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI,CAE1E;AAED,wBAAgB,kBAAkB,IAAI,eAAe,CAEpD;AAID;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,SAAa,GAAG,iBAAiB,CAiEpE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAqBnE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,GAAG,SAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAmBhF;AASD,wBAAgB,cAAc,IAAI,IAAI,CAkBrC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAED,wBAAgB,mBAAmB,IAAI,iBAAiB,EAAE,CAEzD;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAID,wBAAgB,eAAe,IAAI,IAAI,CAGtC"}

package/dist/team-pulse.js

@@ -0,0 +1,176 @@
+// SPDX-License-Identifier: Apache-2.0
+// Team Pulse — Proactive periodic team status broadcast
+//
+// Addresses the trust gap: human confidence drops when autonomous activity
+// isn't visibly progressing. Posts a structured status summary at regular
+// intervals so stakeholders see real work without needing to ask.
+//
+// Frequency: configurable (default: every 2 hours during active hours)
+// Channel: configurable (default: ops, with option for general)
+// Content: per-agent lane status, recent ships, blockers, queue depth
+import { taskManager } from './tasks.js';
+import { routeMessage } from './messageRouter.js';
+// ── State ──
+let config = {
+    enabled: true,
+    intervalMin: 120, // 2 hours
+    channel: 'ops',
+    activeHoursStart: 8,
+    activeHoursEnd: 22,
+    agents: ['link', 'sage', 'kai', 'pixel', 'echo', 'scout', 'harmony'],
+    minActiveThreshold: 2,
+};
+let timer = null;
+let lastPulseAt = 0;
+let pulseHistory = [];
+const MAX_PULSE_HISTORY = 48; // 4 days at 2h intervals
+// ── Config ──
+export function configureTeamPulse(partial) {
+    config = { ...config, ...partial };
+}
+export function getTeamPulseConfig() {
+    return { ...config };
+}
+// ── Core ──
+/**
+ * Compute the current team pulse snapshot.
+ */
+export function computeTeamPulse(now = Date.now()) {
+    const windowMs = config.intervalMin * 60_000;
+    const since = now - windowMs;
+    const agentStatuses = config.agents.map(agent => {
+        const doingTasks = taskManager.listTasks({ status: 'doing', assignee: agent });
+        const todoTasks = taskManager.listTasks({ status: 'todo', assignee: agent });
+        // Count tasks that moved to done within the pulse window
+        const allTasks = taskManager.listTasks({ assignee: agent });
+        const recentShips = allTasks.filter(t => t.status === 'done' && t.updatedAt >= since).length;
+        // Most recent task activity
+        const allAgentTasks = [...doingTasks, ...todoTasks, ...allTasks];
+        const lastActivity = allAgentTasks.length > 0
+            ? Math.max(...allAgentTasks.map(t => t.updatedAt))
+            : null;
+        // Determine status
+        let status = 'idle';
+        if (doingTasks.length > 0) {
+            status = 'active';
+        }
+        // Check for blocked
+        const blockedTasks = doingTasks.filter(t => t.status === 'doing' && lastActivity && (now - lastActivity > 2 * 60 * 60_000));
+        if (blockedTasks.length > 0 && doingTasks.length > 0) {
+            status = 'blocked';
+        }
+        return {
+            agent,
+            doingCount: doingTasks.length,
+            doingTitles: doingTasks.slice(0, 3).map(t => t.title.slice(0, 60)),
+            todoCount: todoTasks.length,
+            recentShips,
+            lastActivity,
+            status,
+        };
+    });
+    const totalDoing = agentStatuses.reduce((sum, a) => sum + a.doingCount, 0);
+    const totalTodo = agentStatuses.reduce((sum, a) => sum + a.todoCount, 0);
+    const totalRecentShips = agentStatuses.reduce((sum, a) => sum + a.recentShips, 0);
+    const activeAgents = agentStatuses.filter(a => a.status === 'active').length;
+    let teamStatus = 'healthy';
+    if (totalDoing === 0 && totalTodo === 0) {
+        teamStatus = 'stalled';
+    }
+    else if (activeAgents < config.minActiveThreshold) {
+        teamStatus = 'slow';
+    }
+    return {
+        timestamp: now,
+        agents: agentStatuses,
+        totalDoing,
+        totalTodo,
+        totalRecentShips,
+        teamStatus,
+        queueDepth: totalTodo,
+    };
+}
+/**
+ * Format a pulse snapshot into a readable message.
+ */
+export function formatPulseMessage(pulse) {
+    const statusEmoji = pulse.teamStatus === 'healthy' ? '🟢' : pulse.teamStatus === 'slow' ? '🟡' : '🔴';
+    const lines = [];
+    lines.push(`${statusEmoji} **Team Pulse** — ${pulse.totalDoing} active, ${pulse.totalTodo} queued, ${pulse.totalRecentShips} shipped recently`);
+    lines.push('');
+    for (const agent of pulse.agents) {
+        if (agent.doingCount === 0 && agent.todoCount === 0 && agent.recentShips === 0)
+            continue;
+        const statusIcon = agent.status === 'active' ? '🔵' : agent.status === 'blocked' ? '🔴' : '⚪';
+        const doing = agent.doingCount > 0 ? agent.doingTitles.map(t => `_${t}_`).join(', ') : 'idle';
+        lines.push(`${statusIcon} **${agent.agent}**: ${doing} (${agent.todoCount} queued, ${agent.recentShips} shipped)`);
+    }
+    if (pulse.teamStatus === 'stalled') {
+        lines.push('');
+        lines.push('⚠️ No active or queued work detected.');
+    }
+    return lines.join('\n');
+}
+/**
+ * Post a team pulse to the configured channel.
+ */
+export async function postTeamPulse(now = Date.now()) {
+    const pulse = computeTeamPulse(now);
+    const message = formatPulseMessage(pulse);
+    await routeMessage({
+        from: 'system',
+        content: message,
+        category: 'status-update',
+        severity: pulse.teamStatus === 'stalled' ? 'warning' : 'info',
+        forceChannel: config.channel,
+    });
+    lastPulseAt = now;
+    pulseHistory.push(pulse);
+    if (pulseHistory.length > MAX_PULSE_HISTORY) {
+        pulseHistory.splice(0, pulseHistory.length - MAX_PULSE_HISTORY);
+    }
+    return pulse;
+}
+// ── Lifecycle ──
+function isActiveHours(now = Date.now()) {
+    const hour = new Date(now).getHours();
+    return hour >= config.activeHoursStart && hour < config.activeHoursEnd;
+}
+export function startTeamPulse() {
+    if (!config.enabled)
+        return;
+    if (timer)
+        return;
+    const checkIntervalMs = 5 * 60_000; // Check every 5 minutes
+    timer = setInterval(() => {
+        if (!isActiveHours())
+            return;
+        const now = Date.now();
+        const intervalMs = config.intervalMin * 60_000;
+        if (now - lastPulseAt >= intervalMs) {
+            void postTeamPulse(now).catch(err => {
+                console.error('[TeamPulse] Failed to post pulse:', err);
+            });
+        }
+    }, checkIntervalMs);
+    timer.unref();
+    console.log(`[TeamPulse] Started (every ${config.intervalMin}m, ${config.activeHoursStart}-${config.activeHoursEnd}h)`);
+}
+export function stopTeamPulse() {
+    if (timer) {
+        clearInterval(timer);
+        timer = null;
+    }
+}
+export function getTeamPulseHistory() {
+    return [...pulseHistory];
+}
+export function getLastPulseAt() {
+    return lastPulseAt;
+}
+// ── Test helpers ──
+export function _resetTeamPulse() {
+    lastPulseAt = 0;
+    pulseHistory = [];
+}
+//# sourceMappingURL=team-pulse.js.map

package/dist/team-pulse.js.map

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

package/dist/telemetry.d.ts

@@ -0,0 +1,74 @@
+export interface TelemetryConfig {
+    enabled: boolean;
+    cloudUrl: string;
+    hostId: string;
+    reportIntervalMs: number;
+}
+interface EndpointMetric {
+    path: string;
+    method: string;
+    hits: number;
+    errors: number;
+    totalDurationMs: number;
+    avgDurationMs: number;
+    p95DurationMs: number;
+    lastHit: number;
+}
+interface ErrorEntry {
+    type: string;
+    endpoint?: string;
+    count: number;
+    lastSeen: number;
+}
+export interface TelemetrySnapshot {
+    version: string;
+    hostId: string;
+    timestamp: number;
+    uptime: number;
+    period: {
+        startMs: number;
+        endMs: number;
+    };
+    team: {
+        agentCount: number;
+        activeAgentCount: number;
+    };
+    tasks: {
+        total: number;
+        created: number;
+        completed: number;
+        avgCycleTimeMs: number;
+        byStatus: Record<string, number>;
+    };
+    endpoints: EndpointMetric[];
+    features: Record<string, number>;
+    errors: ErrorEntry[];
+    health: {
+        uptimeMs: number;
+        avgResponseTimeMs: number;
+        errorRate: number;
+        requestsTotal: number;
+    };
+}
+/** Initialize telemetry with config */
+export declare function initTelemetry(cfg: Partial<TelemetryConfig>): void;
+/** Stop telemetry reporting */
+export declare function stopTelemetry(): void;
+/** Track an HTTP request (call from onResponse hook) */
+export declare function trackRequest(method: string, path: string, statusCode: number, durationMs: number): void;
+/** Track an error (no PII — just type + endpoint) */
+export declare function trackError(type: string, endpoint?: string): void;
+/** Track a task event */
+export declare function trackTaskEvent(event: 'created' | 'completed'): void;
+/** Get current telemetry snapshot (also used by GET /telemetry endpoint) */
+export declare function getSnapshot(): TelemetrySnapshot;
+/** Check if telemetry is enabled */
+export declare function isTelemetryEnabled(): boolean;
+/** Get telemetry config (safe — no secrets) */
+export declare function getTelemetryConfig(): {
+    enabled: boolean;
+    cloudUrl: string;
+    reportIntervalMs: number;
+};
+export {};
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AA0BA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAED,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,eAAe,EAAE,MAAM,CAAA;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAA;QACf,KAAK,EAAE,MAAM,CAAA;KACd,CAAA;IACD,IAAI,EAAE;QACJ,UAAU,EAAE,MAAM,CAAA;QAClB,gBAAgB,EAAE,MAAM,CAAA;KACzB,CAAA;IACD,KAAK,EAAE;QACL,KAAK,EAAE,MAAM,CAAA;QACb,OAAO,EAAE,MAAM,CAAA;QACf,SAAS,EAAE,MAAM,CAAA;QACjB,cAAc,EAAE,MAAM,CAAA;QACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KACjC,CAAA;IACD,SAAS,EAAE,cAAc,EAAE,CAAA;IAC3B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,MAAM,EAAE,UAAU,EAAE,CAAA;IACpB,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAA;QAChB,iBAAiB,EAAE,MAAM,CAAA;QACzB,SAAS,EAAE,MAAM,CAAA;QACjB,aAAa,EAAE,MAAM,CAAA;KACtB,CAAA;CACF;AA2BD,uCAAuC;AACvC,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI,CAmBjE;AAED,+BAA+B;AAC/B,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAmBvG;AAED,qDAAqD;AACrD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAShE;AAED,yBAAyB;AACzB,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,WAAW,GAAG,IAAI,CAInE;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,IAAI,iBAAiB,CA6E/C;AAED,oCAAoC;AACpC,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED,+CAA+C;AAC/C,wBAAgB,kBAAkB,IAAI;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,CAMrG"}