hzl-core 2.10.0 → 3.1.0

package/dist/services/gateway-client.js

@@ -0,0 +1,413 @@
+// packages/hzl-core/src/services/gateway-client.ts
+import { generateKeyPairSync, sign, createPrivateKey, createHash } from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+const RPC_TIMEOUT_MS = 30_000;
+const MAX_RECONNECT_DELAY_MS = 30_000;
+const INITIAL_RECONNECT_DELAY_MS = 1_000;
+const PAIRING_RETRY_DELAY_MS = 5_000;
+const DEVICE_IDENTITY_FILE = 'gateway-device.json';
+const PROTOCOL_VERSION = 3;
+const ED25519_SPKI_PREFIX_LEN = 12; // ASN.1 header length for Ed25519 SPKI DER
+function base64UrlEncode(buf) {
+    return buf.toString('base64').replaceAll('+', '-').replaceAll('/', '_').replace(/=+$/g, '');
+}
+export class GatewayClient {
+    url;
+    token;
+    configDir;
+    ws = null;
+    _status = 'disconnected';
+    deviceIdentity = null;
+    pendingCalls = new Map();
+    nextId = 1;
+    reconnectTimer;
+    reconnectDelay = INITIAL_RECONNECT_DELAY_MS;
+    connectPromise = null;
+    disposed = false;
+    pairingMessageShown = false;
+    constructor(options) {
+        this.url = options.url;
+        this.token = options.token;
+        this.configDir = options.configDir;
+        this.deviceIdentity = this.loadDeviceIdentity();
+    }
+    getStatus() {
+        return this._status;
+    }
+    /**
+     * Update gateway configuration. Disconnects and reconnects if URL or token changed.
+     */
+    configure(url, token) {
+        const changed = url !== this.url || token !== this.token;
+        this.url = url;
+        this.token = token;
+        if (changed && this._status === 'connected') {
+            this.disconnect();
+        }
+    }
+    /**
+     * Send an RPC call to the gateway. Lazily connects on first call.
+     */
+    async call(method, params) {
+        await this.ensureConnected();
+        return new Promise((resolve, reject) => {
+            const id = String(this.nextId++);
+            const timer = setTimeout(() => {
+                this.pendingCalls.delete(id);
+                reject(new Error(`Gateway RPC timeout: ${method}`));
+            }, RPC_TIMEOUT_MS);
+            this.pendingCalls.set(id, { resolve, reject, timer });
+            const frame = { type: 'req', id, method };
+            if (params !== undefined) {
+                frame.params = params;
+            }
+            this.ws.send(JSON.stringify(frame));
+        });
+    }
+    /**
+     * Disconnect from the gateway and clean up resources.
+     */
+    dispose() {
+        this.disposed = true;
+        this.disconnect();
+    }
+    disconnect() {
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = undefined;
+        }
+        if (this.ws) {
+            this.ws.onopen = null;
+            this.ws.onclose = null;
+            this.ws.onerror = null;
+            this.ws.onmessage = null;
+            if (this.ws.readyState === WebSocket.OPEN || this.ws.readyState === WebSocket.CONNECTING) {
+                this.ws.close();
+            }
+            this.ws = null;
+        }
+        // Reject all pending calls
+        for (const call of this.pendingCalls.values()) {
+            clearTimeout(call.timer);
+            call.reject(new Error('Gateway disconnected'));
+        }
+        this.pendingCalls.clear();
+        this._status = 'disconnected';
+        this.connectPromise = null;
+    }
+    async ensureConnected() {
+        if (this._status === 'connected' && this.ws?.readyState === WebSocket.OPEN) {
+            return;
+        }
+        if (this.connectPromise) {
+            return this.connectPromise;
+        }
+        this.connectPromise = this.connect();
+        try {
+            await this.connectPromise;
+        }
+        finally {
+            this.connectPromise = null;
+        }
+    }
+    connect() {
+        return new Promise((resolve, reject) => {
+            this._status = 'connecting';
+            const ws = new WebSocket(this.url);
+            this.ws = ws;
+            let handshakeComplete = false;
+            let challengeNonce = null;
+            ws.onopen = () => {
+                this.reconnectDelay = INITIAL_RECONNECT_DELAY_MS;
+            };
+            ws.onmessage = (event) => {
+                const raw = String(event.data);
+                let msg;
+                try {
+                    msg = JSON.parse(raw);
+                }
+                catch {
+                    return;
+                }
+                // Handshake phase
+                if (!handshakeComplete) {
+                    // Step 1: Receive connect.challenge
+                    // Gateway sends: { type: "event", event: "connect.challenge", payload: { nonce, ts } }
+                    const isChallenge = (msg.event === 'connect.challenge' && msg.payload) ||
+                        (msg.method === 'connect.challenge' && (msg.params ?? msg.payload));
+                    const challengeData = msg.payload ?? msg.params;
+                    if (isChallenge && challengeData) {
+                        challengeNonce = typeof challengeData.nonce === 'string' ? challengeData.nonce : '';
+                        this.sendConnectFrame(ws, challengeNonce);
+                        return;
+                    }
+                    // Step 2: Receive hello-ok response
+                    // Gateway sends: { type: "res", id: "…", ok: true, payload: { type: "hello-ok", ... } }
+                    const isHelloOk = (msg.type === 'res' && msg.ok === true && msg.payload) ||
+                        (msg.type === 'res' && !msg.error && challengeNonce);
+                    if (isHelloOk) {
+                        handshakeComplete = true;
+                        this._status = 'connected';
+                        if (this.pairingMessageShown) {
+                            console.log('  Device approved — gateway connected.');
+                            console.log('');
+                            this.pairingMessageShown = false;
+                        }
+                        else {
+                            console.log(`Gateway connected (${this.url})`);
+                        }
+                        // Persist device token if provided
+                        // Token is at payload.auth.deviceToken
+                        const payload = msg.payload;
+                        const auth = payload?.auth;
+                        const deviceToken = auth?.deviceToken;
+                        if (typeof deviceToken === 'string' && this.deviceIdentity) {
+                            this.deviceIdentity.deviceToken = deviceToken;
+                            this.saveDeviceIdentity(this.deviceIdentity);
+                        }
+                        resolve();
+                        return;
+                    }
+                    // Handshake error
+                    if (msg.type === 'res' && (msg.error || msg.ok === false)) {
+                        const errorMsg = msg.error?.message ?? 'unknown error';
+                        const details = msg.error?.details;
+                        const rawCode = details?.code ?? msg.error?.code;
+                        const code = typeof rawCode === 'string' ? rawCode : '';
+                        if (code === 'PAIRING_REQUIRED') {
+                            if (!this.pairingMessageShown) {
+                                const rawReqId = details?.requestId;
+                                const requestId = typeof rawReqId === 'string' ? rawReqId : '';
+                                console.log('');
+                                console.log('  Device pairing required');
+                                console.log('');
+                                console.log('  This device must be approved on your OpenClaw gateway.');
+                                console.log('  Run on your gateway host:');
+                                console.log('');
+                                console.log(`    openclaw devices approve ${requestId}`);
+                                console.log('');
+                                console.log('  Waiting for approval...');
+                                this.pairingMessageShown = true;
+                            }
+                            // Retry every 5s — user may approve at any time
+                            this._status = 'disconnected';
+                            this.reconnectDelay = PAIRING_RETRY_DELAY_MS;
+                            reject(new Error(`Gateway handshake failed: ${errorMsg}`));
+                            if (!this.disposed) {
+                                this.scheduleReconnect();
+                            }
+                            return;
+                        }
+                        const err = new Error(`Gateway handshake failed: ${errorMsg}`);
+                        this._status = 'disconnected';
+                        reject(err);
+                        return;
+                    }
+                    return;
+                }
+                // Normal RPC response
+                if (msg.type === 'res' && msg.id) {
+                    const call = this.pendingCalls.get(msg.id);
+                    if (call) {
+                        this.pendingCalls.delete(msg.id);
+                        clearTimeout(call.timer);
+                        if (msg.error) {
+                            call.reject(new Error(msg.error.message));
+                        }
+                        else {
+                            // Result may be in msg.result or msg.payload
+                            call.resolve(msg.result ?? msg.payload);
+                        }
+                    }
+                }
+            };
+            ws.onclose = () => {
+                const wasConnected = handshakeComplete;
+                this._status = 'disconnected';
+                if (!handshakeComplete) {
+                    reject(new Error('Gateway connection closed during handshake'));
+                }
+                // Reject pending calls
+                for (const call of this.pendingCalls.values()) {
+                    clearTimeout(call.timer);
+                    call.reject(new Error('Gateway connection closed'));
+                }
+                this.pendingCalls.clear();
+                // Auto-reconnect if we were connected and not disposed
+                if (wasConnected && !this.disposed) {
+                    this.scheduleReconnect();
+                }
+            };
+            ws.onerror = () => {
+                if (!handshakeComplete) {
+                    this._status = 'disconnected';
+                    reject(new Error(`Gateway connection failed: ${this.url}`));
+                }
+            };
+        });
+    }
+    sendConnectFrame(ws, nonce) {
+        const identity = this.getOrCreateDeviceIdentity();
+        const connectId = String(this.nextId++);
+        const signedAt = Date.now();
+        const clientId = 'gateway-client';
+        const clientMode = 'backend';
+        const role = 'operator';
+        const scopes = ['operator.read', 'operator.write', 'operator.admin'];
+        const token = identity.deviceToken ?? this.token ?? '';
+        const platform = process.platform;
+        // Build v3 auth payload: v3|deviceId|clientId|clientMode|role|scopes|signedAtMs|token|nonce|platform|deviceFamily
+        const authPayload = [
+            'v3',
+            identity.id,
+            clientId,
+            clientMode,
+            role,
+            scopes.join(','),
+            String(signedAt),
+            token,
+            nonce,
+            platform.toLowerCase(),
+            '', // deviceFamily (empty for server)
+        ].join('|');
+        const signature = this.signPayload(authPayload, identity.privateKeyPkcs8);
+        const frame = {
+            type: 'req',
+            id: connectId,
+            method: 'connect',
+            params: {
+                minProtocol: PROTOCOL_VERSION,
+                maxProtocol: PROTOCOL_VERSION,
+                client: {
+                    id: clientId,
+                    version: '1.0.0',
+                    platform,
+                    mode: clientMode,
+                },
+                role,
+                scopes,
+                caps: [],
+                commands: [],
+                permissions: {},
+                auth: { token: identity.deviceToken ?? this.token },
+                locale: 'en-US',
+                userAgent: 'hzl-dashboard/1.0.0',
+                device: {
+                    id: identity.id,
+                    publicKey: identity.publicKey,
+                    signature,
+                    signedAt,
+                    nonce,
+                },
+            },
+        };
+        ws.send(JSON.stringify(frame));
+    }
+    signPayload(payload, privateKeyPkcs8Base64) {
+        const privateKeyDer = Buffer.from(privateKeyPkcs8Base64, 'base64');
+        const key = createPrivateKey({
+            key: privateKeyDer,
+            format: 'der',
+            type: 'pkcs8',
+        });
+        const sig = sign(null, Buffer.from(payload, 'utf8'), key);
+        return base64UrlEncode(sig);
+    }
+    /**
+     * Derive device ID as SHA256 hex of the raw 32-byte Ed25519 public key.
+     * publicKeyBase64Url is the raw 32-byte key in base64url encoding.
+     */
+    deriveDeviceId(publicKeyBase64Url) {
+        // Decode base64url → raw 32 bytes → SHA256 hex
+        const normalized = publicKeyBase64Url.replaceAll('-', '+').replaceAll('_', '/');
+        const padded = normalized + '='.repeat((4 - (normalized.length % 4)) % 4);
+        const raw = Buffer.from(padded, 'base64');
+        return createHash('sha256').update(raw).digest('hex');
+    }
+    getOrCreateDeviceIdentity() {
+        if (this.deviceIdentity) {
+            let changed = false;
+            // Migrate old SPKI base64 public keys to raw base64url
+            // SPKI Ed25519 keys start with 'MCowBQ' (the ASN.1 header)
+            if (this.deviceIdentity.publicKey.startsWith('MCowBQ')) {
+                const spkiDer = Buffer.from(this.deviceIdentity.publicKey, 'base64');
+                const rawKey = spkiDer.subarray(ED25519_SPKI_PREFIX_LEN);
+                this.deviceIdentity.publicKey = base64UrlEncode(rawKey);
+                changed = true;
+            }
+            // Validate stored ID matches derived fingerprint
+            const expectedId = this.deriveDeviceId(this.deviceIdentity.publicKey);
+            if (this.deviceIdentity.id !== expectedId) {
+                this.deviceIdentity.id = expectedId;
+                changed = true;
+            }
+            if (changed) {
+                this.saveDeviceIdentity(this.deviceIdentity);
+            }
+            return this.deviceIdentity;
+        }
+        const { publicKey, privateKey } = generateKeyPairSync('ed25519');
+        // Extract raw 32-byte public key from SPKI DER (strip 12-byte ASN.1 header)
+        const spkiDer = publicKey.export({ type: 'spki', format: 'der' });
+        const rawPub = spkiDer.subarray(ED25519_SPKI_PREFIX_LEN);
+        const pubBase64Url = base64UrlEncode(rawPub);
+        const identity = {
+            id: this.deriveDeviceId(pubBase64Url),
+            publicKey: pubBase64Url,
+            privateKeyPkcs8: privateKey.export({ type: 'pkcs8', format: 'der' }).toString('base64'),
+        };
+        this.deviceIdentity = identity;
+        this.saveDeviceIdentity(identity);
+        return identity;
+    }
+    loadDeviceIdentity() {
+        const filePath = path.join(this.configDir, DEVICE_IDENTITY_FILE);
+        try {
+            if (!fs.existsSync(filePath))
+                return null;
+            const data = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+            const id = data.id;
+            const publicKey = data.publicKey;
+            // Support both old ('privateKey') and new ('privateKeyPkcs8') field names
+            const privateKeyPkcs8 = (data.privateKeyPkcs8 ?? data.privateKey);
+            if (id && publicKey && privateKeyPkcs8) {
+                return { id, publicKey, privateKeyPkcs8, deviceToken: data.deviceToken };
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    saveDeviceIdentity(identity) {
+        try {
+            if (!fs.existsSync(this.configDir)) {
+                fs.mkdirSync(this.configDir, { recursive: true });
+            }
+            const filePath = path.join(this.configDir, DEVICE_IDENTITY_FILE);
+            const tempPath = `${filePath}.tmp.${process.pid}`;
+            fs.writeFileSync(tempPath, JSON.stringify(identity, null, 2) + '\n');
+            fs.renameSync(tempPath, filePath);
+        }
+        catch {
+            // Non-fatal: device identity will be regenerated next time
+        }
+    }
+    scheduleReconnect() {
+        if (this.disposed || this.reconnectTimer)
+            return;
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = undefined;
+            if (!this.disposed) {
+                this.ensureConnected().catch(() => {
+                    // Reconnect failed, schedule another attempt
+                    this.reconnectDelay = Math.min(this.reconnectDelay * 2, MAX_RECONNECT_DELAY_MS);
+                    this.scheduleReconnect();
+                });
+            }
+        }, this.reconnectDelay);
+        this.reconnectDelay = Math.min(this.reconnectDelay * 2, MAX_RECONNECT_DELAY_MS);
+    }
+}
+//# sourceMappingURL=gateway-client.js.map

package/dist/services/gateway-client.js.map

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

package/dist/services/stats-service.d.ts

@@ -0,0 +1,51 @@
+import type Database from 'libsql';
+import type { TaskService } from './task-service.js';
+export interface StatsQueryOptions {
+    project?: string;
+    windowMinutes?: number;
+    windowLabel?: string;
+    asOf?: string;
+}
+export interface QueueStats {
+    backlog: number;
+    ready: number;
+    in_progress: number;
+    blocked: number;
+    done: number;
+    archived: number;
+    available: number;
+    stale: number;
+    expired_leases: number;
+}
+export interface CompletionStats {
+    total: number;
+    by_agent: Record<string, number>;
+}
+export interface ExecutionTimeStats {
+    count: number;
+    mean: number | null;
+    min: number | null;
+    max: number | null;
+    excluded_without_start: number;
+}
+export interface StatsSnapshot {
+    window: string;
+    generated_at: string;
+    projects: string[];
+    queue: QueueStats;
+    completions: CompletionStats;
+    execution_time_ms: ExecutionTimeStats;
+}
+export declare class StatsService {
+    private cacheDb;
+    private eventsDb;
+    private taskService;
+    constructor(cacheDb: Database.Database, eventsDb: Database.Database, taskService: Pick<TaskService, 'getAvailableTasks' | 'getStaleTasks'>);
+    getStats(options?: StatsQueryOptions): StatsSnapshot;
+    private getProjects;
+    private getTrackedTasks;
+    private getQueueStats;
+    private getExpiredLeaseCount;
+    private getHistoricalStats;
+}
+//# sourceMappingURL=stats-service.d.ts.map

package/dist/services/stats-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats-service.d.ts","sourceRoot":"","sources":["../../src/services/stats-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,QAAQ,CAAC;AACnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAuBrD,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,eAAe,CAAC;IAC7B,iBAAiB,EAAE,kBAAkB,CAAC;CACvC;AAED,qBAAa,YAAY;IAErB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,WAAW;gBAFX,OAAO,EAAE,QAAQ,CAAC,QAAQ,EAC1B,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAC3B,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,mBAAmB,GAAG,eAAe,CAAC;IAG/E,QAAQ,CAAC,OAAO,GAAE,iBAAsB,GAAG,aAAa;IAyBxD,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,aAAa;IAoCrB,OAAO,CAAC,oBAAoB;IAoB5B,OAAO,CAAC,kBAAkB;CAuG3B"}

package/dist/services/stats-service.js

@@ -0,0 +1,183 @@
+const DEFAULT_STALE_THRESHOLD_MINUTES = 10;
+const DEFAULT_WINDOW_MINUTES = 24 * 60;
+const TASK_CHUNK_SIZE = 500;
+export class StatsService {
+    cacheDb;
+    eventsDb;
+    taskService;
+    constructor(cacheDb, eventsDb, taskService) {
+        this.cacheDb = cacheDb;
+        this.eventsDb = eventsDb;
+        this.taskService = taskService;
+    }
+    getStats(options = {}) {
+        const generatedAt = options.asOf ?? new Date().toISOString();
+        const windowMinutes = options.windowMinutes ?? DEFAULT_WINDOW_MINUTES;
+        const windowLabel = options.windowLabel ?? (windowMinutes === 24 * 60 ? '24h' : `${windowMinutes}m`);
+        const windowStart = new Date(new Date(generatedAt).getTime() - windowMinutes * 60_000).toISOString();
+        const trackedTasks = this.getTrackedTasks(options.project);
+        const historical = this.getHistoricalStats({
+            trackedTasks,
+            windowStart,
+            windowEnd: generatedAt,
+        });
+        return {
+            window: windowLabel,
+            generated_at: generatedAt,
+            projects: this.getProjects(),
+            queue: this.getQueueStats({ project: options.project, asOf: generatedAt }),
+            completions: historical.completions,
+            execution_time_ms: historical.execution_time_ms,
+        };
+    }
+    getProjects() {
+        const rows = this.cacheDb
+            .prepare('SELECT name FROM projects ORDER BY name')
+            .all();
+        return rows.map((row) => row.name);
+    }
+    getTrackedTasks(project) {
+        const rows = (project
+            ? this.cacheDb
+                .prepare('SELECT task_id, project, agent FROM tasks_current WHERE project = ?')
+                .all(project)
+            : this.cacheDb.prepare('SELECT task_id, project, agent FROM tasks_current').all());
+        return new Map(rows.map((row) => [row.task_id, row]));
+    }
+    getQueueStats(options) {
+        const params = [];
+        const projectWhere = options.project ? 'WHERE project = ?' : '';
+        if (options.project) {
+            params.push(options.project);
+        }
+        const rows = this.cacheDb.prepare(`
+      SELECT status, COUNT(*) as count
+      FROM tasks_current
+      ${projectWhere}
+      GROUP BY status
+    `).all(...params);
+        const queue = {
+            backlog: 0,
+            ready: 0,
+            in_progress: 0,
+            blocked: 0,
+            done: 0,
+            archived: 0,
+            available: this.taskService.getAvailableTasks({ project: options.project }).length,
+            stale: this.taskService.getStaleTasks({
+                project: options.project,
+                thresholdMinutes: DEFAULT_STALE_THRESHOLD_MINUTES,
+            }).size,
+            expired_leases: this.getExpiredLeaseCount(options),
+        };
+        for (const row of rows) {
+            queue[row.status] = row.count;
+        }
+        return queue;
+    }
+    getExpiredLeaseCount(options) {
+        const params = [options.asOf];
+        let projectClause = '';
+        if (options.project) {
+            projectClause = 'AND project = ?';
+            params.push(options.project);
+        }
+        const row = this.cacheDb.prepare(`
+      SELECT COUNT(*) as count
+      FROM tasks_current
+      WHERE status = 'in_progress'
+        AND lease_until IS NOT NULL
+        AND lease_until < ?
+        ${projectClause}
+    `).get(...params);
+        return row.count;
+    }
+    getHistoricalStats(options) {
+        const completions = {
+            total: 0,
+            by_agent: {},
+        };
+        const durations = [];
+        let excludedWithoutStart = 0;
+        if (options.trackedTasks.size === 0) {
+            return {
+                completions,
+                execution_time_ms: {
+                    count: 0,
+                    mean: null,
+                    min: null,
+                    max: null,
+                    excluded_without_start: 0,
+                },
+            };
+        }
+        const taskIds = [...options.trackedTasks.keys()];
+        for (let index = 0; index < taskIds.length; index += TASK_CHUNK_SIZE) {
+            const chunk = taskIds.slice(index, index + TASK_CHUNK_SIZE);
+            const placeholders = chunk.map(() => '?').join(', ');
+            const rows = this.eventsDb.prepare(`
+        SELECT
+          e.task_id,
+          e.timestamp AS done_at,
+          (
+            SELECT start.timestamp
+            FROM events start
+            WHERE start.task_id = e.task_id
+              AND start.type = 'status_changed'
+              AND json_extract(start.data, '$.to') = 'in_progress'
+              AND start.id < e.id
+            ORDER BY start.id DESC
+            LIMIT 1
+          ) AS started_at
+        FROM events e
+        WHERE e.type = 'status_changed'
+          AND json_extract(e.data, '$.to') = 'done'
+          AND e.timestamp >= ?
+          AND e.timestamp <= ?
+          AND e.task_id IN (${placeholders})
+        ORDER BY e.id ASC
+      `).all(options.windowStart, options.windowEnd, ...chunk);
+            for (const row of rows) {
+                const task = options.trackedTasks.get(row.task_id);
+                if (!task) {
+                    continue;
+                }
+                completions.total += 1;
+                if (task.agent) {
+                    completions.by_agent[task.agent] = (completions.by_agent[task.agent] ?? 0) + 1;
+                }
+                if (!row.started_at) {
+                    excludedWithoutStart += 1;
+                    continue;
+                }
+                const duration = new Date(row.done_at).getTime() - new Date(row.started_at).getTime();
+                if (Number.isFinite(duration) && duration >= 0) {
+                    durations.push(duration);
+                }
+                else {
+                    excludedWithoutStart += 1;
+                }
+            }
+        }
+        const executionTimeMs = durations.length === 0
+            ? {
+                count: 0,
+                mean: null,
+                min: null,
+                max: null,
+                excluded_without_start: excludedWithoutStart,
+            }
+            : {
+                count: durations.length,
+                mean: durations.reduce((sum, duration) => sum + duration, 0) / durations.length,
+                min: durations.reduce((m, d) => (d < m ? d : m), Infinity),
+                max: durations.reduce((m, d) => (d > m ? d : m), -Infinity),
+                excluded_without_start: excludedWithoutStart,
+            };
+        return {
+            completions,
+            execution_time_ms: executionTimeMs,
+        };
+    }
+}
+//# sourceMappingURL=stats-service.js.map