@origintrail-official/dkg-node-ui 0.0.1-dev.1773506972.23bf9c0

package/dist/llm/provider-adapter.js

@@ -0,0 +1,199 @@
+function normalizeToolCalls(raw) {
+    if (!Array.isArray(raw) || raw.length === 0)
+        return undefined;
+    const normalized = raw
+        .map((tc, idx) => ({
+        id: tc.id ?? `call_${idx}`,
+        type: 'function',
+        function: {
+            name: tc.function?.name ?? '',
+            arguments: tc.function?.arguments ?? '',
+        },
+    }))
+        .filter(tc => tc.function.name);
+    return normalized.length > 0 ? normalized : undefined;
+}
+export class OpenAICompatibleAdapter {
+    endpoint(baseURL) {
+        return `${baseURL.replace(/\/$/, '')}/chat/completions`;
+    }
+    buildRequestPayload(request, caps) {
+        const model = request.config.model || 'gpt-5-mini';
+        const body = {
+            model,
+            messages: request.messages,
+        };
+        if (request.tools && request.tools.length > 0 && caps.supportsTools) {
+            body.tools = request.tools;
+            body.tool_choice = request.toolChoice ?? 'auto';
+        }
+        if (request.maxTokens != null && caps.supportsMaxTokens)
+            body.max_tokens = request.maxTokens;
+        if (request.temperature != null && caps.supportsTemperature)
+            body.temperature = request.temperature;
+        if (request.stream === true && caps.supportsStreaming)
+            body.stream = true;
+        return body;
+    }
+    parseBlockingResponse(responseBody) {
+        const data = responseBody;
+        const msg = data.choices?.[0]?.message;
+        if (!msg)
+            throw new Error('Empty LLM response');
+        return {
+            content: msg.content ?? undefined,
+            tool_calls: normalizeToolCalls(msg.tool_calls),
+        };
+    }
+    async *streamEvents(response) {
+        if (!response.body) {
+            const text = await response.text();
+            let parsed = {};
+            try {
+                parsed = JSON.parse(text);
+            }
+            catch {
+                parsed = {};
+            }
+            const message = this.parseBlockingResponse(parsed);
+            if (message.content)
+                yield { type: 'text_delta', delta: message.content };
+            if (message.tool_calls) {
+                for (const tc of message.tool_calls) {
+                    yield {
+                        type: 'tool_call_delta',
+                        callId: tc.id,
+                        name: tc.function.name,
+                        argumentsDelta: tc.function.arguments,
+                    };
+                }
+            }
+            yield { type: 'final', mode: 'blocking', message };
+            return { mode: 'blocking', message, raw: parsed };
+        }
+        const decoder = new TextDecoder();
+        const reader = response.body.getReader();
+        let buffer = '';
+        let content = '';
+        let sawSseFrame = false;
+        const toolAccumulator = new Map();
+        const parseDataLine = (dataLine) => {
+            const events = [];
+            const data = dataLine.trim();
+            if (!data || data === '[DONE]')
+                return events;
+            let parsed;
+            try {
+                parsed = JSON.parse(data);
+            }
+            catch {
+                return events;
+            }
+            const delta = parsed.choices?.[0]?.delta;
+            if (!delta)
+                return events;
+            if (typeof delta.content === 'string' && delta.content.length > 0) {
+                content += delta.content;
+                events.push({ type: 'text_delta', delta: delta.content });
+            }
+            const toolCalls = Array.isArray(delta.tool_calls) ? delta.tool_calls : [];
+            for (const tc of toolCalls) {
+                const idx = tc.index ?? 0;
+                const existing = toolAccumulator.get(idx) ?? {
+                    id: tc.id ?? `call_${idx}`,
+                    name: '',
+                    arguments: '',
+                };
+                if (tc.id)
+                    existing.id = tc.id;
+                if (tc.function?.name)
+                    existing.name += tc.function.name;
+                if (typeof tc.function?.arguments === 'string') {
+                    existing.arguments += tc.function.arguments;
+                    events.push({
+                        type: 'tool_call_delta',
+                        callId: existing.id,
+                        name: existing.name || undefined,
+                        argumentsDelta: tc.function.arguments,
+                    });
+                }
+                toolAccumulator.set(idx, existing);
+            }
+            return events;
+        };
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            let lineEnd = buffer.indexOf('\n');
+            while (lineEnd !== -1) {
+                const rawLine = buffer.slice(0, lineEnd).trim();
+                buffer = buffer.slice(lineEnd + 1);
+                lineEnd = buffer.indexOf('\n');
+                if (!rawLine.startsWith('data:'))
+                    continue;
+                sawSseFrame = true;
+                const dataLine = rawLine.slice(5);
+                const events = parseDataLine(dataLine);
+                for (const ev of events)
+                    yield ev;
+            }
+        }
+        const flushed = decoder.decode();
+        if (flushed)
+            buffer += flushed;
+        if (buffer.trim().startsWith('data:')) {
+            sawSseFrame = true;
+            const dataLine = buffer.trim().slice(5);
+            const events = parseDataLine(dataLine);
+            for (const ev of events)
+                yield ev;
+        }
+        if (!sawSseFrame && buffer.trim()) {
+            let parsed = {};
+            try {
+                parsed = JSON.parse(buffer.trim());
+            }
+            catch {
+                parsed = {};
+            }
+            const message = this.parseBlockingResponse(parsed);
+            if (message.content)
+                yield { type: 'text_delta', delta: message.content };
+            if (message.tool_calls) {
+                for (const tc of message.tool_calls) {
+                    yield {
+                        type: 'tool_call_delta',
+                        callId: tc.id,
+                        name: tc.function.name,
+                        argumentsDelta: tc.function.arguments,
+                    };
+                }
+            }
+            yield { type: 'final', mode: 'blocking', message };
+            return { mode: 'blocking', message, raw: parsed };
+        }
+        const toolCalls = Array.from(toolAccumulator.values())
+            .filter(tc => tc.name)
+            .map((tc) => ({
+            id: tc.id,
+            type: 'function',
+            function: {
+                name: tc.name,
+                arguments: tc.arguments,
+            },
+        }));
+        const message = {
+            content: content || undefined,
+            tool_calls: toolCalls.length > 0 ? toolCalls : undefined,
+        };
+        yield { type: 'final', mode: 'streaming', message };
+        return { mode: 'streaming', message };
+    }
+    normalizeError(status, rawText) {
+        const snippet = rawText.slice(0, 300);
+        return `LLM API ${status}: ${snippet}`;
+    }
+}
+//# sourceMappingURL=provider-adapter.js.map

package/dist/llm/provider-adapter.js.map

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

package/dist/llm/types.d.ts

@@ -0,0 +1,64 @@
+export interface LlmConfig {
+    apiKey: string;
+    model?: string;
+    baseURL?: string;
+    systemPrompt?: string;
+}
+export type LlmMessageRole = 'system' | 'user' | 'assistant' | 'tool';
+export interface LlmToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface LlmChatMessage {
+    role: LlmMessageRole;
+    content?: string;
+    tool_calls?: LlmToolCall[];
+    tool_call_id?: string;
+    name?: string;
+}
+export interface LlmChatRequest {
+    config: LlmConfig;
+    messages: LlmChatMessage[];
+    tools?: unknown[];
+    toolChoice?: unknown;
+    maxTokens?: number;
+    temperature?: number;
+    stream?: boolean;
+}
+export interface LlmAssistantMessage {
+    content?: string;
+    tool_calls?: LlmToolCall[];
+}
+export interface LlmCompletionResult {
+    mode: 'streaming' | 'blocking';
+    message: LlmAssistantMessage;
+    raw?: unknown;
+}
+export type LlmStreamEvent = {
+    type: 'text_delta';
+    delta: string;
+} | {
+    type: 'tool_call_delta';
+    callId: string;
+    name?: string;
+    argumentsDelta?: string;
+} | {
+    type: 'final';
+    mode: 'streaming' | 'blocking';
+    message: LlmAssistantMessage;
+} | {
+    type: 'error';
+    error: string;
+};
+export interface LlmCapabilities {
+    provider: 'openai-compatible';
+    supportsStreaming: boolean;
+    supportsTools: boolean;
+    supportsTemperature: boolean;
+    supportsMaxTokens: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/llm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/llm/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;AAEtE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC;IAC/B,OAAO,EAAE,mBAAmB,CAAC;IAC7B,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GACnF;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC;IAAC,OAAO,EAAE,mBAAmB,CAAA;CAAE,GAC/E;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAErC,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,iBAAiB,EAAE,OAAO,CAAC;CAC5B"}

package/dist/llm/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/llm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/llm/types.ts"],"names":[],"mappings":""}

package/dist/metrics-collector.d.ts

@@ -0,0 +1,36 @@
+import type { DashboardDB, MetricSnapshotRow } from './db.js';
+export interface MetricsSource {
+    getPeerCount(): number;
+    getDirectPeerCount(): number;
+    getRelayedPeerCount(): number;
+    getMeshPeerCount(): number;
+    getParanetCount(): Promise<number>;
+    getTotalTriples(): Promise<number>;
+    getTotalKCs(): Promise<number>;
+    getTotalKAs(): Promise<number>;
+    getConfirmedKCs(): Promise<number>;
+    getTentativeKCs(): Promise<number>;
+    getStoreBytes(): Promise<number>;
+    getRpcLatencyMs(): Promise<number>;
+    isRpcHealthy(): Promise<boolean>;
+}
+/**
+ * Periodically collects system, network, knowledge, and chain metrics
+ * and stores them as snapshots in SQLite.
+ */
+export declare class MetricsCollector {
+    private readonly db;
+    private readonly source;
+    private readonly dataDir?;
+    private timer;
+    private prevCpuTimes;
+    private readonly startTime;
+    constructor(db: DashboardDB, source: MetricsSource, dataDir?: string | undefined);
+    start(): void;
+    private backfillNulls;
+    stop(): void;
+    collectAndStore(): Promise<MetricSnapshotRow>;
+    collect(): Promise<MetricSnapshotRow>;
+    private measureCpu;
+}
+//# sourceMappingURL=metrics-collector.d.ts.map

package/dist/metrics-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-collector.d.ts","sourceRoot":"","sources":["../src/metrics-collector.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE9D,MAAM,WAAW,aAAa;IAC5B,YAAY,IAAI,MAAM,CAAC;IACvB,kBAAkB,IAAI,MAAM,CAAC;IAC7B,mBAAmB,IAAI,MAAM,CAAC;IAC9B,gBAAgB,IAAI,MAAM,CAAC;IAC3B,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACjC,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAClC;AAID;;;GAGG;AACH,qBAAa,gBAAgB;IAMzB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAP3B,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,YAAY,CAAgD;IACpE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;gBAGrB,EAAE,EAAE,WAAW,EACf,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,MAAM,YAAA;IAGnC,KAAK,IAAI,IAAI;IAUb,OAAO,CAAC,aAAa;IAUrB,IAAI,IAAI,IAAI;IAON,eAAe,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAM7C,OAAO,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAmE3C,OAAO,CAAC,UAAU;CAqBnB"}

package/dist/metrics-collector.js

@@ -0,0 +1,155 @@
+import { cpus, totalmem, freemem } from 'node:os';
+import { memoryUsage } from 'node:process';
+import { statfs } from 'node:fs';
+import { promisify } from 'node:util';
+const statfsAsync = promisify(statfs);
+const SNAPSHOT_INTERVAL_MS = 120_000; // 2 minutes
+/**
+ * Periodically collects system, network, knowledge, and chain metrics
+ * and stores them as snapshots in SQLite.
+ */
+export class MetricsCollector {
+    db;
+    source;
+    dataDir;
+    timer = null;
+    prevCpuTimes = null;
+    startTime = Date.now();
+    constructor(db, source, dataDir) {
+        this.db = db;
+        this.source = source;
+        this.dataDir = dataDir;
+    }
+    start() {
+        if (this.timer)
+            return;
+        this.collectAndStore().then(snap => {
+            this.backfillNulls(snap);
+        }).catch(() => { });
+        this.timer = setInterval(() => {
+            this.collectAndStore().catch(() => { });
+        }, SNAPSHOT_INTERVAL_MS);
+    }
+    backfillNulls(snap) {
+        try {
+            if (snap.total_triples != null) {
+                this.db.db.prepare('UPDATE metric_snapshots SET total_triples = ? WHERE total_triples IS NULL').run(snap.total_triples);
+            }
+        }
+        catch { /* best-effort */ }
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    async collectAndStore() {
+        const snap = await this.collect();
+        this.db.insertSnapshot(snap);
+        return snap;
+    }
+    async collect() {
+        const cpuPercent = this.measureCpu();
+        const mem = memoryUsage();
+        const heap = mem.heapUsed;
+        const memTotal = totalmem();
+        const memUsed = memTotal - freemem();
+        const uptime = Math.floor((Date.now() - this.startTime) / 1000);
+        let diskUsed = null;
+        let diskTotal = null;
+        if (this.dataDir) {
+            try {
+                const s = await statfsAsync(this.dataDir);
+                diskTotal = s.blocks * s.bsize;
+                diskUsed = diskTotal - s.bavail * s.bsize;
+            }
+            catch { /* ignore */ }
+        }
+        let storeBytes = null;
+        try {
+            storeBytes = await this.source.getStoreBytes();
+        }
+        catch { /* ignore */ }
+        let rpcLatency = null;
+        let rpcHealthy = null;
+        try {
+            rpcLatency = await this.source.getRpcLatencyMs();
+            rpcHealthy = (await this.source.isRpcHealthy()) ? 1 : 0;
+        }
+        catch { /* ignore */ }
+        let totalTriples = null;
+        let totalKCs = null;
+        let totalKAs = null;
+        let confirmedKCs = null;
+        let tentativeKCs = null;
+        let paranetCount = null;
+        try {
+            totalTriples = await this.source.getTotalTriples();
+        }
+        catch { /* ignore */ }
+        try {
+            totalKCs = await this.source.getTotalKCs();
+        }
+        catch { /* ignore */ }
+        try {
+            totalKAs = await this.source.getTotalKAs();
+        }
+        catch { /* ignore */ }
+        try {
+            confirmedKCs = await this.source.getConfirmedKCs();
+        }
+        catch { /* ignore */ }
+        try {
+            tentativeKCs = await this.source.getTentativeKCs();
+        }
+        catch { /* ignore */ }
+        try {
+            paranetCount = await this.source.getParanetCount();
+        }
+        catch { /* ignore */ }
+        return {
+            ts: Date.now(),
+            cpu_percent: cpuPercent,
+            mem_used_bytes: memUsed,
+            mem_total_bytes: memTotal,
+            disk_used_bytes: diskUsed,
+            disk_total_bytes: diskTotal,
+            heap_used_bytes: heap,
+            uptime_seconds: uptime,
+            peer_count: this.source.getPeerCount(),
+            direct_peers: this.source.getDirectPeerCount(),
+            relayed_peers: this.source.getRelayedPeerCount(),
+            mesh_peers: this.source.getMeshPeerCount(),
+            paranet_count: paranetCount,
+            total_triples: totalTriples,
+            total_kcs: totalKCs,
+            total_kas: totalKAs,
+            store_bytes: storeBytes,
+            confirmed_kcs: confirmedKCs,
+            tentative_kcs: tentativeKCs,
+            rpc_latency_ms: rpcLatency,
+            rpc_healthy: rpcHealthy,
+        };
+    }
+    measureCpu() {
+        const cores = cpus();
+        let idle = 0;
+        let total = 0;
+        for (const c of cores) {
+            idle += c.times.idle;
+            total += c.times.user + c.times.nice + c.times.sys + c.times.idle + c.times.irq;
+        }
+        if (!this.prevCpuTimes) {
+            this.prevCpuTimes = { idle, total };
+            return 0;
+        }
+        const dIdle = idle - this.prevCpuTimes.idle;
+        const dTotal = total - this.prevCpuTimes.total;
+        this.prevCpuTimes = { idle, total };
+        if (dTotal === 0)
+            return 0;
+        return Math.round((1 - dIdle / dTotal) * 10000) / 100;
+    }
+}
+//# sourceMappingURL=metrics-collector.js.map

package/dist/metrics-collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-collector.js","sourceRoot":"","sources":["../src/metrics-collector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;AAmBtC,MAAM,oBAAoB,GAAG,OAAO,CAAC,CAAC,YAAY;AAElD;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IAMR;IACA;IACA;IAPX,KAAK,GAA0C,IAAI,CAAC;IACpD,YAAY,GAA2C,IAAI,CAAC;IACnD,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAExC,YACmB,EAAe,EACf,MAAqB,EACrB,OAAgB;QAFhB,OAAE,GAAF,EAAE,CAAa;QACf,WAAM,GAAN,MAAM,CAAe;QACrB,YAAO,GAAP,OAAO,CAAS;IAChC,CAAC;IAEJ,KAAK;QACH,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO;QACvB,IAAI,CAAC,eAAe,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACjC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACnB,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC,eAAe,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACzC,CAAC,EAAE,oBAAoB,CAAC,CAAC;IAC3B,CAAC;IAEO,aAAa,CAAC,IAAuB;QAC3C,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,EAAE,CAAC;gBAC/B,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,CAChB,2EAA2E,CAC5E,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,eAAe;QACnB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QAClC,IAAI,CAAC,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,WAAW,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC;QAC1B,MAAM,QAAQ,GAAG,QAAQ,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,QAAQ,GAAG,OAAO,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;QAEhE,IAAI,QAAQ,GAAkB,IAAI,CAAC;QACnC,IAAI,SAAS,GAAkB,IAAI,CAAC;QACpC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC;gBACH,MAAM,CAAC,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC1C,SAAS,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC;gBAC/B,QAAQ,GAAG,SAAS,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC;YAC5C,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QAC1B,CAAC;QAED,IAAI,UAAU,GAAkB,IAAI,CAAC;QACrC,IAAI,CAAC;YAAC,UAAU,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QAE9E,IAAI,UAAU,GAAkB,IAAI,CAAC;QACrC,IAAI,UAAU,GAAkB,IAAI,CAAC;QACrC,IAAI,CAAC;YACH,UAAU,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;YACjD,UAAU,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1D,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QAExB,IAAI,YAAY,GAAkB,IAAI,CAAC;QACvC,IAAI,QAAQ,GAAkB,IAAI,CAAC;QACnC,IAAI,QAAQ,GAAkB,IAAI,CAAC;QACnC,IAAI,YAAY,GAAkB,IAAI,CAAC;QACvC,IAAI,YAAY,GAAkB,IAAI,CAAC;QACvC,IAAI,YAAY,GAAkB,IAAI,CAAC;QAEvC,IAAI,CAAC;YAAC,YAAY,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QAClF,IAAI,CAAC;YAAC,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QAC1E,IAAI,CAAC;YAAC,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QAC1E,IAAI,CAAC;YAAC,YAAY,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QAClF,IAAI,CAAC;YAAC,YAAY,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QAClF,IAAI,CAAC;YAAC,YAAY,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QAElF,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;YACd,WAAW,EAAE,UAAU;YACvB,cAAc,EAAE,OAAO;YACvB,eAAe,EAAE,QAAQ;YACzB,eAAe,EAAE,QAAQ;YACzB,gBAAgB,EAAE,SAAS;YAC3B,eAAe,EAAE,IAAI;YACrB,cAAc,EAAE,MAAM;YACtB,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE;YACtC,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE;YAC9C,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE;YAChD,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE;YAC1C,aAAa,EAAE,YAAY;YAC3B,aAAa,EAAE,YAAY;YAC3B,SAAS,EAAE,QAAQ;YACnB,SAAS,EAAE,QAAQ;YACnB,WAAW,EAAE,UAAU;YACvB,aAAa,EAAE,YAAY;YAC3B,aAAa,EAAE,YAAY;YAC3B,cAAc,EAAE,UAAU;YAC1B,WAAW,EAAE,UAAU;SACxB,CAAC;IACJ,CAAC;IAEO,UAAU;QAChB,MAAM,KAAK,GAAG,IAAI,EAAE,CAAC;QACrB,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;YACrB,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC;QAClF,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,IAAI,CAAC,YAAY,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;YACpC,OAAO,CAAC,CAAC;QACX,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;QAC5C,MAAM,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;QAC/C,IAAI,CAAC,YAAY,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QAEpC,IAAI,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;IACxD,CAAC;CACF"}

package/dist/operation-tracker.d.ts

@@ -0,0 +1,43 @@
+import type { OperationContext } from '@origintrail-official/dkg-core';
+import type { DashboardDB } from './db.js';
+/**
+ * Records the lifecycle of node operations (publish, query, sync, etc.)
+ * in the dashboard SQLite database. If no DB is configured (e.g. in tests),
+ * all methods are no-ops.
+ */
+export declare class OperationTracker {
+    private readonly db;
+    private readonly starts;
+    private readonly phaseStarts;
+    constructor(db: DashboardDB | null);
+    start(ctx: OperationContext, meta?: {
+        peerId?: string;
+        paranetId?: string;
+        details?: Record<string, unknown>;
+    }): void;
+    complete(ctx: OperationContext, meta?: {
+        tripleCount?: number;
+        details?: Record<string, unknown>;
+    }): void;
+    fail(ctx: OperationContext, err: unknown): void;
+    startPhase(ctx: OperationContext, phase: string): void;
+    completePhase(ctx: OperationContext, phase: string): void;
+    setCost(ctx: OperationContext, cost: {
+        gasUsed?: bigint;
+        gasPrice?: bigint;
+        gasCost?: bigint;
+        tracCost?: bigint;
+    }): void;
+    setTxHash(ctx: OperationContext, txHash?: string, chainId?: number): void;
+    /**
+     * Execute `fn` as a tracked phase — no timing gaps, no forgotten end calls.
+     * On success completes the phase; on error fails the phase and re-throws.
+     */
+    trackPhase<T>(ctx: OperationContext, phase: string, fn: () => Promise<T>): Promise<T>;
+    /**
+     * Create an onPhase callback wired to this tracker instance.
+     * Pass this to DKGAgent/Publisher methods that accept `onPhase`.
+     */
+    phaseCallback(ctx: OperationContext): (phase: string, status: 'start' | 'end') => void;
+}
+//# sourceMappingURL=operation-tracker.d.ts.map

package/dist/operation-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-tracker.d.ts","sourceRoot":"","sources":["../src/operation-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;GAIG;AACH,qBAAa,gBAAgB;IAIf,OAAO,CAAC,QAAQ,CAAC,EAAE;IAH/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;gBAE5B,EAAE,EAAE,WAAW,GAAG,IAAI;IAEnD,KAAK,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE;QAClC,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,GAAG,IAAI;IAkBR,QAAQ,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE;QACrC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,GAAG,IAAI;IAgBR,IAAI,CAAC,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI;IA8B/C,UAAU,CAAC,GAAG,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAgBtD,aAAa,CAAC,GAAG,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAgBzD,OAAO,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE;QACnC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,IAAI;IAwBR,SAAS,CAAC,GAAG,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAazE;;;OAGG;IACG,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAwB3F;;;OAGG;IACH,aAAa,CAAC,GAAG,EAAE,gBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,KAAK,KAAK,IAAI;CAMvF"}