@snoglobe/helios 0.1.0

package/dist/tools/remote-exec.js

@@ -0,0 +1,98 @@
+import { patternsFromNames, patternsFromRegexes } from "../metrics/parser.js";
+export function createRemoteExecTool(executor) {
+    return {
+        name: "remote_exec",
+        description: "Execute a short shell command. Returns stdout, stderr, and exit code. ONLY for quick one-shot commands (ls, cat, pip install, git clone, etc). NEVER use this for training, evaluation, or anything that runs longer than a few seconds — use remote_exec_background instead.",
+        parameters: {
+            type: "object",
+            properties: {
+                machine_id: {
+                    type: "string",
+                    description: "ID of the remote machine to run the command on",
+                },
+                command: {
+                    type: "string",
+                    description: "Shell command to execute",
+                },
+                timeout_seconds: {
+                    type: "number",
+                    description: "Optional timeout in seconds",
+                },
+            },
+            required: ["machine_id", "command"],
+        },
+        execute: async (args) => {
+            const result = await executor.exec(args.machine_id, args.command, args.timeout_seconds
+                ? args.timeout_seconds * 1000
+                : undefined);
+            return JSON.stringify({
+                stdout: result.stdout,
+                stderr: result.stderr,
+                exit_code: result.exitCode,
+            });
+        },
+    };
+}
+export function createRemoteExecBackgroundTool(executor, metricCollector) {
+    return {
+        name: "remote_exec_background",
+        description: "Launch a long-running process in the background. Returns PID and log path. Stdout is captured automatically — DO NOT redirect stdout yourself. To track metrics in the dashboard, provide metric_names (for key=value format) or metric_patterns (custom regexes).",
+        parameters: {
+            type: "object",
+            properties: {
+                machine_id: {
+                    type: "string",
+                    description: "ID of the machine (use \"local\" for this machine)",
+                },
+                command: {
+                    type: "string",
+                    description: "Command to run in the background",
+                },
+                log_path: {
+                    type: "string",
+                    description: "Optional path for stdout/stderr log file",
+                },
+                metric_names: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Metric names to parse from stdout in key=value or key: value format. Example: [\"loss\", \"acc\", \"lr\"]",
+                },
+                metric_patterns: {
+                    type: "object",
+                    additionalProperties: { type: "string" },
+                    description: "Map of metric name → regex string with one capture group for the numeric value. Example: {\"loss\": \"Loss:\\\\s*([\\\\d.e+-]+)\"}",
+                },
+            },
+            required: ["machine_id", "command"],
+        },
+        execute: async (args) => {
+            const metricNames = args.metric_names;
+            const metricPatterns = args.metric_patterns;
+            const proc = await executor.execBackground(args.machine_id, args.command, args.log_path, { metricNames, metricPatterns });
+            // Register collector source immediately so metrics are tracked from the start
+            if (metricCollector && proc.logPath) {
+                let patterns;
+                if (metricPatterns) {
+                    patterns = patternsFromRegexes(metricPatterns);
+                }
+                else if (metricNames && metricNames.length > 0) {
+                    patterns = patternsFromNames(metricNames);
+                }
+                if (patterns) {
+                    metricCollector.addSource({
+                        taskId: `${proc.machineId}:${proc.pid}`,
+                        machineId: proc.machineId,
+                        logPath: proc.logPath,
+                        patterns,
+                    });
+                }
+            }
+            return JSON.stringify({
+                pid: proc.pid,
+                log_path: proc.logPath,
+                machine_id: proc.machineId,
+            });
+        },
+    };
+}
+//# sourceMappingURL=remote-exec.js.map

package/dist/tools/remote-exec.js.map

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

package/dist/tools/remote-sync.d.ts

@@ -0,0 +1,5 @@
+import type { ToolDefinition } from "../providers/types.js";
+import type { FileSync } from "../remote/file-sync.js";
+export declare function createUploadTool(fileSync: FileSync): ToolDefinition;
+export declare function createDownloadTool(fileSync: FileSync): ToolDefinition;
+//# sourceMappingURL=remote-sync.d.ts.map

package/dist/tools/remote-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-sync.d.ts","sourceRoot":"","sources":["../../src/tools/remote-sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,CA+BnE;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,QAAQ,GACjB,cAAc,CAgChB"}

package/dist/tools/remote-sync.js

@@ -0,0 +1,57 @@
+export function createUploadTool(fileSync) {
+    return {
+        name: "remote_upload",
+        description: "Upload files from local machine to a remote machine via rsync.",
+        parameters: {
+            type: "object",
+            properties: {
+                machine_id: {
+                    type: "string",
+                    description: "ID of the remote machine",
+                },
+                local_path: {
+                    type: "string",
+                    description: "Local file or directory path",
+                },
+                remote_path: {
+                    type: "string",
+                    description: "Remote destination path",
+                },
+            },
+            required: ["machine_id", "local_path", "remote_path"],
+        },
+        execute: async (args) => {
+            await fileSync.upload(args.machine_id, args.local_path, args.remote_path);
+            return `Uploaded ${args.local_path} to ${args.machine_id}:${args.remote_path}`;
+        },
+    };
+}
+export function createDownloadTool(fileSync) {
+    return {
+        name: "remote_download",
+        description: "Download files from a remote machine to local machine via rsync.",
+        parameters: {
+            type: "object",
+            properties: {
+                machine_id: {
+                    type: "string",
+                    description: "ID of the remote machine",
+                },
+                remote_path: {
+                    type: "string",
+                    description: "Remote file or directory path",
+                },
+                local_path: {
+                    type: "string",
+                    description: "Local destination path",
+                },
+            },
+            required: ["machine_id", "remote_path", "local_path"],
+        },
+        execute: async (args) => {
+            await fileSync.download(args.machine_id, args.remote_path, args.local_path);
+            return `Downloaded ${args.machine_id}:${args.remote_path} to ${args.local_path}`;
+        },
+    };
+}
+//# sourceMappingURL=remote-sync.js.map

package/dist/tools/remote-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-sync.js","sourceRoot":"","sources":["../../src/tools/remote-sync.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,gBAAgB,CAAC,QAAkB;IACjD,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,gEAAgE;QAC7E,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0BAA0B;iBACxC;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8BAA8B;iBAC5C;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yBAAyB;iBACvC;aACF;YACD,QAAQ,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,aAAa,CAAC;SACtD;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,QAAQ,CAAC,MAAM,CACnB,IAAI,CAAC,UAAoB,EACzB,IAAI,CAAC,UAAoB,EACzB,IAAI,CAAC,WAAqB,CAC3B,CAAC;YACF,OAAO,YAAY,IAAI,CAAC,UAAU,OAAO,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACjF,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,QAAkB;IAElB,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,kEAAkE;QACpE,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0BAA0B;iBACxC;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+BAA+B;iBAC7C;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,wBAAwB;iBACtC;aACF;YACD,QAAQ,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,YAAY,CAAC;SACtD;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,QAAQ,CAAC,QAAQ,CACrB,IAAI,CAAC,UAAoB,EACzB,IAAI,CAAC,WAAqB,EAC1B,IAAI,CAAC,UAAoB,CAC1B,CAAC;YACF,OAAO,cAAc,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,WAAW,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;QACnF,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/show-metrics.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from "../providers/types.js";
+import type { MetricStore } from "../metrics/store.js";
+export declare function createShowMetricsTool(store: MetricStore): ToolDefinition;
+//# sourceMappingURL=show-metrics.d.ts.map

package/dist/tools/show-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show-metrics.d.ts","sourceRoot":"","sources":["../../src/tools/show-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,WAAW,GACjB,cAAc,CAqFhB"}

package/dist/tools/show-metrics.js

@@ -0,0 +1,69 @@
+import { analyzeMetric } from "../metrics/analyzer.js";
+export function createShowMetricsTool(store) {
+    return {
+        name: "show_metrics",
+        description: "Query and display metrics. Shows sparkline charts, current values, and trend analysis. Use this to check on training progress, report results to the user, or compare values. Omit metric_names to list all available metrics.",
+        parameters: {
+            type: "object",
+            properties: {
+                metric_names: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Metric names to display. Omit to list all available metrics.",
+                },
+                task_id: {
+                    type: "string",
+                    description: "Optional: scope to a specific task (e.g. \"local:1234\"). Omit to query across all tasks.",
+                },
+                lines: {
+                    type: "number",
+                    description: "Number of data points to include (default: 50)",
+                },
+            },
+        },
+        execute: async (args) => {
+            const metricNames = args.metric_names;
+            const taskId = args.task_id;
+            const limit = args.lines ?? 50;
+            // No names specified — list what's available
+            if (!metricNames || metricNames.length === 0) {
+                const names = taskId
+                    ? store.getMetricNames(taskId)
+                    : store.getAllMetricNames();
+                return JSON.stringify({ available_metrics: names });
+            }
+            const metrics = [];
+            for (const name of metricNames) {
+                const series = taskId
+                    ? store.getSeries(taskId, name, limit)
+                    : store.getSeriesAcrossTasks(name, limit);
+                if (series.length === 0) {
+                    metrics.push({
+                        name,
+                        values: [],
+                        latest: null,
+                        min: null,
+                        max: null,
+                        trend: "no_data",
+                    });
+                    continue;
+                }
+                const values = series.map((p) => p.value);
+                const latest = values[values.length - 1];
+                const min = Math.min(...values);
+                const max = Math.max(...values);
+                const analysis = analyzeMetric(series);
+                metrics.push({
+                    name,
+                    values,
+                    latest,
+                    min,
+                    max,
+                    trend: analysis.trend,
+                });
+            }
+            return JSON.stringify({ metrics });
+        },
+    };
+}
+//# sourceMappingURL=show-metrics.js.map

package/dist/tools/show-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"show-metrics.js","sourceRoot":"","sources":["../../src/tools/show-metrics.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,MAAM,UAAU,qBAAqB,CACnC,KAAkB;IAElB,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,gOAAgO;QAClO,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,YAAY,EAAE;oBACZ,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EACT,8DAA8D;iBACjE;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,2FAA2F;iBAC9F;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,gDAAgD;iBACnD;aACF;SACF;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,WAAW,GAAG,IAAI,CAAC,YAAoC,CAAC;YAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,OAA6B,CAAC;YAClD,MAAM,KAAK,GAAI,IAAI,CAAC,KAAgB,IAAI,EAAE,CAAC;YAE3C,6CAA6C;YAC7C,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC7C,MAAM,KAAK,GAAG,MAAM;oBAClB,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC;oBAC9B,CAAC,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC;gBAC9B,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC,CAAC;YACtD,CAAC;YAED,MAAM,OAAO,GAOR,EAAE,CAAC;YAER,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;gBAC/B,MAAM,MAAM,GAAG,MAAM;oBACnB,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC;oBACtC,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBAE5C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACxB,OAAO,CAAC,IAAI,CAAC;wBACX,IAAI;wBACJ,MAAM,EAAE,EAAE;wBACV,MAAM,EAAE,IAAI;wBACZ,GAAG,EAAE,IAAI;wBACT,GAAG,EAAE,IAAI;wBACT,KAAK,EAAE,SAAS;qBACjB,CAAC,CAAC;oBACH,SAAS;gBACX,CAAC;gBAED,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;gBAC1C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBACzC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;gBAChC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;gBAEhC,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;gBAEvC,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI;oBACJ,MAAM;oBACN,MAAM;oBACN,GAAG;oBACH,GAAG;oBACH,KAAK,EAAE,QAAQ,CAAC,KAAK;iBACtB,CAAC,CAAC;YACL,CAAC;YAED,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QACrC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/sleep.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from "../providers/types.js";
+import type { SleepManager } from "../scheduler/sleep-manager.js";
+export declare function createSleepTool(sleepManager: SleepManager): ToolDefinition;
+//# sourceMappingURL=sleep.d.ts.map

package/dist/tools/sleep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../src/tools/sleep.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAGlE,wBAAgB,eAAe,CAC7B,YAAY,EAAE,YAAY,GACzB,cAAc,CA0EhB"}

package/dist/tools/sleep.js

@@ -0,0 +1,116 @@
+export function createSleepTool(sleepManager) {
+    return {
+        name: "sleep",
+        description: `Put yourself to sleep and STOP your current turn. When you call this tool, you MUST immediately end your response — do not output any more text or tool calls after sleep returns. You will be automatically woken when triggers fire and resumed with a wake message containing elapsed time, which triggers fired, and your original goal.
+
+IMPORTANT: Calling sleep means "I am done for now, wake me when conditions are met." After calling sleep, STOP. Do not call any more tools. Do not write any more text. Your turn is over.
+
+Trigger types:
+- timer: Wake after a duration. Provide wake_after_seconds.
+- process_exit: Wake when a remote process exits. Provide machine_id and pid or process_pattern.
+- metric: Wake when a metric meets a condition. Provide machine_id, source, field, comparator, threshold.
+- file: Wake when a file appears/changes. Provide machine_id, path, mode (exists|modified|size_stable).
+- resource: Wake when GPU/CPU crosses a threshold. Provide machine_id, resource, comparator, threshold.
+
+Use logic "any" to wake on the first condition met, "all" to require all conditions.`,
+        parameters: {
+            type: "object",
+            properties: {
+                reason: {
+                    type: "string",
+                    description: "Why you are sleeping (shown to user)",
+                },
+                wake_conditions: {
+                    type: "array",
+                    description: "Conditions that will wake you up",
+                    items: { type: "object" },
+                },
+                logic: {
+                    type: "string",
+                    enum: ["any", "all"],
+                    description: "Wake on ANY condition (OR) or ALL conditions (AND)",
+                },
+                deadline_minutes: {
+                    type: "number",
+                    description: "Maximum sleep duration in minutes. Wake regardless after this.",
+                },
+            },
+            required: ["reason", "wake_conditions"],
+        },
+        execute: async (args) => {
+            const reason = args.reason;
+            // Models sometimes use variant key names
+            const conditions = (args.wake_conditions ?? args.conditions ?? args.triggers);
+            if (!conditions || !Array.isArray(conditions) || conditions.length === 0) {
+                return JSON.stringify({ error: "No wake_conditions provided. Provide an array of trigger conditions." });
+            }
+            const logic = args.logic ?? "any";
+            const deadlineMin = args.deadline_minutes;
+            const triggerConditions = conditions.map(parseTriggerCondition);
+            const expression = triggerConditions.length === 1
+                ? triggerConditions[0]
+                : { op: logic === "all" ? "and" : "or", children: triggerConditions };
+            const session = await sleepManager.sleep({
+                reason,
+                expression,
+                deadlineMs: deadlineMin ? deadlineMin * 60 * 1000 : undefined,
+            });
+            return JSON.stringify({
+                status: "sleeping",
+                session_id: session.id,
+                trigger_id: session.trigger.id,
+                reason,
+                deadline: session.trigger.deadline
+                    ? new Date(session.trigger.deadline).toISOString()
+                    : null,
+                instruction: "You are now sleeping. STOP your response immediately. Do not output any more text or tool calls. You will be woken automatically.",
+            });
+        },
+    };
+}
+function parseTriggerCondition(raw) {
+    const type = raw.type;
+    switch (type) {
+        case "timer":
+            return {
+                kind: "timer",
+                wakeAt: Date.now() + (raw.wake_after_seconds ?? 3600) * 1000,
+            };
+        case "process_exit":
+            return {
+                kind: "process_exit",
+                machineId: raw.machine_id,
+                pid: raw.pid,
+                processPattern: raw.process_pattern,
+            };
+        case "metric":
+            return {
+                kind: "metric",
+                machineId: raw.machine_id,
+                source: raw.source,
+                field: raw.field,
+                comparator: raw.comparator,
+                threshold: raw.threshold,
+                sustainedChecks: raw.sustained_checks,
+            };
+        case "file":
+            return {
+                kind: "file",
+                machineId: raw.machine_id,
+                path: raw.path,
+                mode: raw.mode ?? "exists",
+            };
+        case "resource":
+            return {
+                kind: "resource",
+                machineId: raw.machine_id,
+                resource: raw.resource,
+                comparator: raw.comparator ?? "<",
+                threshold: raw.threshold,
+                gpuIndex: raw.gpu_index,
+            };
+        default:
+            throw new Error(`Unknown trigger type: ${type}`);
+    }
+}
+//# sourceMappingURL=sleep.js.map

package/dist/tools/sleep.js.map

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

package/dist/tools/task-output.d.ts

@@ -0,0 +1,5 @@
+import type { ToolDefinition } from "../providers/types.js";
+import type { RemoteExecutor } from "../remote/executor.js";
+import type { ConnectionPool } from "../remote/connection-pool.js";
+export declare function createTaskOutputTool(executor: RemoteExecutor, pool: ConnectionPool): ToolDefinition;
+//# sourceMappingURL=task-output.d.ts.map

package/dist/tools/task-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-output.d.ts","sourceRoot":"","sources":["../../src/tools/task-output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,cAAc,GACnB,cAAc,CAsDhB"}

package/dist/tools/task-output.js

@@ -0,0 +1,51 @@
+export function createTaskOutputTool(executor, pool) {
+    return {
+        name: "task_output",
+        description: "View the recent stdout/stderr output of a running or finished background task. " +
+            "Use this instead of running 'tail' or 'cat' manually — it knows the log path automatically.",
+        parameters: {
+            type: "object",
+            properties: {
+                machine_id: {
+                    type: "string",
+                    description: "Machine the task is running on",
+                },
+                pid: {
+                    type: "number",
+                    description: "PID of the background process",
+                },
+                lines: {
+                    type: "number",
+                    description: "Number of recent lines to show (default: 50)",
+                },
+            },
+            required: ["machine_id", "pid"],
+        },
+        execute: async (args) => {
+            const machineId = args.machine_id;
+            const pid = args.pid;
+            const lines = args.lines ?? 50;
+            const proc = executor.getBackgroundProcess(machineId, pid);
+            if (!proc) {
+                return JSON.stringify({
+                    error: `No tracked background process with pid ${pid} on ${machineId}`,
+                });
+            }
+            if (!proc.logPath) {
+                return JSON.stringify({
+                    error: "No log path recorded for this process",
+                });
+            }
+            const output = await pool.tailFile(machineId, proc.logPath, lines);
+            const running = await executor.isRunning(machineId, pid);
+            return JSON.stringify({
+                pid,
+                machine_id: machineId,
+                log_path: proc.logPath,
+                running,
+                output,
+            });
+        },
+    };
+}
+//# sourceMappingURL=task-output.js.map

package/dist/tools/task-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-output.js","sourceRoot":"","sources":["../../src/tools/task-output.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,oBAAoB,CAClC,QAAwB,EACxB,IAAoB;IAEpB,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,iFAAiF;YACjF,6FAA6F;QAC/F,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,gCAAgC;iBAC9C;gBACD,GAAG,EAAE;oBACH,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+BAA+B;iBAC7C;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8CAA8C;iBAC5D;aACF;YACD,QAAQ,EAAE,CAAC,YAAY,EAAE,KAAK,CAAC;SAChC;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,SAAS,GAAG,IAAI,CAAC,UAAoB,CAAC;YAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAa,CAAC;YAC/B,MAAM,KAAK,GAAI,IAAI,CAAC,KAAgB,IAAI,EAAE,CAAC;YAE3C,MAAM,IAAI,GAAG,QAAQ,CAAC,oBAAoB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YAC3D,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,IAAI,CAAC,SAAS,CAAC;oBACpB,KAAK,EAAE,0CAA0C,GAAG,OAAO,SAAS,EAAE;iBACvE,CAAC,CAAC;YACL,CAAC;YAED,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBAClB,OAAO,IAAI,CAAC,SAAS,CAAC;oBACpB,KAAK,EAAE,uCAAuC;iBAC/C,CAAC,CAAC;YACL,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YACnE,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YAEzD,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,GAAG;gBACH,UAAU,EAAE,SAAS;gBACrB,QAAQ,EAAE,IAAI,CAAC,OAAO;gBACtB,OAAO;gBACP,MAAM;aACP,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/web-fetch.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "../providers/types.js";
+export declare function createWebFetchTool(): ToolDefinition;
+//# sourceMappingURL=web-fetch.d.ts.map

package/dist/tools/web-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-fetch.d.ts","sourceRoot":"","sources":["../../src/tools/web-fetch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,wBAAgB,kBAAkB,IAAI,cAAc,CAyEnD"}

package/dist/tools/web-fetch.js

@@ -0,0 +1,112 @@
+import { Readability } from "@mozilla/readability";
+import { parseHTML } from "linkedom";
+export function createWebFetchTool() {
+    return {
+        name: "web_fetch",
+        description: "Fetch a URL and return the page content as readable text. Handles HTML (extracts article content), PDFs (extracts text), and plain text. Use this to read documentation, papers, blog posts, or any web page.",
+        parameters: {
+            type: "object",
+            properties: {
+                url: {
+                    type: "string",
+                    description: "URL to fetch",
+                },
+                max_length: {
+                    type: "number",
+                    description: "Max characters to return (default: 20000)",
+                },
+            },
+            required: ["url"],
+        },
+        execute: async (args) => {
+            const url = args.url;
+            const maxLength = args.max_length ?? 20000;
+            try {
+                const resp = await fetch(url, {
+                    headers: {
+                        "User-Agent": "Helios-ML-Agent/1.0",
+                        Accept: "text/html,application/xhtml+xml,application/pdf,text/plain,application/json",
+                    },
+                    redirect: "follow",
+                    signal: AbortSignal.timeout(30_000),
+                });
+                if (!resp.ok) {
+                    return JSON.stringify({ error: `HTTP ${resp.status}: ${resp.statusText}` });
+                }
+                const contentType = resp.headers.get("content-type") ?? "";
+                let title;
+                let text;
+                if (contentType.includes("application/pdf") || url.endsWith(".pdf")) {
+                    const buffer = new Uint8Array(await resp.arrayBuffer());
+                    const { extractText } = await import("unpdf");
+                    const result = await extractText(buffer);
+                    text = Array.isArray(result.text) ? result.text.join("\n") : result.text;
+                }
+                else if (contentType.includes("text/html") || contentType.includes("xhtml")) {
+                    const html = await resp.text();
+                    const parsed = extractArticle(html, url);
+                    title = parsed.title;
+                    text = parsed.text;
+                }
+                else {
+                    text = await resp.text();
+                }
+                const truncated = text.length > maxLength;
+                const content = truncated ? text.slice(0, maxLength) : text;
+                return JSON.stringify({
+                    url,
+                    title,
+                    content_type: contentType.split(";")[0],
+                    length: text.length,
+                    truncated,
+                    content,
+                });
+            }
+            catch (err) {
+                return JSON.stringify({
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        },
+    };
+}
+function extractArticle(html, url) {
+    const { document } = parseHTML(html);
+    const reader = new Readability(document);
+    const article = reader.parse();
+    if (article?.textContent) {
+        // Clean up readability output — collapse excessive whitespace
+        const text = article.textContent
+            .split("\n")
+            .map((line) => line.trim())
+            .join("\n")
+            .replace(/\n{3,}/g, "\n\n")
+            .trim();
+        return { title: article.title ?? undefined, text };
+    }
+    // Fallback: basic tag stripping if readability can't extract
+    return { text: fallbackHtmlToText(html) };
+}
+function fallbackHtmlToText(html) {
+    let text = html;
+    text = text.replace(/<script[\s\S]*?<\/script>/gi, "");
+    text = text.replace(/<style[\s\S]*?<\/style>/gi, "");
+    text = text.replace(/<head[\s\S]*?<\/head>/gi, "");
+    text = text.replace(/<!--[\s\S]*?-->/g, "");
+    text = text.replace(/<\/(p|div|h[1-6]|li|tr|blockquote|pre|section|article)>/gi, "\n");
+    text = text.replace(/<br\s*\/?>/gi, "\n");
+    text = text.replace(/<[^>]+>/g, "");
+    text = text
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&nbsp;/g, " ");
+    text = text
+        .split("\n")
+        .map((line) => line.replace(/[ \t]+/g, " ").trim())
+        .join("\n")
+        .replace(/\n{3,}/g, "\n\n");
+    return text.trim();
+}
+//# sourceMappingURL=web-fetch.js.map

package/dist/tools/web-fetch.js.map

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

package/dist/ui/commands.d.ts

@@ -0,0 +1,7 @@
+export interface SlashCommand {
+    name: string;
+    args?: string;
+    description: string;
+}
+export declare const COMMANDS: SlashCommand[];
+//# sourceMappingURL=commands.d.ts.map

package/dist/ui/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/ui/commands.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,QAAQ,EAAE,YAAY,EAmBlC,CAAC"}

package/dist/ui/commands.js

@@ -0,0 +1,21 @@
+export const COMMANDS = [
+    { name: "help", description: "Show available commands and keybindings" },
+    { name: "switch", args: "<claude|openai>", description: "Switch model provider" },
+    { name: "model", args: "<model-id>", description: "Set model (e.g. gpt-5.4, claude-opus-4-6)" },
+    { name: "models", description: "List available models for current provider" },
+    { name: "reasoning", args: "<low|medium|high>", description: "Set reasoning effort level" },
+    { name: "claude-mode", args: "<cli|api>", description: "Switch Claude auth mode (cli = Agent SDK, api = API key)" },
+    { name: "resume", args: "[number]", description: "List or resume a past session" },
+    { name: "metric", args: "[name1 name2 ...]", description: "Show sparklines for named metrics" },
+    { name: "metrics", args: "clear", description: "Clear all collected metrics" },
+    { name: "writeup", description: "Generate an experiment writeup from the session" },
+    { name: "machine", args: "<add|rm|list>", description: "Manage remote machines" },
+    { name: "machines", description: "List configured remote machines" },
+    { name: "sticky", args: "<text>", description: "Pin a sticky note (always visible to the model)" },
+    { name: "stickies", args: "[rm <num>]", description: "List sticky notes, or remove one by number" },
+    { name: "memory", args: "[path]", description: "Show the memory tree (virtual filesystem)" },
+    { name: "status", description: "Show provider, model, state, and cost" },
+    { name: "clear", description: "Clear conversation history" },
+    { name: "quit", description: "Exit Helios" },
+];
+//# sourceMappingURL=commands.js.map

package/dist/ui/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/ui/commands.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,QAAQ,GAAmB;IACtC,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,yCAAyC,EAAE;IACxE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,iBAAiB,EAAE,WAAW,EAAE,uBAAuB,EAAE;IACjF,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,2CAA2C,EAAE;IAC/F,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4CAA4C,EAAE;IAC7E,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,mBAAmB,EAAE,WAAW,EAAE,4BAA4B,EAAE;IAC3F,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,0DAA0D,EAAE;IACnH,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,+BAA+B,EAAE;IAClF,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,mBAAmB,EAAE,WAAW,EAAE,mCAAmC,EAAE;IAC/F,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,6BAA6B,EAAE;IAC9E,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,iDAAiD,EAAE;IACnF,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,wBAAwB,EAAE;IACjF,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,iCAAiC,EAAE;IACpE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iDAAiD,EAAE;IAClG,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,4CAA4C,EAAE;IACnG,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2CAA2C,EAAE;IAC5F,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uCAAuC,EAAE;IACxE,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,4BAA4B,EAAE;IAC5D,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE;CAC7C,CAAC"}