@telora/daemon 0.12.33

package/dist/otlp-metric-parser.js

@@ -0,0 +1,113 @@
+/**
+ * OTLP metrics payload parser.
+ *
+ * Parses OpenTelemetry metrics JSON payloads from Claude Code and
+ * buffers metric rows for batched Postgres inserts.
+ */
+import { extractResourceAttributes, buildFactoryMetadata, getDataPointValue, getDataPointAttribute, nanoToIso, } from './otlp-types.js';
+import { bufferMetric, } from './telemetry-writer.js';
+/**
+ * Parse OTLP metrics payload and buffer metric rows.
+ *
+ * Claude Code emits these metrics (per official OTel schema):
+ * - claude_code.token.usage (Counter, attrs: type=input|output|cacheRead|cacheCreation, model)
+ * - claude_code.cost.usage (Counter, attr: model, unit: USD)
+ * - claude_code.active_time.total (Counter, unit: seconds)
+ * - claude_code.session.count, claude_code.lines_of_code.count, etc.
+ *
+ * We aggregate per-resource into a single TelemetryMetricRow.
+ */
+export function processMetrics(payload, fallbackOrgId) {
+    if (!payload.resourceMetrics)
+        return;
+    for (const rm of payload.resourceMetrics) {
+        const attrs = extractResourceAttributes(rm.resource);
+        const orgId = attrs.orgId ?? fallbackOrgId;
+        // Collect all metric values into a single row per resource
+        const factoryMeta = buildFactoryMetadata(attrs);
+        const row = {
+            organization_id: orgId,
+            strategy_id: attrs.strategyId,
+            delivery_id: attrs.deliveryId,
+            session_id: attrs.sessionId,
+            input_tokens: 0,
+            output_tokens: 0,
+            cache_read_tokens: 0,
+            cache_creation_tokens: 0,
+            cost_usd: 0,
+            active_time_ms: 0,
+            tool_call_count: 0,
+            tool_error_count: 0,
+            model: null,
+            metadata: factoryMeta,
+            period_start: new Date().toISOString(),
+            period_end: new Date().toISOString(),
+        };
+        let hasData = false;
+        let earliestNano;
+        let latestNano;
+        for (const sm of rm.scopeMetrics ?? []) {
+            for (const metric of sm.metrics ?? []) {
+                const dataPoints = metric.sum?.dataPoints ?? metric.gauge?.dataPoints ?? [];
+                for (const dp of dataPoints) {
+                    const value = getDataPointValue(dp);
+                    // Track time range
+                    if (dp.startTimeUnixNano && (!earliestNano || dp.startTimeUnixNano < earliestNano)) {
+                        earliestNano = dp.startTimeUnixNano;
+                    }
+                    if (dp.timeUnixNano && (!latestNano || dp.timeUnixNano > latestNano)) {
+                        latestNano = dp.timeUnixNano;
+                    }
+                    switch (metric.name) {
+                        case 'claude_code.token.usage': {
+                            // Token usage has a `type` attribute: input, output, cacheRead, cacheCreation
+                            const tokenType = getDataPointAttribute(dp, 'type');
+                            // Extract model from first data point that has it
+                            if (!row.model) {
+                                row.model = getDataPointAttribute(dp, 'model');
+                            }
+                            switch (tokenType) {
+                                case 'input':
+                                    row.input_tokens = value;
+                                    hasData = true;
+                                    break;
+                                case 'output':
+                                    row.output_tokens = value;
+                                    hasData = true;
+                                    break;
+                                case 'cacheRead':
+                                    row.cache_read_tokens = value;
+                                    hasData = true;
+                                    break;
+                                case 'cacheCreation':
+                                    row.cache_creation_tokens = value;
+                                    hasData = true;
+                                    break;
+                            }
+                            break;
+                        }
+                        case 'claude_code.cost.usage':
+                            row.cost_usd = value;
+                            hasData = true;
+                            break;
+                        case 'claude_code.active_time.total':
+                            // Claude emits seconds, DB stores milliseconds
+                            row.active_time_ms = Math.round(value * 1000);
+                            hasData = true;
+                            break;
+                        // code_edit_tool.decision tracks Edit/Write/NotebookEdit permission
+                        // decisions (accept/reject), not general tool calls. Tool call counts
+                        // are derived from tool_result log events in processLogs() instead.
+                        // Unknown metrics (session.count, lines_of_code.count, etc.) are silently ignored
+                    }
+                }
+            }
+        }
+        if (hasData) {
+            row.period_start = nanoToIso(earliestNano);
+            row.period_end = nanoToIso(latestNano);
+            bufferMetric(row);
+        }
+    }
+}
+//# sourceMappingURL=otlp-metric-parser.js.map

package/dist/otlp-metric-parser.js.map

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

package/dist/otlp-port-manager.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Stale OTLP port detection and reclaim.
+ *
+ * Checks if the OTLP receiver port is held by an orphaned process
+ * from a previous daemon instance and reclaims it if safe.
+ */
+/**
+ * Check if a port is currently in use by attempting a TCP connection.
+ * Returns true if something is listening on the port.
+ */
+export declare function isPortInUse(port: number, host?: string): Promise<boolean>;
+/**
+ * Find the PID(s) holding a given TCP port using `lsof`.
+ * Returns an array of PIDs (may be empty if lsof is unavailable or no match).
+ */
+export declare function findPidsOnPort(port: number): number[];
+/**
+ * Attempt to reclaim a stale OTLP port.
+ *
+ * Checks if the port is in use, cross-references with the PID file,
+ * and kills orphaned processes if the recorded daemon PID is stale.
+ *
+ * @returns true if reclaim was attempted (port was in use), false if port was free
+ */
+export declare function reclaimStalePort(port: number, pidFilePath: string | undefined): Promise<boolean>;
+//# sourceMappingURL=otlp-port-manager.d.ts.map

package/dist/otlp-port-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otlp-port-manager.d.ts","sourceRoot":"","sources":["../src/otlp-port-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAiBtF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAgBrD;AA4BD;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CA6CtG"}

package/dist/otlp-port-manager.js

@@ -0,0 +1,130 @@
+/**
+ * Stale OTLP port detection and reclaim.
+ *
+ * Checks if the OTLP receiver port is held by an orphaned process
+ * from a previous daemon instance and reclaims it if safe.
+ */
+import { connect as netConnect } from 'node:net';
+import { execFileSync } from 'node:child_process';
+import { readFileSync, existsSync } from 'node:fs';
+/**
+ * Check if a port is currently in use by attempting a TCP connection.
+ * Returns true if something is listening on the port.
+ */
+export function isPortInUse(port, host = '127.0.0.1') {
+    return new Promise((resolve) => {
+        const socket = netConnect({ port, host });
+        socket.once('connect', () => {
+            socket.destroy();
+            resolve(true);
+        });
+        socket.once('error', () => {
+            socket.destroy();
+            resolve(false);
+        });
+        // Short timeout -- we only need to know if something answers
+        socket.setTimeout(1000, () => {
+            socket.destroy();
+            resolve(false);
+        });
+    });
+}
+/**
+ * Find the PID(s) holding a given TCP port using `lsof`.
+ * Returns an array of PIDs (may be empty if lsof is unavailable or no match).
+ */
+export function findPidsOnPort(port) {
+    try {
+        // -i :port -t returns just PIDs, one per line
+        const output = execFileSync('lsof', ['-i', `:${port}`, '-t', '-sTCP:LISTEN'], {
+            encoding: 'utf-8',
+            timeout: 5000,
+        });
+        return output
+            .trim()
+            .split('\n')
+            .map(line => parseInt(line.trim(), 10))
+            .filter(pid => !isNaN(pid) && pid > 0);
+    }
+    catch {
+        // lsof not available or no matches -- not fatal
+        return [];
+    }
+}
+/**
+ * Check if a process with the given PID is alive.
+ */
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Read the daemon PID file and return the PID, or null if unreadable/missing.
+ */
+function readDaemonPid(pidFilePath) {
+    if (!pidFilePath || !existsSync(pidFilePath))
+        return null;
+    try {
+        const contents = readFileSync(pidFilePath, 'utf-8').trim();
+        const pid = parseInt(contents, 10);
+        return isNaN(pid) ? null : pid;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Attempt to reclaim a stale OTLP port.
+ *
+ * Checks if the port is in use, cross-references with the PID file,
+ * and kills orphaned processes if the recorded daemon PID is stale.
+ *
+ * @returns true if reclaim was attempted (port was in use), false if port was free
+ */
+export async function reclaimStalePort(port, pidFilePath) {
+    const inUse = await isPortInUse(port);
+    if (!inUse)
+        return false;
+    console.warn(`[otlp-receiver] Port ${port} is already in use, attempting reclaim`);
+    // Read the daemon PID file to check if the previous daemon is still alive
+    const daemonPid = readDaemonPid(pidFilePath);
+    if (daemonPid !== null && isProcessAlive(daemonPid)) {
+        // The previous daemon is still running -- do not kill it.
+        // The caller (acquirePidFile in index.ts) should have caught this.
+        console.warn(`[otlp-receiver] Previous daemon (PID ${daemonPid}) is still alive -- cannot reclaim`);
+        return true;
+    }
+    // Previous daemon is dead (or no PID file). Find what holds the port.
+    const pids = findPidsOnPort(port);
+    if (pids.length === 0) {
+        // Port appears in use but lsof found nothing -- possibly TIME_WAIT.
+        // SO_REUSEADDR + retry should handle this.
+        console.log('[otlp-receiver] No process found holding port (likely TIME_WAIT)');
+        return true;
+    }
+    // Kill orphaned processes that are holding the port.
+    // Only kill processes that are NOT the current daemon.
+    for (const pid of pids) {
+        if (pid === process.pid)
+            continue;
+        // If we have a PID file, only kill processes that match the stale daemon PID
+        // or are children of it. Without ppid checks, be conservative: kill if
+        // the daemon PID is stale (already verified above).
+        console.log(`[otlp-receiver] Killing orphaned process ${pid} holding port ${port}`);
+        try {
+            process.kill(pid, 'SIGTERM');
+        }
+        catch (err) {
+            console.warn(`[otlp-receiver] Failed to kill PID ${pid}: ${err.message}`);
+        }
+    }
+    // Give killed processes a moment to release the port
+    await new Promise(resolve => setTimeout(resolve, 500));
+    return true;
+}
+//# sourceMappingURL=otlp-port-manager.js.map

package/dist/otlp-port-manager.js.map

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

package/dist/otlp-receiver.d.ts

@@ -0,0 +1,51 @@
+/**
+ * OTLP HTTP Receiver for agent telemetry.
+ *
+ * Lightweight HTTP server accepting OpenTelemetry JSON payloads:
+ * - POST /v1/metrics  -- OTLP metrics (token counts, cost, tool calls)
+ * - POST /v1/logs     -- OTLP logs (tool call events, errors)
+ *
+ * Extracts Telora resource attributes (telora.org_id, telora.strategy_id,
+ * telora.delivery_id) for entity correlation and forwards parsed data
+ * to the telemetry writer for batched Postgres inserts.
+ *
+ * Runs on a configurable port (default 4318) alongside the daemon process.
+ */
+import type { TelemetryConfig } from './types.js';
+/**
+ * Check if a port is currently in use by attempting a TCP connection.
+ * Returns true if something is listening on the port.
+ */
+export declare function isPortInUse(port: number, host?: string): Promise<boolean>;
+/**
+ * Find the PID(s) holding a given TCP port using `lsof`.
+ * Returns an array of PIDs (may be empty if lsof is unavailable or no match).
+ */
+export declare function findPidsOnPort(port: number): number[];
+/**
+ * Attempt to reclaim a stale OTLP port.
+ *
+ * Checks if the port is in use, cross-references with the PID file,
+ * and kills orphaned processes if the recorded daemon PID is stale.
+ *
+ * @returns true if reclaim was attempted (port was in use), false if port was free
+ */
+export declare function reclaimStalePort(port: number, pidFilePath: string | undefined): Promise<boolean>;
+/**
+ * Start the OTLP HTTP receiver server.
+ *
+ * Performs stale port detection and reclaim before binding, then retries
+ * with exponential backoff if EADDRINUSE persists (e.g. TIME_WAIT).
+ *
+ * @param pidFilePath - Path to the daemon PID file for stale process detection
+ */
+export declare function startOtlpReceiver(config: TelemetryConfig, organizationId: string, pidFilePath?: string): Promise<void>;
+/**
+ * Stop the OTLP HTTP receiver server.
+ *
+ * Closes all open connections and waits for the server to shut down.
+ * If the server doesn't close within SHUTDOWN_TIMEOUT_MS, it is
+ * force-destroyed to prevent hanging on stale keep-alive connections.
+ */
+export declare function stopOtlpReceiver(): Promise<void>;
+//# sourceMappingURL=otlp-receiver.d.ts.map

package/dist/otlp-receiver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otlp-receiver.d.ts","sourceRoot":"","sources":["../src/otlp-receiver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AA0dlD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAiBtF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAgBrD;AA4BD;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CA6CtG;AAgCD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,eAAe,EACvB,cAAc,EAAE,MAAM,EACtB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAwEf;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CA2BhD"}