@predicatelabs/sdk 0.99.9

package/dist/tracing/indexer.js

@@ -0,0 +1,347 @@
+"use strict";
+/**
+ * Trace indexing for fast timeline rendering and step drill-down.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTraceIndex = buildTraceIndex;
+exports.writeTraceIndex = writeTraceIndex;
+exports.readStepEvents = readStepEvents;
+const fs = __importStar(require("fs"));
+const crypto = __importStar(require("crypto"));
+const path = __importStar(require("path"));
+const canonicalization_1 = require("../canonicalization");
+const index_schema_1 = require("./index-schema");
+/**
+ * Compute stable digest of snapshot for diffing
+ */
+function computeSnapshotDigest(snapshotData) {
+    const url = snapshotData.url || '';
+    const viewport = snapshotData.viewport || {};
+    const elements = snapshotData.elements || [];
+    // Canonicalize elements using shared helper
+    const canonicalElements = elements.map((elem) => (0, canonicalization_1.canonicalizeElement)(elem));
+    // Sort by element id for determinism
+    canonicalElements.sort((a, b) => (a.id || 0) - (b.id || 0));
+    // Build canonical object
+    const canonical = {
+        url,
+        viewport: {
+            width: viewport.width || 0,
+            height: viewport.height || 0,
+        },
+        elements: canonicalElements,
+    };
+    // Hash
+    const canonicalJson = JSON.stringify(canonical);
+    const hash = crypto.createHash('sha256').update(canonicalJson, 'utf8').digest('hex');
+    return `sha256:${hash}`;
+}
+/**
+ * Compute digest of action args for privacy + determinism
+ */
+function computeActionDigest(actionData) {
+    const actionType = actionData.type || '';
+    const targetId = actionData.target_element_id;
+    const canonical = {
+        type: actionType,
+        target_element_id: targetId,
+    };
+    // Type-specific canonicalization
+    if (actionType === 'TYPE') {
+        const text = actionData.text || '';
+        canonical.text_len = text.length;
+        canonical.text_sha256 = crypto.createHash('sha256').update(text, 'utf8').digest('hex');
+    }
+    else if (actionType === 'PRESS') {
+        canonical.key = actionData.key || '';
+    }
+    // CLICK has no extra args
+    // Hash
+    const canonicalJson = JSON.stringify(canonical);
+    const hash = crypto.createHash('sha256').update(canonicalJson, 'utf8').digest('hex');
+    return `sha256:${hash}`;
+}
+/**
+ * Compute SHA256 hash of entire file
+ */
+function computeFileSha256(filePath) {
+    const hash = crypto.createHash('sha256');
+    const data = fs.readFileSync(filePath);
+    hash.update(data);
+    return hash.digest('hex');
+}
+/**
+ * Build trace index from JSONL file in single streaming pass
+ */
+function buildTraceIndex(tracePath) {
+    if (!fs.existsSync(tracePath)) {
+        throw new Error(`Trace file not found: ${tracePath}`);
+    }
+    // Extract run_id from filename
+    const runId = path.basename(tracePath, '.jsonl');
+    // Initialize summary
+    let firstTs = '';
+    let lastTs = '';
+    let eventCount = 0;
+    let errorCount = 0;
+    let finalUrl = null;
+    let runEndStatus = null; // Track status from run_end event
+    let agentName = null; // Extract from run_start event
+    let lineCount = 0; // Track total line count
+    const stepsById = new Map();
+    const stepOrder = [];
+    // Stream through file, tracking byte offsets and line numbers
+    const fileBuffer = fs.readFileSync(tracePath);
+    let byteOffset = 0;
+    const lines = fileBuffer.toString('utf-8').split('\n');
+    let lineNumber = 0; // Track line number for each event
+    for (const line of lines) {
+        lineNumber++;
+        lineCount++;
+        const lineBytes = Buffer.byteLength(line + '\n', 'utf-8');
+        if (!line.trim()) {
+            byteOffset += lineBytes;
+            continue;
+        }
+        let event;
+        try {
+            event = JSON.parse(line);
+        }
+        catch (e) {
+            // Skip malformed lines
+            byteOffset += lineBytes;
+            continue;
+        }
+        // Extract event metadata
+        const eventType = event.type || '';
+        const ts = event.ts || event.timestamp || '';
+        const stepId = event.step_id || 'step-0';
+        const data = event.data || {};
+        // Update summary
+        eventCount++;
+        if (!firstTs) {
+            firstTs = ts;
+        }
+        lastTs = ts;
+        if (eventType === 'error') {
+            errorCount++;
+        }
+        // Extract agent_name from run_start event
+        if (eventType === 'run_start') {
+            agentName = data.agent || null;
+        }
+        // Initialize step if first time seeing this step_id
+        if (!stepsById.has(stepId)) {
+            stepOrder.push(stepId);
+            stepsById.set(stepId, new index_schema_1.StepIndex(stepOrder.length, stepId, null, 'failure', // Default to failure (will be updated by step_end event)
+            ts, ts, byteOffset, byteOffset + lineBytes, lineNumber, // Track line number
+            null, null, new index_schema_1.SnapshotInfo(), new index_schema_1.SnapshotInfo(), new index_schema_1.ActionInfo(), new index_schema_1.StepCounters()));
+        }
+        const step = stepsById.get(stepId);
+        // Update step metadata
+        step.ts_end = ts;
+        step.offset_end = byteOffset + lineBytes;
+        step.line_number = lineNumber; // Update line number on each event
+        step.counters.events++;
+        // Handle specific event types
+        if (eventType === 'step_start') {
+            step.goal = data.goal;
+            step.url_before = data.pre_url;
+        }
+        else if (eventType === 'snapshot' || eventType === 'snapshot_taken') {
+            // Handle both "snapshot" (current) and "snapshot_taken" (schema) for backward compatibility
+            const snapshotId = data.snapshot_id;
+            const url = data.url;
+            const digest = computeSnapshotDigest(data);
+            // First snapshot = before, last snapshot = after
+            if (!step.snapshot_before.snapshot_id) {
+                step.snapshot_before = new index_schema_1.SnapshotInfo(snapshotId, digest, url);
+                step.url_before = step.url_before || url;
+            }
+            step.snapshot_after = new index_schema_1.SnapshotInfo(snapshotId, digest, url);
+            step.url_after = url;
+            step.counters.snapshots++;
+            finalUrl = url;
+        }
+        else if (eventType === 'action' || eventType === 'action_executed') {
+            // Handle both "action" (current) and "action_executed" (schema) for backward compatibility
+            step.action = new index_schema_1.ActionInfo(data.type, data.target_element_id, computeActionDigest(data), data.success !== false);
+            step.counters.actions++;
+        }
+        else if (eventType === 'llm_response' || eventType === 'llm_called') {
+            // Handle both "llm_response" (current) and "llm_called" (schema) for backward compatibility
+            step.counters.llm_calls++;
+        }
+        else if (eventType === 'error') {
+            step.status = 'failure';
+        }
+        else if (eventType === 'step_end') {
+            // Determine status from step_end event data
+            // Frontend expects: success, failure, or partial
+            // Logic: success = exec.success && verify.passed
+            //        partial = exec.success && !verify.passed
+            //        failure = !exec.success
+            const execData = data.exec || {};
+            const verifyData = data.verify || {};
+            const execSuccess = execData.success === true;
+            const verifyPassed = verifyData.passed === true;
+            if (execSuccess && verifyPassed) {
+                step.status = 'success';
+            }
+            else if (execSuccess && !verifyPassed) {
+                step.status = 'partial';
+            }
+            else if (!execSuccess) {
+                step.status = 'failure';
+            }
+            else {
+                // Fallback: if step_end exists but no exec/verify data, default to failure
+                step.status = 'failure';
+            }
+        }
+        else if (eventType === 'run_end') {
+            // Extract status from run_end event (will be used for summary)
+            runEndStatus = data.status;
+            // Validate status value
+            if (runEndStatus && !['success', 'failure', 'partial', 'unknown'].includes(runEndStatus)) {
+                runEndStatus = null;
+            }
+        }
+        byteOffset += lineBytes;
+    }
+    // Use run_end status if available, otherwise infer from step statuses
+    let summaryStatus = null;
+    if (runEndStatus) {
+        summaryStatus = runEndStatus;
+    }
+    else {
+        const stepStatuses = Array.from(stepsById.values()).map(s => s.status);
+        if (stepStatuses.length > 0) {
+            // Infer overall status from step statuses
+            if (stepStatuses.every(s => s === 'success')) {
+                summaryStatus = 'success';
+            }
+            else if (stepStatuses.some(s => s === 'failure')) {
+                // If any failure and no successes, it's failure; otherwise partial
+                if (stepStatuses.some(s => s === 'success')) {
+                    summaryStatus = 'partial';
+                }
+                else {
+                    summaryStatus = 'failure';
+                }
+            }
+            else if (stepStatuses.some(s => s === 'partial')) {
+                summaryStatus = 'partial';
+            }
+            else {
+                summaryStatus = 'failure'; // Default to failure instead of unknown
+            }
+        }
+        else {
+            summaryStatus = 'failure'; // Default to failure instead of unknown
+        }
+    }
+    // Calculate duration
+    let durationMs = null;
+    if (firstTs && lastTs) {
+        const start = new Date(firstTs);
+        const end = new Date(lastTs);
+        durationMs = end.getTime() - start.getTime();
+    }
+    // Aggregate counters
+    const snapshotCount = Array.from(stepsById.values()).reduce((sum, s) => sum + s.counters.snapshots, 0);
+    const actionCount = Array.from(stepsById.values()).reduce((sum, s) => sum + s.counters.actions, 0);
+    const counters = {
+        snapshot_count: snapshotCount,
+        action_count: actionCount,
+        error_count: errorCount,
+    };
+    // Build summary
+    const summary = new index_schema_1.TraceSummary(firstTs, lastTs, eventCount, stepsById.size, errorCount, finalUrl, summaryStatus, agentName, durationMs, counters);
+    // Build steps list in order
+    const stepsList = stepOrder.map(sid => stepsById.get(sid));
+    // Build trace file info
+    const traceFile = new index_schema_1.TraceFileInfo(tracePath, fs.statSync(tracePath).size, computeFileSha256(tracePath), lineCount);
+    // Build final index
+    const index = new index_schema_1.TraceIndex(1, runId, new Date().toISOString(), traceFile, summary, stepsList);
+    return index;
+}
+/**
+ * Build index and write to file
+ * @param tracePath - Path to trace JSONL file
+ * @param indexPath - Optional custom path for index file
+ * @param frontendFormat - If true, write in frontend-compatible format (default: false)
+ */
+function writeTraceIndex(tracePath, indexPath, frontendFormat = false) {
+    if (!indexPath) {
+        indexPath = tracePath.replace(/\.jsonl$/, '.index.json');
+    }
+    const index = buildTraceIndex(tracePath);
+    if (frontendFormat) {
+        fs.writeFileSync(indexPath, JSON.stringify(index.toSentienceStudioJSON(), null, 2));
+    }
+    else {
+        fs.writeFileSync(indexPath, JSON.stringify(index.toJSON(), null, 2));
+    }
+    return indexPath;
+}
+/**
+ * Read events for a specific step using byte offsets from index
+ */
+function readStepEvents(tracePath, offsetStart, offsetEnd) {
+    const events = [];
+    const fd = fs.openSync(tracePath, 'r');
+    const bytesToRead = offsetEnd - offsetStart;
+    const buffer = Buffer.alloc(bytesToRead);
+    fs.readSync(fd, buffer, 0, bytesToRead, offsetStart);
+    fs.closeSync(fd);
+    // Parse lines
+    const chunk = buffer.toString('utf-8');
+    const lines = chunk.split('\n');
+    for (const line of lines) {
+        if (!line.trim())
+            continue;
+        try {
+            const event = JSON.parse(line);
+            events.push(event);
+        }
+        catch (e) {
+            // Skip malformed lines
+        }
+    }
+    return events;
+}
+//# sourceMappingURL=indexer.js.map

package/dist/tracing/indexer.js.map

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

package/dist/tracing/jsonl-sink.d.ts

@@ -0,0 +1,51 @@
+/**
+ * JSONL Trace Sink
+ *
+ * Writes trace events to a local JSONL (JSON Lines) file
+ */
+import { TraceSink } from './sink';
+import { TraceEvent, TraceStats } from './types';
+/**
+ * JsonlTraceSink writes trace events to a JSONL file (one JSON object per line)
+ */
+export declare class JsonlTraceSink extends TraceSink {
+    private path;
+    private writeStream;
+    private closed;
+    /**
+     * Create a new JSONL trace sink
+     * @param filePath - Path to the JSONL file (will be created if doesn't exist)
+     */
+    constructor(filePath: string);
+    /**
+     * Emit a trace event (write as JSON line)
+     * @param event - Trace event to emit
+     */
+    emit(event: TraceEvent): void;
+    /**
+     * Close the sink and flush buffered data
+     */
+    close(): Promise<void>;
+    /**
+     * Generate trace index file (automatic on close)
+     */
+    private generateIndex;
+    /**
+     * Get sink type identifier
+     */
+    getSinkType(): string;
+    /**
+     * Get file path
+     */
+    getPath(): string;
+    /**
+     * Check if sink is closed
+     */
+    isClosed(): boolean;
+    /**
+     * Extract execution statistics from trace file (for local traces).
+     * @returns Trace statistics
+     */
+    getStats(): TraceStats;
+}
+//# sourceMappingURL=jsonl-sink.d.ts.map

package/dist/tracing/jsonl-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl-sink.d.ts","sourceRoot":"","sources":["../../src/tracing/jsonl-sink.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEjD;;GAEG;AACH,qBAAa,cAAe,SAAQ,SAAS;IAC3C,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,MAAM,CAAkB;IAEhC;;;OAGG;gBACS,QAAQ,EAAE,MAAM;IAiC5B;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAqC7B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA4D5B;;OAEG;IACH,OAAO,CAAC,aAAa;IAcrB;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,OAAO,IAAI,MAAM;IAIjB;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;;OAGG;IACH,QAAQ,IAAI,UAAU;CAwHvB"}