@snoglobe/helios 0.2.1 → 0.3.2

package/dist/skills/bundled/writeup.md

@@ -0,0 +1,57 @@
+---
+name: writeup
+description: Generate a structured experiment writeup
+tools: [memory_ls, memory_read, show_metrics, compare_runs, read_file, task_output, web_fetch]
+---
+You are a scientific writing assistant. You will receive experiment notes or a session transcript from an ML research agent.
+
+Produce a clean, structured experiment writeup. Write it as a practitioner's report, not an academic paper. Be concise but thorough.
+
+## Available Tools
+You have access to read-only tools to gather data for the writeup. Use them proactively:
+- **memory_ls / memory_read**: Read the agent's memory tree for experiment results, observations, and stored findings
+- **show_metrics / compare_runs**: Query metric data and compare experiment runs
+- **read_file**: Read code, configs, or data files from machines
+- **task_output**: Check output from running or finished tasks
+- **web_fetch**: Fetch referenced papers or documentation
+
+Use these tools to fill in gaps — if the notes mention an experiment but lack specific numbers, check metrics or memory. If code changes are referenced, read the relevant files.
+
+## Format
+
+# [Title — infer from the goal]
+
+## Objective
+What was the researcher trying to achieve?
+
+## Setup
+- Model architecture, dataset, hardware
+- Key hyperparameters and configuration
+
+## Experiments
+For each distinct experiment/run:
+- What was tried and why
+- Key metrics (include actual numbers)
+- Whether it improved over the previous best
+
+## Results
+- Best configuration found
+- Final metric values
+- Comparison to baseline / starting point
+
+## Observations
+- What worked, what didn't
+- Surprising findings
+- Hypotheses about why certain changes helped/hurt
+
+## Next Steps (if applicable)
+- Promising directions not yet explored
+- Known limitations
+
+## Citations
+- If the work builds on another agent's commit, cite it: "Based on [agent_id/hash_prefix]"
+- If referencing an AgentHub post, cite by post ID: "As noted in post #42"
+- If reproducing or extending results from another agent, credit them explicitly
+- Look for hub_fetch, hub_read, and hub_log tool calls in the transcript to identify sources
+
+Keep the writing direct and data-driven. Use actual metric values. Do not invent data.

package/dist/skills/executor.d.ts

@@ -0,0 +1,28 @@
+import type { Skill } from "./types.js";
+import type { ToolDefinition, AgentEvent } from "../providers/types.js";
+import type { Orchestrator } from "../core/orchestrator.js";
+export interface SkillExecContext {
+    orchestrator: Orchestrator;
+    /** All registered tools on the orchestrator (for filtering). */
+    allTools: ToolDefinition[];
+    /** Signal to stop a looping skill. */
+    signal?: AbortSignal;
+}
+/**
+ * Execute a skill. Yields AgentEvents that the caller can
+ * render however they want (TUI streaming, stdout, tool result JSON, etc.).
+ *
+ * For looping skills (loop: true), runs repeatedly with delay_ms pauses,
+ * each iteration as a fresh session. The model uses memory to maintain
+ * continuity. Loops until ctx.signal is aborted.
+ */
+export declare function executeSkill(skill: Skill, args: Record<string, string>, input: string, ctx: SkillExecContext): AsyncGenerator<AgentEvent>;
+/**
+ * Execute a skill and collect all text output into a string.
+ * Used by tools that wrap skills (e.g. the writeup tool, consult tool).
+ */
+export declare function executeSkillToString(skill: Skill, args: Record<string, string>, input: string, ctx: SkillExecContext): Promise<{
+    text: string;
+    error?: string;
+}>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/skills/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/skills/executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAiB,MAAM,uBAAuB,CAAC;AACvF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAY5D,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,gEAAgE;IAChE,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,sCAAsC;IACtC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAoED;;;;;;;GAOG;AACH,wBAAuB,YAAY,CACjC,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,gBAAgB,GACpB,cAAc,CAAC,UAAU,CAAC,CAyD5B;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAe3C"}

package/dist/skills/executor.js

@@ -0,0 +1,148 @@
+import { renderTemplate } from "./loader.js";
+import { formatError } from "../ui/format.js";
+/** Sleep that can be interrupted by an AbortSignal. */
+function interruptibleSleep(ms, signal) {
+    if (signal?.aborted)
+        return Promise.resolve();
+    return new Promise((resolve) => {
+        const timer = setTimeout(resolve, ms);
+        signal?.addEventListener("abort", () => { clearTimeout(timer); resolve(); }, { once: true });
+    });
+}
+/**
+ * Resolve which provider a skill should use.
+ * "other" means the non-active provider (for consult-style skills).
+ */
+function resolveProvider(skill, orch) {
+    const cfg = skill.config.provider;
+    if (!cfg || cfg === null)
+        return orch.currentProvider ?? null;
+    if (cfg === "other") {
+        const activeName = orch.currentProvider?.name;
+        if (!activeName)
+            return null;
+        const otherName = activeName === "claude" ? "openai" : "claude";
+        return orch.getProvider(otherName);
+    }
+    return orch.getProvider(cfg);
+}
+/** Filter tools based on skill's allow/deny config. */
+function filterTools(allTools, skill) {
+    const access = skill.config.tools;
+    if (!access)
+        return allTools;
+    if (access.allow) {
+        const allowed = new Set(access.allow);
+        return allTools.filter((t) => allowed.has(t.name));
+    }
+    if (access.deny) {
+        const denied = new Set(access.deny);
+        return allTools.filter((t) => !denied.has(t.name));
+    }
+    return allTools;
+}
+/** Run a single iteration of a skill (one provider session). */
+async function* runOnce(skill, args, input, provider, tools, orch) {
+    const systemPrompt = renderTemplate(skill.template, args);
+    const session = await provider.createSession({
+        systemPrompt,
+        model: skill.config.model ?? undefined,
+    });
+    const stream = provider.send(session, input, tools);
+    try {
+        for await (const event of stream) {
+            if (event.type === "done" && event.usage?.costUsd) {
+                orch.addCost(event.usage.costUsd, event.usage.inputTokens, event.usage.outputTokens);
+            }
+            yield event;
+        }
+    }
+    finally {
+        // Ensure inner generator is closed on early termination (preserves yield* semantics)
+        await stream.return(undefined).catch(() => { });
+        await provider.closeSession(session).catch(() => { });
+    }
+}
+/**
+ * Execute a skill. Yields AgentEvents that the caller can
+ * render however they want (TUI streaming, stdout, tool result JSON, etc.).
+ *
+ * For looping skills (loop: true), runs repeatedly with delay_ms pauses,
+ * each iteration as a fresh session. The model uses memory to maintain
+ * continuity. Loops until ctx.signal is aborted.
+ */
+export async function* executeSkill(skill, args, input, ctx) {
+    const provider = resolveProvider(skill, ctx.orchestrator);
+    if (!provider) {
+        yield { type: "error", error: new Error(`No provider available for skill "${skill.name}"`), recoverable: false };
+        return;
+    }
+    // Check auth for cross-provider skills
+    if (skill.config.provider === "other") {
+        if (!(await provider.isAuthenticated())) {
+            yield {
+                type: "error",
+                error: new Error(`Provider "${provider.name}" is not authenticated. Run /switch ${provider.name} first.`),
+                recoverable: false,
+            };
+            return;
+        }
+    }
+    const tools = filterTools(ctx.allTools, skill);
+    if (!skill.config.loop) {
+        // One-shot skill
+        yield* runOnce(skill, args, input, provider, tools, ctx.orchestrator);
+        return;
+    }
+    // Looping skill — re-invoke with delay between iterations
+    const delayMs = skill.config.delay_ms ?? 60_000;
+    let iteration = 0;
+    while (!ctx.signal?.aborted) {
+        iteration++;
+        const loopMsg = skill.config.loop_message ?? "Continue. This is iteration {iteration}.";
+        const iterInput = iteration === 1
+            ? input
+            : loopMsg.replace(/\{iteration\}/g, String(iteration));
+        try {
+            yield* runOnce(skill, args, iterInput, provider, tools, ctx.orchestrator);
+        }
+        catch (err) {
+            yield {
+                type: "error",
+                error: err instanceof Error ? err : new Error(String(err)),
+                recoverable: true,
+            };
+        }
+        // Wait between iterations (interruptible)
+        if (ctx.signal?.aborted)
+            break;
+        yield {
+            type: "text",
+            text: `\n*[next iteration in ${Math.round(delayMs / 1000)}s — Esc to stop]*\n`,
+            delta: `\n*[next iteration in ${Math.round(delayMs / 1000)}s — Esc to stop]*\n`,
+        };
+        await interruptibleSleep(delayMs, ctx.signal);
+    }
+}
+/**
+ * Execute a skill and collect all text output into a string.
+ * Used by tools that wrap skills (e.g. the writeup tool, consult tool).
+ */
+export async function executeSkillToString(skill, args, input, ctx) {
+    let text = "";
+    try {
+        for await (const event of executeSkill(skill, args, input, ctx)) {
+            if (event.type === "text" && event.delta) {
+                text += event.delta;
+            }
+            if (event.type === "error") {
+                return { text, error: formatError(event.error) };
+            }
+        }
+        return { text: text || "(empty response)" };
+    }
+    catch (err) {
+        return { text, error: formatError(err) };
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/skills/executor.js.map

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

package/dist/skills/loader.d.ts

@@ -0,0 +1,17 @@
+import type { Skill } from "./types.js";
+/**
+ * Copy bundled skills to ~/.helios/skills/ if they don't already exist.
+ * Called on first launch (or upgrade when new skills are added).
+ * Never overwrites user-edited files.
+ */
+export declare function seedBundledSkills(): void;
+export declare function parseSkillFile(filePath: string, source: Skill["source"]): Skill | null;
+/**
+ * Discover all skills. Priority: project > user.
+ * Bundled skills live in USER_DIR after seeding (see seedBundledSkills).
+ * Project skills override user skills with the same name.
+ */
+export declare function discoverSkills(projectDir?: string): Skill[];
+/** Render a template with {arg} placeholders replaced. */
+export declare function renderTemplate(template: string, args: Record<string, string>): string;
+//# sourceMappingURL=loader.d.ts.map

package/dist/skills/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/skills/loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAgC,MAAM,YAAY,CAAC;AAwGtE;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAiBxC;AAID,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,KAAK,GAAG,IAAI,CAoCtF;AAaD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,CAa3D;AAED,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAErF"}

package/dist/skills/loader.js

@@ -0,0 +1,194 @@
+import { readdirSync, readFileSync, mkdirSync, copyFileSync, constants as fsConstants } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { HELIOS_DIR } from "../paths.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/** Directory for bundled skills (lives next to compiled JS). */
+const BUNDLED_DIR = join(__dirname, "bundled");
+/** User-global skills — bundled skills are seeded here on first launch. */
+const USER_DIR = join(HELIOS_DIR, "skills");
+// ─── Frontmatter parser (no yaml dependency needed) ──
+function parseFrontmatter(raw) {
+    const match = raw.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
+    if (!match)
+        return null;
+    const meta = {};
+    let currentKey = null;
+    let currentValue = "";
+    let inBlock = false;
+    let blockIndent = 0;
+    for (const line of match[1].split("\n")) {
+        // Continuation of a block (indented sub-keys or list items)
+        if (inBlock && currentKey) {
+            const indent = line.search(/\S/);
+            if (indent > blockIndent || line.trim() === "") {
+                currentValue += "\n" + line;
+                continue;
+            }
+            // Block ended — flush
+            meta[currentKey] = parseYamlValue(currentValue.trim(), true);
+            inBlock = false;
+            currentKey = null;
+            currentValue = "";
+        }
+        const kvMatch = line.match(/^(\w[\w-]*)\s*:\s*(.*)$/);
+        if (!kvMatch)
+            continue;
+        const [, key, rest] = kvMatch;
+        const trimmed = rest.trim();
+        if (trimmed === "" || trimmed.startsWith("\n")) {
+            // Block value starts on next line
+            currentKey = key;
+            currentValue = "";
+            inBlock = true;
+            blockIndent = key.length + 1;
+        }
+        else {
+            meta[key] = parseYamlValue(trimmed, false);
+        }
+    }
+    // Flush trailing block
+    if (inBlock && currentKey) {
+        meta[currentKey] = parseYamlValue(currentValue.trim(), true);
+    }
+    return { meta, body: match[2].trim() };
+}
+function parseYamlValue(raw, isBlock) {
+    // Inline list: [a, b, c]
+    const listMatch = raw.match(/^\[([^\]]*)\]$/);
+    if (listMatch) {
+        return listMatch[1].split(",").map((s) => s.trim()).filter(Boolean);
+    }
+    // Block list (each line starts with "- ")
+    if (isBlock && raw.includes("\n")) {
+        const lines = raw.split("\n");
+        // Check if it's a list
+        if (lines.every((l) => l.trim().startsWith("- ") || l.trim() === "")) {
+            return lines
+                .map((l) => l.trim())
+                .filter((l) => l.startsWith("- "))
+                .map((l) => l.slice(2).trim());
+        }
+        // Check if it's a nested object
+        const obj = {};
+        for (const l of lines) {
+            const m = l.trim().match(/^(\w[\w-]*)\s*:\s*(.*)$/);
+            if (m)
+                obj[m[1]] = parseYamlValue(m[2].trim(), false);
+        }
+        if (Object.keys(obj).length > 0)
+            return obj;
+        return raw;
+    }
+    // Null
+    if (raw === "null" || raw === "~")
+        return null;
+    // Boolean
+    if (raw === "true")
+        return true;
+    if (raw === "false")
+        return false;
+    // Number
+    if (/^-?\d+(\.\d+)?$/.test(raw))
+        return Number(raw);
+    // Quoted string
+    if ((raw.startsWith('"') && raw.endsWith('"')) || (raw.startsWith("'") && raw.endsWith("'"))) {
+        return raw.slice(1, -1);
+    }
+    return raw;
+}
+// ─── Skill seeding ──────────────────────────────────
+/**
+ * Copy bundled skills to ~/.helios/skills/ if they don't already exist.
+ * Called on first launch (or upgrade when new skills are added).
+ * Never overwrites user-edited files.
+ */
+export function seedBundledSkills() {
+    let files;
+    try {
+        files = readdirSync(BUNDLED_DIR).filter((f) => f.endsWith(".md"));
+    }
+    catch {
+        return; // No bundled dir
+    }
+    mkdirSync(USER_DIR, { recursive: true });
+    for (const file of files) {
+        try {
+            copyFileSync(join(BUNDLED_DIR, file), join(USER_DIR, file), fsConstants.COPYFILE_EXCL);
+        }
+        catch {
+            // Already exists — don't overwrite user edits
+        }
+    }
+}
+// ─── Skill loading ───────────────────────────────────
+export function parseSkillFile(filePath, source) {
+    try {
+        const raw = readFileSync(filePath, "utf-8");
+        const parsed = parseFrontmatter(raw);
+        if (!parsed)
+            return null;
+        const { meta, body } = parsed;
+        const name = meta.name;
+        const description = meta.description;
+        if (!name || !description)
+            return null;
+        const config = {
+            name,
+            description,
+            args: meta.args,
+            model: meta.model ?? null,
+            reasoning: meta.reasoning ?? null,
+            provider: meta.provider ?? null,
+            loop: meta.loop === true,
+            delay_ms: typeof meta.delay_ms === "number" ? meta.delay_ms : undefined,
+            loop_message: meta.loop_message ?? undefined,
+        };
+        // Parse tools — can be a simple list (shorthand for allow) or object with allow/deny
+        if (meta.tools) {
+            if (Array.isArray(meta.tools)) {
+                config.tools = { allow: meta.tools };
+            }
+            else if (typeof meta.tools === "object") {
+                config.tools = meta.tools;
+            }
+        }
+        return { name, description, source, filePath, config, template: body };
+    }
+    catch {
+        return null;
+    }
+}
+function loadDir(dir, source) {
+    try {
+        return readdirSync(dir)
+            .filter((f) => f.endsWith(".md"))
+            .map((f) => parseSkillFile(join(dir, f), source))
+            .filter((s) => s !== null);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Discover all skills. Priority: project > user.
+ * Bundled skills live in USER_DIR after seeding (see seedBundledSkills).
+ * Project skills override user skills with the same name.
+ */
+export function discoverSkills(projectDir) {
+    const byName = new Map();
+    for (const skill of loadDir(USER_DIR, "user")) {
+        byName.set(skill.name, skill);
+    }
+    if (projectDir) {
+        for (const skill of loadDir(join(projectDir, ".helios", "skills"), "project")) {
+            byName.set(skill.name, skill);
+        }
+    }
+    return Array.from(byName.values());
+}
+/** Render a template with {arg} placeholders replaced. */
+export function renderTemplate(template, args) {
+    return template.replace(/\{(\w+)\}/g, (match, key) => args[key] ?? match);
+}
+//# sourceMappingURL=loader.js.map

package/dist/skills/loader.js.map

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

package/dist/skills/registry.d.ts

@@ -0,0 +1,12 @@
+import type { Skill } from "./types.js";
+export declare class SkillRegistry {
+    private skills;
+    private projectDir?;
+    constructor(projectDir?: string);
+    /** Load (or reload) all skills from user + project dirs. */
+    load(): void;
+    get(name: string): Skill | undefined;
+    list(): Skill[];
+    names(): string[];
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/skills/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/skills/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGxC,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,UAAU,CAAC,CAAS;gBAEhB,UAAU,CAAC,EAAE,MAAM;IAI/B,4DAA4D;IAC5D,IAAI,IAAI,IAAI;IAOZ,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIpC,IAAI,IAAI,KAAK,EAAE;IAIf,KAAK,IAAI,MAAM,EAAE;CAGlB"}

package/dist/skills/registry.js

@@ -0,0 +1,25 @@
+import { discoverSkills } from "./loader.js";
+export class SkillRegistry {
+    skills = new Map();
+    projectDir;
+    constructor(projectDir) {
+        this.projectDir = projectDir;
+    }
+    /** Load (or reload) all skills from user + project dirs. */
+    load() {
+        this.skills.clear();
+        for (const skill of discoverSkills(this.projectDir)) {
+            this.skills.set(skill.name, skill);
+        }
+    }
+    get(name) {
+        return this.skills.get(name);
+    }
+    list() {
+        return Array.from(this.skills.values());
+    }
+    names() {
+        return Array.from(this.skills.keys());
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/skills/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/skills/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,OAAO,aAAa;IAChB,MAAM,GAAG,IAAI,GAAG,EAAiB,CAAC;IAClC,UAAU,CAAU;IAE5B,YAAY,UAAmB;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,4DAA4D;IAC5D,IAAI;QACF,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,KAAK,MAAM,KAAK,IAAI,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACpD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK;QACH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;CACF"}

package/dist/skills/types.d.ts

@@ -0,0 +1,37 @@
+export interface SkillArgDef {
+    type: "string" | "number" | "boolean";
+    description?: string;
+    required?: boolean;
+}
+export interface SkillToolAccess {
+    allow?: string[];
+    deny?: string[];
+}
+export interface SkillConfig {
+    name: string;
+    description: string;
+    args?: Record<string, SkillArgDef>;
+    tools?: SkillToolAccess;
+    /** Override model for the sub-session (null = inherit). */
+    model?: string | null;
+    /** Override reasoning effort (null = inherit). */
+    reasoning?: string | null;
+    /** "other" routes to the non-active provider (for consult). */
+    provider?: "other" | "claude" | "openai" | null;
+    /** If true, the skill re-invokes itself in a loop until interrupted. */
+    loop?: boolean;
+    /** Delay in ms between loop iterations (default: 60000). Only meaningful when loop=true. */
+    delay_ms?: number;
+    /** Message sent on subsequent loop iterations (supports {iteration} placeholder). */
+    loop_message?: string;
+}
+export interface Skill {
+    name: string;
+    description: string;
+    source: "user" | "project";
+    filePath: string;
+    config: SkillConfig;
+    /** The prompt template (markdown body after frontmatter). */
+    template: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/skills/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAAC;IAChD,wEAAwE;IACxE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qFAAqF;IACrF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/skills/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/skills/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":""}

package/dist/store/preferences.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preferences.d.ts","sourceRoot":"","sources":["../../src/store/preferences.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACnC,cAAc,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAQD,wBAAgB,eAAe,IAAI,WAAW,CAO7C;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAQjE"}
+{"version":3,"file":"preferences.d.ts","sourceRoot":"","sources":["../../src/store/preferences.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACnC,cAAc,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,eAAe,IAAI,WAAW,CAM7C;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAQjE"}

package/dist/store/preferences.js

@@ -1,17 +1,9 @@
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
+import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
 import { join } from "node:path";
 import { HELIOS_DIR } from "../paths.js";
-const CONFIG_DIR = HELIOS_DIR;
-const PREFS_FILE = join(CONFIG_DIR, "preferences.json");
-function ensureDir() {
-    if (!existsSync(CONFIG_DIR)) {
-        mkdirSync(CONFIG_DIR, { recursive: true });
-    }
-}
+const PREFS_FILE = join(HELIOS_DIR, "preferences.json");
 export function loadPreferences() {
     try {
-        if (!existsSync(PREFS_FILE))
-            return {};
         return JSON.parse(readFileSync(PREFS_FILE, "utf-8"));
     }
     catch {
@@ -19,7 +11,7 @@ export function loadPreferences() {
     }
 }
 export function savePreferences(prefs) {
-    ensureDir();
+    mkdirSync(HELIOS_DIR, { recursive: true });
     const existing = loadPreferences();
     writeFileSync(PREFS_FILE, JSON.stringify({ ...existing, ...prefs }, null, 2), "utf-8");
 }

package/dist/store/preferences.js.map

@@ -1 +1 @@
-{"version":3,"file":"preferences.js","sourceRoot":"","sources":["../../src/store/preferences.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,GAAG,UAAU,CAAC;AAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;AASxD,SAAS,SAAS;IAChB,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,OAAO,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAA2B;IACzD,SAAS,EAAE,CAAC;IACZ,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC;IACnC,aAAa,CACX,UAAU,EACV,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAClD,OAAO,CACR,CAAC;AACJ,CAAC"}
+{"version":3,"file":"preferences.js","sourceRoot":"","sources":["../../src/store/preferences.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;AASxD,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAA2B;IACzD,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC;IACnC,aAAa,CACX,UAAU,EACV,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAClD,OAAO,CACR,CAAC;AACJ,CAAC"}

package/dist/tools/compare-runs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compare-runs.d.ts","sourceRoot":"","sources":["../../src/tools/compare-runs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,WAAW,GACvB,cAAc,CAuFhB"}
+{"version":3,"file":"compare-runs.d.ts","sourceRoot":"","sources":["../../src/tools/compare-runs.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,WAAW,EAAE,WAAW,GACvB,cAAc,CAuFhB"}

package/dist/tools/compare-runs.js

@@ -1,3 +1,4 @@
+import { toolError } from "../ui/format.js";
 export function createCompareRunsTool(metricStore) {
     return {
         name: "compare_runs",
@@ -30,10 +31,10 @@ export function createCompareRunsTool(metricStore) {
             const summaryA = metricStore.getTaskSummary(taskA);
             const summaryB = metricStore.getTaskSummary(taskB);
             if (Object.keys(summaryA).length === 0) {
-                return JSON.stringify({ error: `No metrics found for task ${taskA}` });
+                return toolError(`No metrics found for task ${taskA}`);
             }
             if (Object.keys(summaryB).length === 0) {
-                return JSON.stringify({ error: `No metrics found for task ${taskB}` });
+                return toolError(`No metrics found for task ${taskB}`);
             }
             // Get union of metric names, optionally filtered
             const allNames = new Set([