@snoglobe/helios 0.1.0

package/dist/tools/file-ops.js

@@ -0,0 +1,158 @@
+export function createReadFileTool(pool) {
+    return {
+        name: "read_file",
+        description: "Read a file's contents. Use this to inspect training scripts, configs, logs, or any text file.",
+        parameters: {
+            type: "object",
+            properties: {
+                machine_id: {
+                    type: "string",
+                    description: 'Machine to read from (use "local" for this machine)',
+                },
+                path: {
+                    type: "string",
+                    description: "Absolute path to the file",
+                },
+                offset: {
+                    type: "number",
+                    description: "Line number to start from (1-indexed, default: 1)",
+                },
+                limit: {
+                    type: "number",
+                    description: "Max lines to return (default: 200)",
+                },
+            },
+            required: ["machine_id", "path"],
+        },
+        execute: async (args) => {
+            const machineId = args.machine_id;
+            const path = args.path;
+            const offset = args.offset ?? 1;
+            const limit = args.limit ?? 200;
+            const end = offset + limit - 1;
+            const result = await pool.exec(machineId, `sed -n '${offset},${end}p' ${shellQuote(path)}`);
+            if (result.exitCode !== 0) {
+                return JSON.stringify({ error: result.stderr.trim() || `exit code ${result.exitCode}` });
+            }
+            // Count total lines for context
+            const wcResult = await pool.exec(machineId, `wc -l < ${shellQuote(path)}`);
+            const totalLines = parseInt(wcResult.stdout.trim(), 10) || 0;
+            return JSON.stringify({
+                content: result.stdout,
+                lines: { from: offset, to: Math.min(end, totalLines), total: totalLines },
+            });
+        },
+    };
+}
+export function createWriteFileTool(pool) {
+    return {
+        name: "write_file",
+        description: "Create or overwrite a file. Use this to write training scripts, configs, or data files.",
+        parameters: {
+            type: "object",
+            properties: {
+                machine_id: {
+                    type: "string",
+                    description: 'Machine to write to (use "local" for this machine)',
+                },
+                path: {
+                    type: "string",
+                    description: "Absolute path for the file",
+                },
+                content: {
+                    type: "string",
+                    description: "Full file content to write",
+                },
+                append: {
+                    type: "boolean",
+                    description: "Append instead of overwrite (default: false)",
+                },
+            },
+            required: ["machine_id", "path", "content"],
+        },
+        execute: async (args) => {
+            const machineId = args.machine_id;
+            const path = args.path;
+            const content = args.content;
+            const append = args.append ?? false;
+            // Ensure parent directory exists
+            const dir = path.replace(/\/[^/]+$/, "");
+            if (dir && dir !== path) {
+                await pool.exec(machineId, `mkdir -p ${shellQuote(dir)}`);
+            }
+            const op = append ? ">>" : ">";
+            // Use heredoc to handle multi-line content safely
+            // Heredoc implicitly adds a trailing newline, so strip one from content to avoid doubling
+            const body = content.endsWith("\n") ? content.slice(0, -1) : content;
+            const heredocTag = "_HELIOS_EOF_" + Math.random().toString(36).slice(2, 8);
+            const result = await pool.exec(machineId, `cat ${op} ${shellQuote(path)} <<'${heredocTag}'\n${body}\n${heredocTag}`);
+            if (result.exitCode !== 0) {
+                return JSON.stringify({ error: result.stderr.trim() || `exit code ${result.exitCode}` });
+            }
+            const wcResult = await pool.exec(machineId, `wc -l < ${shellQuote(path)}`);
+            const totalLines = parseInt(wcResult.stdout.trim(), 10) || 0;
+            return JSON.stringify({ written: path, lines: totalLines });
+        },
+    };
+}
+export function createPatchFileTool(pool) {
+    return {
+        name: "patch_file",
+        description: "Edit a file by replacing a specific string with new content. Read the file first to see the exact text to match.",
+        parameters: {
+            type: "object",
+            properties: {
+                machine_id: {
+                    type: "string",
+                    description: 'Machine where the file lives (use "local" for this machine)',
+                },
+                path: {
+                    type: "string",
+                    description: "Absolute path to the file",
+                },
+                old_string: {
+                    type: "string",
+                    description: "Exact text to find and replace (must appear exactly once in the file)",
+                },
+                new_string: {
+                    type: "string",
+                    description: "Replacement text",
+                },
+            },
+            required: ["machine_id", "path", "old_string", "new_string"],
+        },
+        execute: async (args) => {
+            const machineId = args.machine_id;
+            const path = args.path;
+            const oldStr = args.old_string;
+            const newStr = args.new_string;
+            // Read current file
+            const readResult = await pool.exec(machineId, `cat ${shellQuote(path)}`);
+            if (readResult.exitCode !== 0) {
+                return JSON.stringify({ error: readResult.stderr.trim() || "Failed to read file" });
+            }
+            const content = readResult.stdout;
+            const count = content.split(oldStr).length - 1;
+            if (count === 0) {
+                return JSON.stringify({ error: "old_string not found in file" });
+            }
+            if (count > 1) {
+                return JSON.stringify({ error: `old_string found ${count} times — must be unique. Include more surrounding context.` });
+            }
+            const patched = content.replace(oldStr, newStr);
+            // Write back using heredoc
+            // Strip trailing newline since heredoc adds one implicitly
+            const body = patched.endsWith("\n") ? patched.slice(0, -1) : patched;
+            const heredocTag = "_HELIOS_EOF_" + Math.random().toString(36).slice(2, 8);
+            const writeResult = await pool.exec(machineId, `cat > ${shellQuote(path)} <<'${heredocTag}'\n${body}\n${heredocTag}`);
+            if (writeResult.exitCode !== 0) {
+                return JSON.stringify({ error: writeResult.stderr.trim() || "Failed to write file" });
+            }
+            return JSON.stringify({ patched: path });
+        },
+    };
+}
+function shellQuote(s) {
+    return "'" + s.replace(/'/g, "'\\''") + "'";
+}
+//# sourceMappingURL=file-ops.js.map

package/dist/tools/file-ops.js.map

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

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

@@ -0,0 +1,6 @@
+import type { ToolDefinition } from "../providers/types.js";
+import type { RemoteExecutor } from "../remote/executor.js";
+import type { ConnectionPool } from "../remote/connection-pool.js";
+import type { MetricCollector } from "../metrics/collector.js";
+export declare function createKillTaskTool(executor: RemoteExecutor, pool: ConnectionPool, metricCollector?: MetricCollector): ToolDefinition;
+//# sourceMappingURL=kill-task.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kill-task.d.ts","sourceRoot":"","sources":["../../src/tools/kill-task.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;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,cAAc,EACpB,eAAe,CAAC,EAAE,eAAe,GAChC,cAAc,CA4DhB"}

package/dist/tools/kill-task.js

@@ -0,0 +1,55 @@
+export function createKillTaskTool(executor, pool, metricCollector) {
+    return {
+        name: "kill_task",
+        description: "Kill a running background process. Use this to abort diverging training, stuck processes, or experiments you want to discard.",
+        parameters: {
+            type: "object",
+            properties: {
+                machine_id: {
+                    type: "string",
+                    description: 'Machine the process is running on (e.g. "local")',
+                },
+                pid: {
+                    type: "number",
+                    description: "PID of the process to kill",
+                },
+                signal: {
+                    type: "string",
+                    description: "Signal to send (default: TERM). Use KILL for unresponsive processes.",
+                },
+            },
+            required: ["machine_id", "pid"],
+        },
+        execute: async (args) => {
+            const machineId = args.machine_id;
+            const pid = args.pid;
+            const signal = args.signal ?? "TERM";
+            const taskKey = `${machineId}:${pid}`;
+            const running = await executor.isRunning(machineId, pid);
+            if (!running) {
+                // Final metric collection before cleanup
+                if (metricCollector) {
+                    await metricCollector.collectAll().catch(() => { });
+                    metricCollector.removeSource(taskKey);
+                }
+                executor.removeBackgroundProcess(taskKey);
+                return JSON.stringify({ status: "already_exited", pid });
+            }
+            const result = await pool.exec(machineId, `kill -${signal} ${pid}`);
+            if (result.exitCode !== 0) {
+                return JSON.stringify({
+                    error: result.stderr.trim() || `kill failed with exit code ${result.exitCode}`,
+                });
+            }
+            // Brief wait for the process to flush output, then final collection
+            await new Promise((r) => setTimeout(r, 500));
+            if (metricCollector) {
+                await metricCollector.collectAll().catch(() => { });
+                metricCollector.removeSource(taskKey);
+            }
+            executor.removeBackgroundProcess(taskKey);
+            return JSON.stringify({ status: "killed", pid, signal });
+        },
+    };
+}
+//# sourceMappingURL=kill-task.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kill-task.js","sourceRoot":"","sources":["../../src/tools/kill-task.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,kBAAkB,CAChC,QAAwB,EACxB,IAAoB,EACpB,eAAiC;IAEjC,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,WAAW,EACT,+HAA+H;QACjI,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,kDAAkD;iBAChE;gBACD,GAAG,EAAE;oBACH,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4BAA4B;iBAC1C;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sEAAsE;iBACpF;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,MAAM,GAAI,IAAI,CAAC,MAAiB,IAAI,MAAM,CAAC;YAEjD,MAAM,OAAO,GAAG,GAAG,SAAS,IAAI,GAAG,EAAE,CAAC;YAEtC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YACzD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,yCAAyC;gBACzC,IAAI,eAAe,EAAE,CAAC;oBACpB,MAAM,eAAe,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;oBACnD,eAAe,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;gBACxC,CAAC;gBACD,QAAQ,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC;gBAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,CAAC,CAAC;YAC3D,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC;YAEpE,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,IAAI,CAAC,SAAS,CAAC;oBACpB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,8BAA8B,MAAM,CAAC,QAAQ,EAAE;iBAC/E,CAAC,CAAC;YACL,CAAC;YAED,oEAAoE;YACpE,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YAC7C,IAAI,eAAe,EAAE,CAAC;gBACpB,MAAM,eAAe,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBACnD,eAAe,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;YACxC,CAAC;YAED,QAAQ,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC;YAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;QAC3D,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/list-machines.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from "../providers/types.js";
+import type { ConnectionPool } from "../remote/connection-pool.js";
+export declare function createListMachinesTool(pool: ConnectionPool): ToolDefinition;
+//# sourceMappingURL=list-machines.d.ts.map

package/dist/tools/list-machines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-machines.d.ts","sourceRoot":"","sources":["../../src/tools/list-machines.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,cAAc,GACnB,cAAc,CAuBhB"}

package/dist/tools/list-machines.js

@@ -0,0 +1,24 @@
+export function createListMachinesTool(pool) {
+    return {
+        name: "list_machines",
+        description: "List all configured remote machines and their connection status.",
+        parameters: {
+            type: "object",
+            properties: {},
+        },
+        execute: async () => {
+            const statuses = pool.getAllStatuses();
+            return JSON.stringify({
+                machines: statuses.map((s) => ({
+                    id: s.machineId,
+                    connected: s.connected,
+                    last_connected: s.lastConnectedAt
+                        ? new Date(s.lastConnectedAt).toISOString()
+                        : null,
+                    error: s.error ?? null,
+                })),
+            });
+        },
+    };
+}
+//# sourceMappingURL=list-machines.js.map

package/dist/tools/list-machines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-machines.js","sourceRoot":"","sources":["../../src/tools/list-machines.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,sBAAsB,CACpC,IAAoB;IAEpB,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,kEAAkE;QACpE,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;QACD,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC7B,EAAE,EAAE,CAAC,CAAC,SAAS;oBACf,SAAS,EAAE,CAAC,CAAC,SAAS;oBACtB,cAAc,EAAE,CAAC,CAAC,eAAe;wBAC/B,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,WAAW,EAAE;wBAC3C,CAAC,CAAC,IAAI;oBACR,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI;iBACvB,CAAC,CAAC;aACJ,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,8 @@
+import type { ToolDefinition } from "../providers/types.js";
+import type { MemoryStore } from "../memory/memory-store.js";
+export declare function createMemoryLsTool(memory: MemoryStore): ToolDefinition;
+export declare function createMemoryReadTool(memory: MemoryStore): ToolDefinition;
+export declare function createMemoryWriteTool(memory: MemoryStore): ToolDefinition;
+export declare function createMemoryRmTool(memory: MemoryStore): ToolDefinition;
+export declare function createMemoryTools(memory: MemoryStore): ToolDefinition[];
+//# sourceMappingURL=memory-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-tools.d.ts","sourceRoot":"","sources":["../../src/tools/memory-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,cAAc,CAgCtE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,cAAc,CAgCxE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,GAAG,cAAc,CAkCzE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,cAAc,CAqBtE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,cAAc,EAAE,CAOvE"}

package/dist/tools/memory-tools.js

@@ -0,0 +1,122 @@
+export function createMemoryLsTool(memory) {
+    return {
+        name: "memory_ls",
+        description: "List children of a memory directory. Shows path + gist for each child. " +
+            "This is the index — scan it to see what you have stored and decide what to read.",
+        parameters: {
+            type: "object",
+            properties: {
+                path: {
+                    type: "string",
+                    description: 'Directory path to list (default: "/")',
+                },
+            },
+        },
+        execute: async (args) => {
+            const path = args.path ?? "/";
+            const nodes = memory.ls(path);
+            if (nodes.length === 0) {
+                return JSON.stringify({ path, children: [], note: "Empty directory" });
+            }
+            const children = nodes.map((n) => ({
+                path: n.path,
+                gist: n.gist,
+                type: n.isDir ? "dir" : "file",
+            }));
+            return JSON.stringify({ path, children });
+        },
+    };
+}
+export function createMemoryReadTool(memory) {
+    return {
+        name: "memory_read",
+        description: "Read the full content of a memory node. Use memory_ls first to find what you need, then read specific nodes.",
+        parameters: {
+            type: "object",
+            properties: {
+                path: {
+                    type: "string",
+                    description: "Path of the node to read",
+                },
+            },
+            required: ["path"],
+        },
+        execute: async (args) => {
+            const path = args.path;
+            const node = memory.read(path);
+            if (!node) {
+                return JSON.stringify({ error: `Not found: ${path}` });
+            }
+            return JSON.stringify({
+                path: node.path,
+                gist: node.gist,
+                content: node.content,
+                type: node.isDir ? "dir" : "file",
+                updated_at: node.updatedAt,
+            });
+        },
+    };
+}
+export function createMemoryWriteTool(memory) {
+    return {
+        name: "memory_write",
+        description: "Write or update a memory node. Parent directories are auto-created. " +
+            "Use this to store observations, hypotheses, decisions, experiment notes — anything worth remembering. " +
+            "The gist should be a short label (what this IS), the content is the full detail.",
+        parameters: {
+            type: "object",
+            properties: {
+                path: {
+                    type: "string",
+                    description: 'Path for the node (e.g. "/observations/lr-warmup-helps")',
+                },
+                gist: {
+                    type: "string",
+                    description: "Short label/summary (the key in the KV pair, shown in tree listings)",
+                },
+                content: {
+                    type: "string",
+                    description: "Full content (the value). Omit to create a directory.",
+                },
+            },
+            required: ["path", "gist"],
+        },
+        execute: async (args) => {
+            const path = args.path;
+            const gist = args.gist;
+            const content = args.content;
+            memory.write(path, gist, content);
+            return JSON.stringify({ ok: true, path, gist });
+        },
+    };
+}
+export function createMemoryRmTool(memory) {
+    return {
+        name: "memory_rm",
+        description: "Remove a memory node (and all children if it's a directory). Use this to clean up discarded experiments or outdated observations.",
+        parameters: {
+            type: "object",
+            properties: {
+                path: {
+                    type: "string",
+                    description: "Path to remove",
+                },
+            },
+            required: ["path"],
+        },
+        execute: async (args) => {
+            const path = args.path;
+            const removed = memory.rm(path);
+            return JSON.stringify({ ok: true, path, removed_count: removed });
+        },
+    };
+}
+export function createMemoryTools(memory) {
+    return [
+        createMemoryLsTool(memory),
+        createMemoryReadTool(memory),
+        createMemoryWriteTool(memory),
+        createMemoryRmTool(memory),
+    ];
+}
+//# sourceMappingURL=memory-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-tools.js","sourceRoot":"","sources":["../../src/tools/memory-tools.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,kBAAkB,CAAC,MAAmB;IACpD,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,WAAW,EACT,yEAAyE;YACzE,kFAAkF;QACpF,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,uCAAuC;iBACrD;aACF;SACF;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,IAAI,GAAI,IAAI,CAAC,IAAe,IAAI,GAAG,CAAC;YAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;YAE9B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC;YACzE,CAAC;YAED,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACjC,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM;aAC/B,CAAC,CAAC,CAAC;YAEJ,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC5C,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAmB;IACtD,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,8GAA8G;QAChH,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0BAA0B;iBACxC;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;SACnB;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAc,CAAC;YACjC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAE/B,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,cAAc,IAAI,EAAE,EAAE,CAAC,CAAC;YACzD,CAAC;YAED,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM;gBACjC,UAAU,EAAE,IAAI,CAAC,SAAS;aAC3B,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAAmB;IACvD,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,sEAAsE;YACtE,wGAAwG;YACxG,kFAAkF;QACpF,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0DAA0D;iBACxE;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sEAAsE;iBACpF;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,uDAAuD;iBACrE;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;SAC3B;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAc,CAAC;YACjC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAc,CAAC;YACjC,MAAM,OAAO,GAAG,IAAI,CAAC,OAA6B,CAAC;YAEnD,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;YAClC,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAmB;IACpD,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,WAAW,EACT,mIAAmI;QACrI,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,gBAAgB;iBAC9B;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;SACnB;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAc,CAAC;YACjC,MAAM,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;YAChC,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC;QACpE,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAmB;IACnD,OAAO;QACL,kBAAkB,CAAC,MAAM,CAAC;QAC1B,oBAAoB,CAAC,MAAM,CAAC;QAC5B,qBAAqB,CAAC,MAAM,CAAC;QAC7B,kBAAkB,CAAC,MAAM,CAAC;KAC3B,CAAC;AACJ,CAAC"}

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

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

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

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

package/dist/tools/metrics-query.js

@@ -0,0 +1,69 @@
+import { analyzeMetric } from "../metrics/analyzer.js";
+export function createMetricsQueryTool(store) {
+    return {
+        name: "metrics_query",
+        description: "Query collected training metrics. Can get latest values, time series, or trend analysis.",
+        parameters: {
+            type: "object",
+            properties: {
+                task_id: {
+                    type: "string",
+                    description: "ID of the task to query metrics for",
+                },
+                metric_name: {
+                    type: "string",
+                    description: "Name of the metric (e.g., 'loss', 'accuracy'). Omit to list all available metrics.",
+                },
+                mode: {
+                    type: "string",
+                    enum: ["latest", "series", "analyze", "list"],
+                    description: "Query mode: 'latest' for most recent value, 'series' for time series, 'analyze' for trend analysis, 'list' for available metric names",
+                },
+                limit: {
+                    type: "number",
+                    description: "Max number of data points for series mode",
+                },
+            },
+            required: ["task_id"],
+        },
+        execute: async (args) => {
+            const taskId = args.task_id;
+            const metricName = args.metric_name;
+            const mode = args.mode ?? "latest";
+            const limit = args.limit ?? 100;
+            if (mode === "list" || !metricName) {
+                const names = store.getMetricNames(taskId);
+                return JSON.stringify({ metrics: names });
+            }
+            switch (mode) {
+                case "latest": {
+                    const point = store.getLatest(taskId, metricName);
+                    return JSON.stringify(point ?? { error: "No data" });
+                }
+                case "series": {
+                    const points = store.getSeries(taskId, metricName, limit);
+                    return JSON.stringify({
+                        metric: metricName,
+                        count: points.length,
+                        values: points.map((p) => ({
+                            value: p.value,
+                            step: p.step,
+                            timestamp: p.timestamp,
+                        })),
+                    });
+                }
+                case "analyze": {
+                    const points = store.getSeries(taskId, metricName, 100);
+                    const analysis = analyzeMetric(points);
+                    return JSON.stringify({
+                        metric: metricName,
+                        ...analysis,
+                    });
+                }
+                default:
+                    return JSON.stringify({ error: `Unknown mode: ${mode}` });
+            }
+        },
+    };
+}
+//# sourceMappingURL=metrics-query.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-query.js","sourceRoot":"","sources":["../../src/tools/metrics-query.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,MAAM,UAAU,sBAAsB,CACpC,KAAkB;IAElB,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,0FAA0F;QAC5F,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,qCAAqC;iBACnD;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,oFAAoF;iBACvF;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC;oBAC7C,WAAW,EACT,uIAAuI;iBAC1I;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2CAA2C;iBACzD;aACF;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;SACtB;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAiB,CAAC;YACtC,MAAM,UAAU,GAAG,IAAI,CAAC,WAAiC,CAAC;YAC1D,MAAM,IAAI,GAAI,IAAI,CAAC,IAAe,IAAI,QAAQ,CAAC;YAC/C,MAAM,KAAK,GAAI,IAAI,CAAC,KAAgB,IAAI,GAAG,CAAC;YAE5C,IAAI,IAAI,KAAK,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;gBACnC,MAAM,KAAK,GAAG,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;gBAC3C,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YAC5C,CAAC;YAED,QAAQ,IAAI,EAAE,CAAC;gBACb,KAAK,QAAQ,CAAC,CAAC,CAAC;oBACd,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;oBAClD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;gBACvD,CAAC;gBAED,KAAK,QAAQ,CAAC,CAAC,CAAC;oBACd,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;oBAC1D,OAAO,IAAI,CAAC,SAAS,CAAC;wBACpB,MAAM,EAAE,UAAU;wBAClB,KAAK,EAAE,MAAM,CAAC,MAAM;wBACpB,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;4BACzB,KAAK,EAAE,CAAC,CAAC,KAAK;4BACd,IAAI,EAAE,CAAC,CAAC,IAAI;4BACZ,SAAS,EAAE,CAAC,CAAC,SAAS;yBACvB,CAAC,CAAC;qBACJ,CAAC,CAAC;gBACL,CAAC;gBAED,KAAK,SAAS,CAAC,CAAC,CAAC;oBACf,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;oBACxD,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;oBACvC,OAAO,IAAI,CAAC,SAAS,CAAC;wBACpB,MAAM,EAAE,UAAU;wBAClB,GAAG,QAAQ;qBACZ,CAAC,CAAC;gBACL,CAAC;gBAED;oBACE,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,iBAAiB,IAAI,EAAE,EAAE,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/monitor.d.ts

@@ -0,0 +1,5 @@
+import type { ToolDefinition } from "../providers/types.js";
+import type { MonitorManager } from "../core/monitor.js";
+export declare function createStartMonitorTool(monitor: MonitorManager): ToolDefinition;
+export declare function createStopMonitorTool(monitor: MonitorManager): ToolDefinition;
+//# sourceMappingURL=monitor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"monitor.d.ts","sourceRoot":"","sources":["../../src/tools/monitor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,cAAc,GACtB,cAAc,CAgDhB;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,GACtB,cAAc,CAiBhB"}

package/dist/tools/monitor.js

@@ -0,0 +1,64 @@
+export function createStartMonitorTool(monitor) {
+    return {
+        name: "start_monitor",
+        description: `Start a monitoring loop that periodically re-invokes you with a status update. Use this after launching a background task so you get called back to check on progress without needing to sleep/wake repeatedly.
+
+When the monitor fires, you receive a message with:
+- Elapsed time since monitoring started
+- Current task statuses (running/completed/failed)
+- Latest metric values
+- Your original goal
+
+You can then take actions (check output, adjust params, launch new runs) and your response ends. The monitor will call you again at the next interval.
+
+Calling start_monitor again replaces the current monitor — use this to adjust the interval as conditions change. Match the interval to what you're waiting for: 1-2m for short runs, 5-10m for long ones. If nothing is changing, increase the interval to save context.
+
+Call stop_monitor when the goal is complete or you no longer need periodic checks.
+
+IMPORTANT: After calling start_monitor, you can continue doing other things in the same turn (unlike sleep). The monitor runs in the background.`,
+        parameters: {
+            type: "object",
+            properties: {
+                interval_minutes: {
+                    type: "number",
+                    description: "How often to check (in minutes). Default: 2",
+                },
+                goal: {
+                    type: "string",
+                    description: "What you are monitoring for. This is included in each status update to remind you of the objective.",
+                },
+            },
+            required: ["goal"],
+        },
+        execute: async (args) => {
+            const intervalMin = args.interval_minutes ?? 2;
+            const goal = args.goal;
+            const intervalMs = intervalMin * 60 * 1000;
+            const config = monitor.start(intervalMs, goal);
+            return JSON.stringify({
+                status: "monitoring",
+                interval_minutes: intervalMin,
+                goal,
+                started_at: new Date(config.startedAt).toISOString(),
+            });
+        },
+    };
+}
+export function createStopMonitorTool(monitor) {
+    return {
+        name: "stop_monitor",
+        description: "Stop the active monitoring loop. Call this when the objective is complete or you no longer need periodic check-ins.",
+        parameters: {
+            type: "object",
+            properties: {},
+        },
+        execute: async () => {
+            if (!monitor.isActive) {
+                return JSON.stringify({ status: "no_active_monitor" });
+            }
+            monitor.stop();
+            return JSON.stringify({ status: "stopped" });
+        },
+    };
+}
+//# sourceMappingURL=monitor.js.map

package/dist/tools/monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor.js","sourceRoot":"","sources":["../../src/tools/monitor.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,sBAAsB,CACpC,OAAuB;IAEvB,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE;;;;;;;;;;;;;;iJAcgI;QAC7I,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,gBAAgB,EAAE;oBAChB,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,6CAA6C;iBAC3D;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,qGAAqG;iBACxG;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;SACnB;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,WAAW,GAAI,IAAI,CAAC,gBAA2B,IAAI,CAAC,CAAC;YAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAc,CAAC;YACjC,MAAM,UAAU,GAAG,WAAW,GAAG,EAAE,GAAG,IAAI,CAAC;YAE3C,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YAE/C,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,MAAM,EAAE,YAAY;gBACpB,gBAAgB,EAAE,WAAW;gBAC7B,IAAI;gBACJ,UAAU,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;aACrD,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,OAAuB;IAEvB,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,qHAAqH;QACvH,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;QACD,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACtB,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC,CAAC;YACzD,CAAC;YACD,OAAO,CAAC,IAAI,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QAC/C,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,6 @@
+import type { ToolDefinition } from "../providers/types.js";
+import type { RemoteExecutor } from "../remote/executor.js";
+import type { MetricCollector } from "../metrics/collector.js";
+export declare function createRemoteExecTool(executor: RemoteExecutor): ToolDefinition;
+export declare function createRemoteExecBackgroundTool(executor: RemoteExecutor, metricCollector?: MetricCollector): ToolDefinition;
+//# sourceMappingURL=remote-exec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remote-exec.d.ts","sourceRoot":"","sources":["../../src/tools/remote-exec.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,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG/D,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,cAAc,GACvB,cAAc,CAsChB;AAED,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,cAAc,EACxB,eAAe,CAAC,EAAE,eAAe,GAChC,cAAc,CAuEhB"}