@snoglobe/helios 0.1.0

package/dist/memory/experiment-tracker.d.ts

@@ -0,0 +1,21 @@
+import type { MemoryStore } from "./memory-store.js";
+import type { AgentEvent } from "../providers/types.js";
+/**
+ * Auto-populates /experiments/ in memory when remote_exec_background is called.
+ * Listens to tool_call and tool_result events from the orchestrator.
+ */
+export declare class ExperimentTracker {
+    private memory;
+    private experimentCount;
+    private pendingCalls;
+    private experiments;
+    constructor(memory: MemoryStore);
+    private getNextCount;
+    /** Call this for every AgentEvent from the orchestrator. */
+    onEvent(event: AgentEvent): void;
+    /** Update an experiment with final results (call when a task completes). */
+    updateExperiment(machineId: string, pid: number, exitCode: number, metrics?: Record<string, number>): void;
+    /** Get all pending experiment keys. */
+    getPendingKeys(): string[];
+}
+//# sourceMappingURL=experiment-tracker.d.ts.map

package/dist/memory/experiment-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"experiment-tracker.d.ts","sourceRoot":"","sources":["../../src/memory/experiment-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAaxD;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,WAAW,CAAwC;gBAE/C,MAAM,EAAE,WAAW;IAI/B,OAAO,CAAC,YAAY;IAUpB,4DAA4D;IAC5D,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAmDhC,4EAA4E;IAC5E,gBAAgB,CACd,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,IAAI;IAqCP,uCAAuC;IACvC,cAAc,IAAI,MAAM,EAAE;CAG3B"}

package/dist/memory/experiment-tracker.js

@@ -0,0 +1,117 @@
+import { truncate } from "../ui/format.js";
+/**
+ * Auto-populates /experiments/ in memory when remote_exec_background is called.
+ * Listens to tool_call and tool_result events from the orchestrator.
+ */
+export class ExperimentTracker {
+    memory;
+    experimentCount = null; // null = not yet initialized
+    pendingCalls = new Map();
+    experiments = new Map(); // "machine:pid" → experiment
+    constructor(memory) {
+        this.memory = memory;
+    }
+    getNextCount() {
+        if (this.experimentCount === null) {
+            // Lazy init — session ID should be set by now
+            const existing = this.memory.ls("/experiments/");
+            this.experimentCount = existing.length;
+        }
+        this.experimentCount++;
+        return this.experimentCount;
+    }
+    /** Call this for every AgentEvent from the orchestrator. */
+    onEvent(event) {
+        if (event.type === "tool_call" && event.name === "remote_exec_background") {
+            this.pendingCalls.set(event.id, event.args);
+        }
+        if (event.type === "tool_result" && this.pendingCalls.has(event.callId)) {
+            const args = this.pendingCalls.get(event.callId);
+            this.pendingCalls.delete(event.callId);
+            if (event.isError)
+                return;
+            try {
+                const result = JSON.parse(event.result);
+                if (!result.pid)
+                    return;
+                const num = String(this.getNextCount()).padStart(2, "0");
+                const name = slugify(args.command);
+                const path = `/experiments/${num}-${name}`;
+                const key = `${result.machine_id ?? args.machine_id}:${result.pid}`;
+                const experiment = {
+                    name: `${num}-${name}`,
+                    machineId: (result.machine_id ?? args.machine_id),
+                    pid: result.pid,
+                    command: args.command,
+                    metricNames: args.metric_names,
+                    metricPatterns: args.metric_patterns,
+                    startedAt: Date.now(),
+                };
+                this.experiments.set(key, experiment);
+                const gist = `${experiment.machineId}:${experiment.pid} — ${truncate(experiment.command, 50)}`;
+                const content = [
+                    `command: ${experiment.command}`,
+                    `machine: ${experiment.machineId}`,
+                    `pid: ${experiment.pid}`,
+                    experiment.metricNames ? `metrics: ${experiment.metricNames.join(", ")}` : null,
+                    `status: running`,
+                    `started: ${new Date(experiment.startedAt).toISOString()}`,
+                ]
+                    .filter(Boolean)
+                    .join("\n");
+                this.memory.write(path, gist, content);
+            }
+            catch {
+                // Parse failure — skip
+            }
+        }
+    }
+    /** Update an experiment with final results (call when a task completes). */
+    updateExperiment(machineId, pid, exitCode, metrics) {
+        const key = `${machineId}:${pid}`;
+        const experiment = this.experiments.get(key);
+        if (!experiment)
+            return;
+        // Find the existing path
+        const nodes = this.memory.ls("/experiments/");
+        const node = nodes.find((n) => n.gist.startsWith(key));
+        if (!node)
+            return;
+        const metricStr = metrics
+            ? Object.entries(metrics)
+                .map(([k, v]) => `${k}=${v}`)
+                .join(", ")
+            : "none";
+        const status = exitCode === 0 ? "completed" : `failed (exit ${exitCode})`;
+        const gist = `${key} — ${truncate(experiment.command, 50)} → ${metricStr} (${status})`;
+        const content = [
+            `command: ${experiment.command}`,
+            `machine: ${experiment.machineId}`,
+            `pid: ${experiment.pid}`,
+            experiment.metricNames ? `metrics_config: ${experiment.metricNames.join(", ")}` : null,
+            `status: ${status}`,
+            `started: ${new Date(experiment.startedAt).toISOString()}`,
+            `finished: ${new Date().toISOString()}`,
+            `exit_code: ${exitCode}`,
+            metrics ? `final_metrics: ${JSON.stringify(metrics)}` : null,
+        ]
+            .filter(Boolean)
+            .join("\n");
+        this.memory.write(node.path, gist, content);
+        this.experiments.delete(key);
+    }
+    /** Get all pending experiment keys. */
+    getPendingKeys() {
+        return [...this.experiments.keys()];
+    }
+}
+function slugify(cmd) {
+    // Take the first meaningful word from the command
+    const words = cmd
+        .replace(/[^a-zA-Z0-9\s_-]/g, "")
+        .split(/\s+/)
+        .filter(Boolean)
+        .slice(0, 3);
+    return words.join("-").toLowerCase().slice(0, 30) || "run";
+}
+//# sourceMappingURL=experiment-tracker.js.map

package/dist/memory/experiment-tracker.js.map

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

package/dist/memory/memory-store.d.ts

@@ -0,0 +1,37 @@
+export interface MemoryNode {
+    path: string;
+    gist: string;
+    content: string | null;
+    isDir: boolean;
+    createdAt: number;
+    updatedAt: number;
+}
+export declare class MemoryStore {
+    private sessionId;
+    constructor(sessionId: string);
+    setSession(sessionId: string): void;
+    /** List children of a directory path. */
+    ls(dirPath?: string): MemoryNode[];
+    /** Recursively list all nodes under a path, returning paths + gists only. */
+    tree(dirPath?: string): Array<{
+        path: string;
+        gist: string;
+        isDir: boolean;
+    }>;
+    /** Read a node's full content. */
+    read(path: string): MemoryNode | null;
+    /** Write or update a node. Auto-creates parent directories. */
+    write(path: string, gist: string, content?: string | null): void;
+    /** Remove a node and all children (if directory). */
+    rm(path: string): number;
+    /** Check if a path exists. */
+    exists(path: string): boolean;
+    /** Count all nodes for this session. */
+    count(): number;
+    /** Build a formatted tree string (paths + gists) for checkpoint briefings. */
+    formatTree(dirPath?: string): string;
+    /** Clear all memory for this session. */
+    clear(): void;
+    private ensureParents;
+}
+//# sourceMappingURL=memory-store.d.ts.map

package/dist/memory/memory-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../src/memory/memory-store.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,SAAS,CAAS;gBAEd,SAAS,EAAE,MAAM;IAI7B,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAInC,yCAAyC;IACzC,EAAE,CAAC,OAAO,SAAM,GAAG,UAAU,EAAE;IA0B/B,6EAA6E;IAC7E,IAAI,CAAC,OAAO,SAAM,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;IAoB1E,kCAAkC;IAClC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAarC,+DAA+D;IAC/D,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAmBhE,qDAAqD;IACrD,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAcxB,8BAA8B;IAC9B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQ7B,wCAAwC;IACxC,KAAK,IAAI,MAAM;IAQf,8EAA8E;IAC9E,UAAU,CAAC,OAAO,SAAM,GAAG,MAAM;IAiBjC,yCAAyC;IACzC,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,aAAa;CAetB"}

package/dist/memory/memory-store.js

@@ -0,0 +1,150 @@
+import { getDb } from "../store/database.js";
+export class MemoryStore {
+    sessionId;
+    constructor(sessionId) {
+        this.sessionId = sessionId;
+    }
+    setSession(sessionId) {
+        this.sessionId = sessionId;
+    }
+    /** List children of a directory path. */
+    ls(dirPath = "/") {
+        const normalized = normalizeDirPath(dirPath);
+        const db = getDb();
+        // Find direct children: paths that start with dirPath and have no further slashes
+        // For "/", children are like "/goal", "/experiments/"
+        // For "/experiments/", children are like "/experiments/01-baseline"
+        const rows = db
+            .prepare(`SELECT path, gist, content, is_dir, created_at, updated_at
+         FROM memory_nodes
+         WHERE session_id = ? AND path LIKE ? AND path != ?`)
+            .all(this.sessionId, normalized + "%", normalized);
+        // Filter to direct children only
+        return rows
+            .filter((row) => {
+            const relPath = row.path.slice(normalized.length);
+            // Direct child: no slashes, or exactly one trailing slash (directory)
+            const slashCount = (relPath.match(/\//g) || []).length;
+            return slashCount === 0 || (slashCount === 1 && relPath.endsWith("/"));
+        })
+            .map(rowToNode);
+    }
+    /** Recursively list all nodes under a path, returning paths + gists only. */
+    tree(dirPath = "/") {
+        const normalized = normalizeDirPath(dirPath);
+        const db = getDb();
+        const rows = db
+            .prepare(`SELECT path, gist, is_dir
+         FROM memory_nodes
+         WHERE session_id = ? AND path LIKE ? AND path != ?
+         ORDER BY path`)
+            .all(this.sessionId, normalized + "%", normalized);
+        return rows.map((row) => ({
+            path: row.path,
+            gist: row.gist,
+            isDir: row.is_dir === 1,
+        }));
+    }
+    /** Read a node's full content. */
+    read(path) {
+        const db = getDb();
+        const row = db
+            .prepare(`SELECT path, gist, content, is_dir, created_at, updated_at
+         FROM memory_nodes
+         WHERE session_id = ? AND path = ?`)
+            .get(this.sessionId, path);
+        return row ? rowToNode(row) : null;
+    }
+    /** Write or update a node. Auto-creates parent directories. */
+    write(path, gist, content) {
+        const db = getDb();
+        const now = Date.now();
+        const isDir = content === undefined || content === null;
+        // Auto-create parent directories
+        this.ensureParents(path);
+        db.prepare(`INSERT INTO memory_nodes (session_id, path, gist, content, is_dir, created_at, updated_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?)
+       ON CONFLICT(session_id, path) DO UPDATE SET
+         gist = excluded.gist,
+         content = excluded.content,
+         is_dir = excluded.is_dir,
+         updated_at = excluded.updated_at`).run(this.sessionId, path, gist, isDir ? null : content, isDir ? 1 : 0, now, now);
+    }
+    /** Remove a node and all children (if directory). */
+    rm(path) {
+        const db = getDb();
+        // Delete exact match + any children
+        const result = db
+            .prepare(`DELETE FROM memory_nodes
+         WHERE session_id = ? AND (path = ? OR path LIKE ?)`)
+            .run(this.sessionId, path, path.endsWith("/") ? path + "%" : path + "/%");
+        return result.changes;
+    }
+    /** Check if a path exists. */
+    exists(path) {
+        const db = getDb();
+        const row = db
+            .prepare("SELECT 1 FROM memory_nodes WHERE session_id = ? AND path = ?")
+            .get(this.sessionId, path);
+        return !!row;
+    }
+    /** Count all nodes for this session. */
+    count() {
+        const db = getDb();
+        const row = db
+            .prepare("SELECT COUNT(*) as c FROM memory_nodes WHERE session_id = ?")
+            .get(this.sessionId);
+        return row.c;
+    }
+    /** Build a formatted tree string (paths + gists) for checkpoint briefings. */
+    formatTree(dirPath = "/") {
+        const nodes = this.tree(dirPath);
+        if (nodes.length === 0)
+            return "(empty)";
+        const lines = [];
+        for (const node of nodes) {
+            // Indent based on depth
+            const depth = node.path.split("/").filter(Boolean).length - 1;
+            const indent = "  ".repeat(depth);
+            const name = node.isDir
+                ? node.path.split("/").filter(Boolean).pop() + "/"
+                : node.path.split("/").filter(Boolean).pop();
+            lines.push(`${indent}${name}: ${node.gist}`);
+        }
+        return lines.join("\n");
+    }
+    /** Clear all memory for this session. */
+    clear() {
+        const db = getDb();
+        db.prepare("DELETE FROM memory_nodes WHERE session_id = ?").run(this.sessionId);
+    }
+    ensureParents(path) {
+        const parts = path.split("/").filter(Boolean);
+        // For "/a/b/c", ensure "/a/" and "/a/b/" exist
+        for (let i = 1; i < parts.length; i++) {
+            const parentPath = "/" + parts.slice(0, i).join("/") + "/";
+            if (!this.exists(parentPath)) {
+                const db = getDb();
+                const now = Date.now();
+                db.prepare(`INSERT OR IGNORE INTO memory_nodes (session_id, path, gist, content, is_dir, created_at, updated_at)
+           VALUES (?, ?, ?, NULL, 1, ?, ?)`).run(this.sessionId, parentPath, parts[i - 1], now, now);
+            }
+        }
+    }
+}
+function normalizeDirPath(path) {
+    if (path === "/")
+        return "/";
+    return path.endsWith("/") ? path : path + "/";
+}
+function rowToNode(row) {
+    return {
+        path: row.path,
+        gist: row.gist,
+        content: row.content,
+        isDir: row.is_dir === 1,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    };
+}
+//# sourceMappingURL=memory-store.js.map

package/dist/memory/memory-store.js.map

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

package/dist/memory/token-estimator.d.ts

@@ -0,0 +1,7 @@
+/** Rough token estimation: ~4 chars per token (standard heuristic). */
+export declare function estimateTokens(text: string): number;
+/** Get context budget (80% of model limit) in tokens. */
+export declare function getContextBudget(model: string): number;
+/** Checkpoint threshold — 85% of budget. */
+export declare function getCheckpointThreshold(model: string): number;
+//# sourceMappingURL=token-estimator.d.ts.map

package/dist/memory/token-estimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimator.d.ts","sourceRoot":"","sources":["../../src/memory/token-estimator.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAoBD,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED,4CAA4C;AAC5C,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/dist/memory/token-estimator.js

@@ -0,0 +1,30 @@
+/** Rough token estimation: ~4 chars per token (standard heuristic). */
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+/** Per-model context window sizes. */
+const MODEL_LIMITS = {
+    // Claude (200k)
+    "claude-opus-4-6": 200_000,
+    "claude-sonnet-4-6": 200_000,
+    // OpenAI (~400k)
+    "gpt-5.4": 400_000,
+    "gpt-5.3-codex": 400_000,
+    "gpt-5.3-codex-spark": 400_000,
+    "gpt-5.2-codex": 400_000,
+    "gpt-5.2": 400_000,
+    "gpt-5.1-codex-max": 400_000,
+    "gpt-5.1-codex": 400_000,
+    "gpt-5.1": 400_000,
+};
+const DEFAULT_LIMIT = 200_000;
+/** Get context budget (80% of model limit) in tokens. */
+export function getContextBudget(model) {
+    const limit = MODEL_LIMITS[model] ?? DEFAULT_LIMIT;
+    return Math.floor(limit * 0.8);
+}
+/** Checkpoint threshold — 85% of budget. */
+export function getCheckpointThreshold(model) {
+    return Math.floor(getContextBudget(model) * 0.85);
+}
+//# sourceMappingURL=token-estimator.js.map

package/dist/memory/token-estimator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimator.js","sourceRoot":"","sources":["../../src/memory/token-estimator.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,sCAAsC;AACtC,MAAM,YAAY,GAA2B;IAC3C,gBAAgB;IAChB,iBAAiB,EAAE,OAAO;IAC1B,mBAAmB,EAAE,OAAO;IAC5B,iBAAiB;IACjB,SAAS,EAAE,OAAO;IAClB,eAAe,EAAE,OAAO;IACxB,qBAAqB,EAAE,OAAO;IAC9B,eAAe,EAAE,OAAO;IACxB,SAAS,EAAE,OAAO;IAClB,mBAAmB,EAAE,OAAO;IAC5B,eAAe,EAAE,OAAO;IACxB,SAAS,EAAE,OAAO;CACnB,CAAC;AAEF,MAAM,aAAa,GAAG,OAAO,CAAC;AAE9B,yDAAyD;AACzD,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,aAAa,CAAC;IACnD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;AACjC,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,OAAO,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;AACpD,CAAC"}

package/dist/metrics/analyzer.d.ts

@@ -0,0 +1,15 @@
+import type { MetricPoint } from "./store.js";
+export interface AnalysisResult {
+    trend: "decreasing" | "plateau" | "increasing" | "unstable" | "insufficient_data";
+    slope: number;
+    currentValue: number;
+    meanValue: number;
+    stdDev: number;
+    hasNaN: boolean;
+    hasInf: boolean;
+}
+/**
+ * Analyze a metric time series for trends.
+ */
+export declare function analyzeMetric(points: MetricPoint[], windowSize?: number): AnalysisResult;
+//# sourceMappingURL=analyzer.d.ts.map

package/dist/metrics/analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../../src/metrics/analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,YAAY,GAAG,UAAU,GAAG,mBAAmB,CAAC;IAClF,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,WAAW,EAAE,EACrB,UAAU,SAAK,GACd,cAAc,CAmDhB"}

package/dist/metrics/analyzer.js

@@ -0,0 +1,67 @@
+/**
+ * Analyze a metric time series for trends.
+ */
+export function analyzeMetric(points, windowSize = 20) {
+    if (points.length < 3) {
+        return {
+            trend: "insufficient_data",
+            slope: 0,
+            currentValue: points.length > 0 ? points[points.length - 1].value : 0,
+            meanValue: 0,
+            stdDev: 0,
+            hasNaN: false,
+            hasInf: false,
+        };
+    }
+    const values = points.slice(-windowSize).map((p) => p.value);
+    const hasNaN = values.some(isNaN);
+    const hasInf = values.some((v) => !isFinite(v));
+    const validValues = values.filter((v) => isFinite(v) && !isNaN(v));
+    if (validValues.length < 3) {
+        return {
+            trend: "unstable",
+            slope: 0,
+            currentValue: values[values.length - 1],
+            meanValue: 0,
+            stdDev: 0,
+            hasNaN,
+            hasInf,
+        };
+    }
+    const mean = validValues.reduce((a, b) => a + b, 0) / validValues.length;
+    const variance = validValues.reduce((sum, v) => sum + (v - mean) ** 2, 0) /
+        validValues.length;
+    const stdDev = Math.sqrt(variance);
+    const slope = linearRegressionSlope(validValues);
+    const currentValue = validValues[validValues.length - 1];
+    // Determine trend
+    const slopeThreshold = stdDev * 0.1 || 1e-6;
+    let trend;
+    if (Math.abs(slope) < slopeThreshold) {
+        trend = "plateau";
+    }
+    else if (slope < 0) {
+        trend = "decreasing";
+    }
+    else {
+        trend = "increasing";
+    }
+    return { trend, slope, currentValue, meanValue: mean, stdDev, hasNaN, hasInf };
+}
+/**
+ * Simple linear regression slope.
+ * x = [0, 1, 2, ...], y = values
+ */
+function linearRegressionSlope(values) {
+    const n = values.length;
+    const xMean = (n - 1) / 2;
+    const yMean = values.reduce((a, b) => a + b, 0) / n;
+    let numerator = 0;
+    let denominator = 0;
+    for (let i = 0; i < n; i++) {
+        numerator += (i - xMean) * (values[i] - yMean);
+        denominator += (i - xMean) ** 2;
+    }
+    return denominator === 0 ? 0 : numerator / denominator;
+}
+//# sourceMappingURL=analyzer.js.map

package/dist/metrics/analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.js","sourceRoot":"","sources":["../../src/metrics/analyzer.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAqB,EACrB,UAAU,GAAG,EAAE;IAEf,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO;YACL,KAAK,EAAE,mBAAmB;YAC1B,KAAK,EAAE,CAAC;YACR,YAAY,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACrE,SAAS,EAAE,CAAC;YACZ,MAAM,EAAE,CAAC;YACT,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,KAAK;SACd,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAEhD,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO;YACL,KAAK,EAAE,UAAU;YACjB,KAAK,EAAE,CAAC;YACR,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;YACvC,SAAS,EAAE,CAAC;YACZ,MAAM,EAAE,CAAC;YACT,MAAM;YACN,MAAM;SACP,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC;IACzE,MAAM,QAAQ,GACZ,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxD,WAAW,CAAC,MAAM,CAAC;IACrB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,qBAAqB,CAAC,WAAW,CAAC,CAAC;IACjD,MAAM,YAAY,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAEzD,kBAAkB;IAClB,MAAM,cAAc,GAAG,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC;IAC5C,IAAI,KAA8B,CAAC;IAEnC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,cAAc,EAAE,CAAC;QACrC,KAAK,GAAG,SAAS,CAAC;IACpB,CAAC;SAAM,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACrB,KAAK,GAAG,YAAY,CAAC;IACvB,CAAC;SAAM,CAAC;QACN,KAAK,GAAG,YAAY,CAAC;IACvB,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AACjF,CAAC;AAED;;;GAGG;AACH,SAAS,qBAAqB,CAAC,MAAgB;IAC7C,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IACxB,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;IAEpD,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,SAAS,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;QAC/C,WAAW,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,WAAW,CAAC;AACzD,CAAC"}

package/dist/metrics/collector.d.ts

@@ -0,0 +1,23 @@
+import type { ConnectionPool } from "../remote/connection-pool.js";
+import { MetricStore, type MetricPoint } from "./store.js";
+import { type MetricPatterns } from "./parser.js";
+export interface CollectorSource {
+    taskId: string;
+    machineId: string;
+    logPath: string;
+    patterns: MetricPatterns;
+}
+export declare class MetricCollector {
+    private pool;
+    private store;
+    private sources;
+    private lastLineCount;
+    constructor(pool: ConnectionPool, store: MetricStore);
+    addSource(source: CollectorSource): void;
+    removeSource(taskId: string): void;
+    /** Reset all sources and line tracking (e.g. on metrics clear) */
+    reset(): void;
+    collectAll(): Promise<MetricPoint[]>;
+    private collect;
+}
+//# sourceMappingURL=collector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../src/metrics/collector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,KAAK,cAAc,EAAqB,MAAM,aAAa,CAAC;AAErE,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED,qBAAa,eAAe;IAKxB,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,KAAK;IALf,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,aAAa,CAA6B;gBAGxC,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,WAAW;IAG5B,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAOxC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IASlC,kEAAkE;IAClE,KAAK,IAAI,IAAI;IAKP,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YAkB5B,OAAO;CAuBtB"}

package/dist/metrics/collector.js

@@ -0,0 +1,60 @@
+import { parseWithPatterns } from "./parser.js";
+export class MetricCollector {
+    pool;
+    store;
+    sources = [];
+    lastLineCount = new Map();
+    constructor(pool, store) {
+        this.pool = pool;
+        this.store = store;
+    }
+    addSource(source) {
+        const exists = this.sources.some((s) => s.taskId === source.taskId);
+        if (!exists) {
+            this.sources.push(source);
+        }
+    }
+    removeSource(taskId) {
+        this.sources = this.sources.filter((s) => s.taskId !== taskId);
+        for (const key of this.lastLineCount.keys()) {
+            if (key.startsWith(taskId + ":")) {
+                this.lastLineCount.delete(key);
+            }
+        }
+    }
+    /** Reset all sources and line tracking (e.g. on metrics clear) */
+    reset() {
+        this.sources = [];
+        this.lastLineCount.clear();
+    }
+    async collectAll() {
+        const allPoints = [];
+        for (const source of this.sources) {
+            try {
+                const points = await this.collect(source);
+                if (points.length > 0) {
+                    this.store.insertBatch(source.taskId, source.machineId, points);
+                    allPoints.push(...points);
+                }
+            }
+            catch {
+                // Silently skip failed collections
+            }
+        }
+        return allPoints;
+    }
+    async collect(source) {
+        const key = `${source.taskId}:${source.logPath}`;
+        const lastCount = this.lastLineCount.get(key) ?? 0;
+        const wcResult = await this.pool.exec(source.machineId, `wc -l < '${source.logPath.replace(/'/g, "'\\''")}'`);
+        const totalLines = parseInt(wcResult.stdout.trim(), 10);
+        if (isNaN(totalLines) || totalLines <= lastCount) {
+            return [];
+        }
+        const newLineCount = totalLines - lastCount;
+        const output = await this.pool.tailFile(source.machineId, source.logPath, newLineCount);
+        this.lastLineCount.set(key, totalLines);
+        return parseWithPatterns(output, source.patterns);
+    }
+}
+//# sourceMappingURL=collector.js.map

package/dist/metrics/collector.js.map

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

package/dist/metrics/parser.d.ts

@@ -0,0 +1,21 @@
+import type { MetricPoint } from "./store.js";
+/**
+ * Parse metrics from log output using caller-supplied patterns.
+ *
+ * Two modes:
+ * - metric_names: ["loss", "lr"] → auto-generates key=value regexes
+ * - metric_patterns: { "loss": "Loss:\\s*([\\d.e+-]+)" } → custom regexes
+ *
+ * Each pattern must have exactly one capture group for the numeric value.
+ */
+export interface MetricPatterns {
+    /** Map of metric name → regex string with one capture group for the value */
+    patterns: Record<string, RegExp>;
+}
+/** Build MetricPatterns from a list of names (assumes key=value format) */
+export declare function patternsFromNames(names: string[]): MetricPatterns;
+/** Build MetricPatterns from a map of name → regex string */
+export declare function patternsFromRegexes(regexMap: Record<string, string>): MetricPatterns;
+/** Parse log output using the given patterns */
+export declare function parseWithPatterns(output: string, mp: MetricPatterns): MetricPoint[];
+//# sourceMappingURL=parser.d.ts.map

package/dist/metrics/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/metrics/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;;;GAQG;AAEH,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,cAAc,CAUjE;AAED,6DAA6D;AAC7D,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,cAAc,CAMhB;AAED,gDAAgD;AAChD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,cAAc,GACjB,WAAW,EAAE,CAsBf"}