@snoglobe/helios 0.1.0 → 0.2.1

package/dist/cli/index.js.map

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

package/dist/cli/init-cmd.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `helios init` — initialize a project with a helios.json config file.
+ */
+import { Option } from "effect";
+import { Command } from "@effect/cli";
+export declare const initCmd: Command.Command<"init", never, never, {
+    readonly provider: Option.Option<"claude" | "openai">;
+    readonly model: Option.Option<string>;
+    readonly machine: Option.Option<string>;
+}>;
+//# sourceMappingURL=init-cmd.d.ts.map

package/dist/cli/init-cmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-cmd.d.ts","sourceRoot":"","sources":["../../src/cli/init-cmd.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,OAAO,EAAW,MAAM,aAAa,CAAC;AAoB/C,eAAO,MAAM,OAAO;;;;EAkCnB,CAAC"}

package/dist/cli/init-cmd.js

@@ -0,0 +1,37 @@
+/**
+ * `helios init` — initialize a project with a helios.json config file.
+ */
+import { Effect, Option } from "effect";
+import { Command, Options } from "@effect/cli";
+const providerOpt = Options.choice("provider", ["claude", "openai"]).pipe(Options.withAlias("P"), Options.withDescription("Default provider for this project"), Options.optional);
+const modelOpt = Options.text("model").pipe(Options.withAlias("m"), Options.withDescription("Default model for this project"), Options.optional);
+const machineOpt = Options.text("machine").pipe(Options.withDescription("Default machine for experiments"), Options.optional);
+export const initCmd = Command.make("init", { provider: providerOpt, model: modelOpt, machine: machineOpt }, ({ provider, model, machine }) => Effect.promise(async () => {
+    const { existsSync } = await import("node:fs");
+    const { join } = await import("node:path");
+    const { writeProjectConfig } = await import("../config/project.js");
+    const dir = process.cwd();
+    const configPath = join(dir, "helios.json");
+    if (existsSync(configPath)) {
+        console.log(`helios.json already exists in ${dir}`);
+        console.log("Edit it directly or delete it and re-run 'helios init'.");
+        return;
+    }
+    const config = {};
+    if (Option.isSome(provider))
+        config.provider = provider.value;
+    if (Option.isSome(model))
+        config.model = model.value;
+    if (Option.isSome(machine))
+        config.defaultMachine = machine.value;
+    // Sensible defaults
+    config.metricNames = ["loss", "acc", "lr"];
+    writeProjectConfig(dir, config);
+    console.log(`Created helios.json in ${dir}`);
+    console.log("\nEdit it to configure:");
+    console.log("  - provider/model defaults");
+    console.log("  - metric names and patterns to track");
+    console.log("  - notification channels (desktop, webhook, command)");
+    console.log("  - project-specific agent instructions");
+}));
+//# sourceMappingURL=init-cmd.js.map

package/dist/cli/init-cmd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-cmd.js","sourceRoot":"","sources":["../../src/cli/init-cmd.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG/C,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CACvE,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,eAAe,CAAC,mCAAmC,CAAC,EAC5D,OAAO,CAAC,QAAQ,CACjB,CAAC;AAEF,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CACzC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,eAAe,CAAC,gCAAgC,CAAC,EACzD,OAAO,CAAC,QAAQ,CACjB,CAAC;AAEF,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAC7C,OAAO,CAAC,eAAe,CAAC,iCAAiC,CAAC,EAC1D,OAAO,CAAC,QAAQ,CACjB,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CACjC,MAAM,EACN,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,EAC/D,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAC/B,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE;IACxB,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;IAC3C,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;IAEpE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IAE5C,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,iCAAiC,GAAG,EAAE,CAAC,CAAC;QACpD,OAAO,CAAC,GAAG,CAAC,yDAAyD,CAAC,CAAC;QACvE,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;QAAE,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC,KAA4B,CAAC;IACrF,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IACrD,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;QAAE,MAAM,CAAC,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;IAElE,oBAAoB;IACpB,MAAM,CAAC,WAAW,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAE3C,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,CAAC,GAAG,CAAC,0BAA0B,GAAG,EAAE,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IACvC,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;IAC3C,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;IACtD,OAAO,CAAC,GAAG,CAAC,uDAAuD,CAAC,CAAC;IACrE,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;AACzD,CAAC,CAAC,CACL,CAAC"}

package/dist/cli/kill.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `helios kill <machine:pid>` — kill a running task from the CLI.
+ */
+import { Command } from "@effect/cli";
+export declare const kill: Command.Command<"kill", never, never, {
+    readonly target: string;
+}>;
+//# sourceMappingURL=kill.d.ts.map

package/dist/cli/kill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kill.d.ts","sourceRoot":"","sources":["../../src/cli/kill.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,OAAO,EAAQ,MAAM,aAAa,CAAC;AAM5C,eAAO,MAAM,IAAI;;EAgDhB,CAAC"}

package/dist/cli/kill.js

@@ -0,0 +1,46 @@
+/**
+ * `helios kill <machine:pid>` — kill a running task from the CLI.
+ */
+import { Effect } from "effect";
+import { Command, Args } from "@effect/cli";
+const target = Args.text({ name: "machine:pid" }).pipe(Args.withDescription("Task to kill, e.g. 'local:12345'"));
+export const kill = Command.make("kill", { target }, ({ target }) => Effect.promise(async () => {
+    const [machineId, pidStr] = target.split(":");
+    const pid = parseInt(pidStr, 10);
+    if (!machineId || isNaN(pid)) {
+        console.error("Usage: helios kill <machine_id:pid>");
+        process.exit(1);
+    }
+    const { createRuntime } = await import("../init.js");
+    const runtime = await createRuntime();
+    const { connectionPool, executor } = runtime;
+    // Check if running
+    const running = await connectionPool.isProcessRunning(machineId, pid);
+    if (!running) {
+        console.log(`Process ${machineId}:${pid} is not running.`);
+        runtime.cleanup();
+        return;
+    }
+    // Kill it
+    const result = await connectionPool.exec(machineId, `kill ${pid} 2>/dev/null && echo killed || echo failed`);
+    const outcome = result.stdout.trim();
+    if (outcome === "killed") {
+        console.log(`Killed ${machineId}:${pid}`);
+        // Clean up from executor tracking
+        const key = `${machineId}:${pid}`;
+        executor.removeBackgroundProcess(key);
+    }
+    else {
+        // Try SIGKILL
+        const force = await connectionPool.exec(machineId, `kill -9 ${pid} 2>/dev/null && echo killed || echo failed`);
+        if (force.stdout.trim() === "killed") {
+            console.log(`Force-killed ${machineId}:${pid} (SIGKILL)`);
+            executor.removeBackgroundProcess(`${machineId}:${pid}`);
+        }
+        else {
+            console.error(`Failed to kill ${machineId}:${pid}. Check permissions.`);
+        }
+    }
+    runtime.cleanup();
+}));
+//# sourceMappingURL=kill.js.map

package/dist/cli/kill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kill.js","sourceRoot":"","sources":["../../src/cli/kill.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC,IAAI,CACpD,IAAI,CAAC,eAAe,CAAC,kCAAkC,CAAC,CACzD,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAC9B,MAAM,EACN,EAAE,MAAM,EAAE,EACV,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CACb,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE;IACxB,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACjC,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,MAAM,aAAa,EAAE,CAAC;IAEtC,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAE7C,mBAAmB;IACnB,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,gBAAgB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACtE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,WAAW,SAAS,IAAI,GAAG,kBAAkB,CAAC,CAAC;QAC3D,OAAO,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO;IACT,CAAC;IAED,UAAU;IACV,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,GAAG,4CAA4C,CAAC,CAAC;IAC7G,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAErC,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,UAAU,SAAS,IAAI,GAAG,EAAE,CAAC,CAAC;QAE1C,kCAAkC;QAClC,MAAM,GAAG,GAAG,GAAG,SAAS,IAAI,GAAG,EAAE,CAAC;QAClC,QAAQ,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC;IACxC,CAAC;SAAM,CAAC;QACN,cAAc;QACd,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,GAAG,4CAA4C,CAAC,CAAC;QAC/G,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,QAAQ,EAAE,CAAC;YACrC,OAAO,CAAC,GAAG,CAAC,gBAAgB,SAAS,IAAI,GAAG,YAAY,CAAC,CAAC;YAC1D,QAAQ,CAAC,uBAAuB,CAAC,GAAG,SAAS,IAAI,GAAG,EAAE,CAAC,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,kBAAkB,SAAS,IAAI,GAAG,sBAAsB,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED,OAAO,CAAC,OAAO,EAAE,CAAC;AACpB,CAAC,CAAC,CACL,CAAC"}

package/dist/cli/options.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Shared CLI options used across commands.
+ */
+import { Options, Args } from "@effect/cli";
+export declare const provider: Options.Options<import("effect/Option").Option<"claude" | "openai">>;
+export declare const claudeMode: Options.Options<import("effect/Option").Option<"cli" | "api">>;
+export declare const model: Options.Options<import("effect/Option").Option<string>>;
+export declare const continueSession: Options.Options<boolean>;
+export declare const resumeSession: Options.Options<import("effect/Option").Option<string>>;
+export declare const print: Options.Options<boolean>;
+export declare const headless: Options.Options<boolean>;
+export declare const home: Options.Options<import("effect/Option").Option<string>>;
+export declare const hubUrl: Options.Options<import("effect/Option").Option<string>>;
+export declare const hubKey: Options.Options<import("effect/Option").Option<string>>;
+export declare const agent: Options.Options<import("effect/Option").Option<string>>;
+export declare const files: Options.Options<string[]>;
+export declare const prompt: Args.Args<import("effect/Option").Option<string>>;
+//# sourceMappingURL=options.d.ts.map

package/dist/cli/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/cli/options.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAI5C,eAAO,MAAM,QAAQ,sEAIpB,CAAC;AAEF,eAAO,MAAM,UAAU,gEAGtB,CAAC;AAEF,eAAO,MAAM,KAAK,yDAIjB,CAAC;AAIF,eAAO,MAAM,eAAe,0BAI3B,CAAC;AAEF,eAAO,MAAM,aAAa,yDAIzB,CAAC;AAIF,eAAO,MAAM,KAAK,0BAIjB,CAAC;AAEF,eAAO,MAAM,QAAQ,0BAGpB,CAAC;AAIF,eAAO,MAAM,IAAI,yDAGhB,CAAC;AAEF,eAAO,MAAM,MAAM,yDAGlB,CAAC;AAEF,eAAO,MAAM,MAAM,yDAGlB,CAAC;AAEF,eAAO,MAAM,KAAK,yDAGjB,CAAC;AAIF,eAAO,MAAM,KAAK,2BAIjB,CAAC;AAIF,eAAO,MAAM,MAAM,mDAGlB,CAAC"}

package/dist/cli/options.js

@@ -0,0 +1,24 @@
+/**
+ * Shared CLI options used across commands.
+ */
+import { Options, Args } from "@effect/cli";
+// ── Provider & model ─────────────────────────────────────
+export const provider = Options.choice("provider", ["claude", "openai"]).pipe(Options.withAlias("P"), Options.withDescription("Model provider"), Options.optional);
+export const claudeMode = Options.choice("claude-mode", ["cli", "api"]).pipe(Options.withDescription("Force Claude auth mode (cli or api)"), Options.optional);
+export const model = Options.text("model").pipe(Options.withAlias("m"), Options.withDescription("Model to use"), Options.optional);
+// ── Session ──────────────────────────────────────────────
+export const continueSession = Options.boolean("continue").pipe(Options.withAlias("c"), Options.withDescription("Continue most recent conversation"), Options.withDefault(false));
+export const resumeSession = Options.text("resume").pipe(Options.withAlias("r"), Options.withDescription("Resume a conversation by session ID"), Options.optional);
+// ── Modes ────────────────────────────────────────────────
+export const print = Options.boolean("print").pipe(Options.withAlias("p"), Options.withDescription("Print response and exit (non-interactive)"), Options.withDefault(false));
+export const headless = Options.boolean("headless").pipe(Options.withDescription("Compact UI — no input field"), Options.withDefault(false));
+// ── Paths & hub ──────────────────────────────────────────
+export const home = Options.directory("home").pipe(Options.withDescription("Data directory (default: ~/.helios)"), Options.optional);
+export const hubUrl = Options.text("hub-url").pipe(Options.withDescription("AgentHub server URL"), Options.optional);
+export const hubKey = Options.text("hub-key").pipe(Options.withDescription("AgentHub API key"), Options.optional);
+export const agent = Options.text("agent").pipe(Options.withDescription("Agent identity on AgentHub"), Options.optional);
+// ── Attachments ─────────────────────────────────────────
+export const files = Options.text("file").pipe(Options.withAlias("f"), Options.withDescription("Attach a file (PDF, image). Can be repeated."), Options.repeated);
+// ── Positional ───────────────────────────────────────────
+export const prompt = Args.text({ name: "prompt" }).pipe(Args.withDescription("Initial prompt to send"), Args.optional);
+//# sourceMappingURL=options.js.map

package/dist/cli/options.js.map

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

package/dist/cli/replay.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `helios replay <session-id>` — read-only playback of a session's conversation.
+ */
+import { Command } from "@effect/cli";
+export declare const replay: Command.Command<"replay", never, never, {
+    readonly sessionId: string;
+    readonly raw: boolean;
+}>;
+//# sourceMappingURL=replay.d.ts.map

package/dist/cli/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../src/cli/replay.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,OAAO,EAAiB,MAAM,aAAa,CAAC;AAWrD,eAAO,MAAM,MAAM;;;EAmElB,CAAC"}

package/dist/cli/replay.js

@@ -0,0 +1,65 @@
+/**
+ * `helios replay <session-id>` — read-only playback of a session's conversation.
+ */
+import { Effect } from "effect";
+import { Command, Args, Options } from "@effect/cli";
+const sessionId = Args.text({ name: "session-id" }).pipe(Args.withDescription("Session ID to replay (use 'helios sessions' to find IDs)"));
+const raw = Options.boolean("raw").pipe(Options.withDescription("Output raw text without formatting"), Options.withDefault(false));
+export const replay = Command.make("replay", { sessionId, raw }, ({ sessionId, raw }) => Effect.promise(async () => {
+    const { SessionStore } = await import("../store/session-store.js");
+    const store = new SessionStore(process.env.AGENTHUB_AGENT ?? "");
+    const session = store.getSession(sessionId);
+    if (!session) {
+        console.error(`Session "${sessionId}" not found. Use 'helios sessions' to list sessions.`);
+        process.exit(1);
+    }
+    const messages = store.getMessages(sessionId, 10000);
+    if (messages.length === 0) {
+        console.log("Session has no messages.");
+        return;
+    }
+    const date = new Date(session.createdAt).toLocaleString();
+    const provider = session.providerId;
+    if (!raw) {
+        console.log(`\x1b[1m── Session ${sessionId} ──\x1b[0m`);
+        console.log(`Provider: ${provider}  |  Started: ${date}  |  Messages: ${messages.length}\n`);
+    }
+    for (const msg of messages) {
+        if (raw) {
+            console.log(`[${msg.role}] ${msg.content}`);
+            continue;
+        }
+        const time = new Date(msg.timestamp).toLocaleTimeString();
+        switch (msg.role) {
+            case "user":
+                console.log(`\x1b[33m┌─ User \x1b[2m${time}\x1b[0m`);
+                console.log(`\x1b[33m│\x1b[0m ${msg.content.split("\n").join("\n\x1b[33m│\x1b[0m ")}`);
+                console.log(`\x1b[33m└\x1b[0m`);
+                break;
+            case "assistant":
+                console.log(`\x1b[36m┌─ Helios \x1b[2m${time}\x1b[0m`);
+                // Truncate very long assistant messages for readability
+                const content = msg.content.length > 2000
+                    ? msg.content.slice(0, 2000) + `\n... (${msg.content.length - 2000} chars truncated)`
+                    : msg.content;
+                console.log(`\x1b[36m│\x1b[0m ${content.split("\n").join("\n\x1b[36m│\x1b[0m ")}`);
+                console.log(`\x1b[36m└\x1b[0m`);
+                break;
+            case "tool":
+                console.log(`\x1b[2m  ⚙ tool ${time}\x1b[0m`);
+                const preview = msg.content.length > 200
+                    ? msg.content.slice(0, 200) + "..."
+                    : msg.content;
+                console.log(`\x1b[2m    ${preview.split("\n").join("\n    ")}\x1b[0m`);
+                break;
+            case "system":
+                console.log(`\x1b[35m  ◈ system: ${msg.content}\x1b[0m`);
+                break;
+            default:
+                console.log(`\x1b[31m  ✗ ${msg.role}: ${msg.content}\x1b[0m`);
+                break;
+        }
+        console.log();
+    }
+}));
+//# sourceMappingURL=replay.js.map

package/dist/cli/replay.js.map

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

package/dist/cli/report.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `helios report [session-id]` — generate an experiment writeup from session data.
+ * Outputs markdown to stdout (pipeable: `helios report > results.md`)
+ */
+import { Option } from "effect";
+import { Command } from "@effect/cli";
+export declare const report: Command.Command<"report", never, never, {
+    readonly sessionId: Option.Option<string>;
+    readonly provider: Option.Option<"claude" | "openai">;
+}>;
+//# sourceMappingURL=report.d.ts.map

package/dist/cli/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/cli/report.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,OAAO,EAAiB,MAAM,aAAa,CAAC;AAarD,eAAO,MAAM,MAAM;;;EAyElB,CAAC"}

package/dist/cli/report.js

@@ -0,0 +1,70 @@
+/**
+ * `helios report [session-id]` — generate an experiment writeup from session data.
+ * Outputs markdown to stdout (pipeable: `helios report > results.md`)
+ */
+import { Effect, Option } from "effect";
+import { Command, Args, Options } from "@effect/cli";
+const sessionId = Args.text({ name: "session-id" }).pipe(Args.withDescription("Session ID to report on (default: most recent)"), Args.optional);
+const provider = Options.choice("provider", ["claude", "openai"]).pipe(Options.withAlias("P"), Options.withDescription("Provider to use for generating the writeup"), Options.optional);
+export const report = Command.make("report", { sessionId, provider }, ({ sessionId: sessionIdOpt, provider: providerOpt }) => Effect.promise(async () => {
+    const { SessionStore } = await import("../store/session-store.js");
+    const { createRuntime } = await import("../init.js");
+    const { buildWriteupSystemPrompt } = await import("../tools/writeup.js");
+    const agentId = process.env.AGENTHUB_AGENT ?? "";
+    const store = new SessionStore(agentId);
+    // Resolve session
+    const targetId = Option.getOrUndefined(sessionIdOpt);
+    let resolvedId;
+    if (targetId) {
+        const session = store.getSession(targetId);
+        if (!session) {
+            process.stderr.write(`Session "${targetId}" not found.\n`);
+            process.exit(1);
+        }
+        resolvedId = targetId;
+    }
+    else {
+        const sessions = store.listSessions(1);
+        if (sessions.length === 0) {
+            process.stderr.write("No sessions found.\n");
+            process.exit(1);
+        }
+        resolvedId = sessions[0].id;
+        process.stderr.write(`Using most recent session: ${resolvedId}\n`);
+    }
+    // Gather session transcript
+    const messages = store.getMessages(resolvedId, 10000);
+    if (messages.length === 0) {
+        process.stderr.write("Session has no messages.\n");
+        process.exit(1);
+    }
+    const transcript = messages
+        .map((m) => `[${m.role}] ${m.content}`)
+        .join("\n\n");
+    // Create a runtime to get a provider for the writeup
+    const providerName = Option.getOrUndefined(providerOpt);
+    const runtime = await createRuntime({ provider: providerName });
+    const activeProvider = runtime.orchestrator.currentProvider;
+    if (!activeProvider) {
+        process.stderr.write("No active provider. Authenticate first with 'helios auth login'.\n");
+        runtime.cleanup();
+        process.exit(1);
+    }
+    process.stderr.write("Generating report...\n");
+    const session = await activeProvider.createSession({
+        systemPrompt: buildWriteupSystemPrompt({ transcript: true }),
+    });
+    try {
+        for await (const event of activeProvider.send(session, transcript, [])) {
+            if (event.type === "text" && event.delta) {
+                process.stdout.write(event.delta);
+            }
+        }
+        process.stdout.write("\n");
+    }
+    finally {
+        await activeProvider.closeSession(session).catch(() => { });
+        runtime.cleanup();
+    }
+}));
+//# sourceMappingURL=report.js.map

package/dist/cli/report.js.map

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

package/dist/cli/run.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Default command — launches the interactive TUI or runs in print mode.
+ */
+import { Effect, Option } from "effect";
+export interface RunOptions {
+    provider: Option.Option<string>;
+    claudeMode: Option.Option<string>;
+    model: Option.Option<string>;
+    continueSession: boolean;
+    resumeSession: Option.Option<string>;
+    print: boolean;
+    headless: boolean;
+    files: string[];
+    prompt: Option.Option<string>;
+}
+export declare function run(opts: RunOptions): Effect.Effect<void>;
+//# sourceMappingURL=run.d.ts.map

package/dist/cli/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/cli/run.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGxC,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7B,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;CAC/B;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAuBzD"}

package/dist/cli/run.js

@@ -0,0 +1,120 @@
+/**
+ * Default command — launches the interactive TUI or runs in print mode.
+ */
+import { Effect, Option } from "effect";
+export function run(opts) {
+    return Effect.gen(function* () {
+        const providerArg = Option.getOrUndefined(opts.provider);
+        const claudeModeArg = Option.getOrUndefined(opts.claudeMode);
+        const modelArg = Option.getOrUndefined(opts.model);
+        const resumeId = Option.getOrUndefined(opts.resumeSession);
+        const promptText = Option.getOrUndefined(opts.prompt);
+        if (opts.print) {
+            yield* printMode({ provider: providerArg, claudeMode: claudeModeArg, model: modelArg, prompt: promptText, files: opts.files });
+        }
+        else {
+            yield* tuiMode({
+                provider: providerArg,
+                claudeMode: claudeModeArg,
+                model: modelArg,
+                headless: opts.headless,
+                continueSession: opts.continueSession,
+                resumeSessionId: resumeId,
+                prompt: promptText,
+                files: opts.files,
+            });
+        }
+    });
+}
+// ── File loading ────────────────────────────────────────
+const MIME_TYPES = {
+    ".pdf": "application/pdf",
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".webp": "image/webp",
+};
+const MAX_FILE_SIZE = 20 * 1024 * 1024; // 20MB
+async function loadAttachments(paths) {
+    if (paths.length === 0)
+        return [];
+    const { readFile, stat } = await import("node:fs/promises");
+    const { extname, basename } = await import("node:path");
+    return Promise.all(paths.map(async (filePath) => {
+        const ext = extname(filePath).toLowerCase();
+        const mediaType = MIME_TYPES[ext];
+        if (!mediaType) {
+            throw new Error(`Unsupported file type: ${ext} (supported: ${Object.keys(MIME_TYPES).join(", ")})`);
+        }
+        const info = await stat(filePath);
+        if (info.size > MAX_FILE_SIZE) {
+            throw new Error(`File too large: ${basename(filePath)} (${(info.size / 1024 / 1024).toFixed(0)}MB, max ${MAX_FILE_SIZE / 1024 / 1024}MB)`);
+        }
+        const data = await readFile(filePath);
+        return {
+            filename: basename(filePath),
+            mediaType,
+            data: data.toString("base64"),
+        };
+    }));
+}
+function printMode(opts) {
+    return Effect.promise(async () => {
+        if (!opts.prompt) {
+            // Read from stdin if no prompt argument
+            const chunks = [];
+            for await (const chunk of process.stdin) {
+                chunks.push(chunk);
+            }
+            opts.prompt = Buffer.concat(chunks).toString("utf-8").trim();
+        }
+        if (!opts.prompt) {
+            process.stderr.write("Error: no prompt provided. Pass a prompt as an argument or pipe via stdin.\n");
+            process.exit(1);
+        }
+        const attachments = await loadAttachments(opts.files);
+        const { createRuntime } = await import("../init.js");
+        const runtime = await createRuntime({ provider: opts.provider, claudeMode: opts.claudeMode });
+        if (opts.model) {
+            await runtime.orchestrator.setModel(opts.model);
+        }
+        try {
+            for await (const event of runtime.orchestrator.send(opts.prompt, attachments.length > 0 ? attachments : undefined)) {
+                if (event.type === "text" && event.delta) {
+                    process.stdout.write(event.delta);
+                }
+            }
+            process.stdout.write("\n");
+        }
+        finally {
+            runtime.cleanup();
+        }
+    });
+}
+function tuiMode(opts) {
+    return Effect.promise(async () => {
+        const initialPrompt = opts.prompt;
+        const attachments = await loadAttachments(opts.files);
+        // Dynamic imports to avoid pulling React into print mode
+        const { withFullScreen } = await import("fullscreen-ink");
+        const { App } = await import("../app.js");
+        const { createMouseFilter } = await import("../ui/mouse-filter.js");
+        const { createElement } = await import("react");
+        const { filteredStdin, mouseEmitter } = createMouseFilter(process.stdin);
+        const { start, waitUntilExit } = withFullScreen(createElement(App, {
+            defaultProvider: opts.provider,
+            claudeMode: opts.claudeMode,
+            mouseEmitter: opts.headless ? undefined : mouseEmitter,
+            headless: opts.headless,
+            initialPrompt,
+            initialAttachments: attachments.length > 0 ? attachments : undefined,
+            resumeSessionId: opts.resumeSessionId,
+            continueSession: opts.continueSession,
+            model: opts.model,
+        }), { exitOnCtrlC: false, stdin: filteredStdin });
+        await start();
+        await waitUntilExit();
+    });
+}
+//# sourceMappingURL=run.js.map

package/dist/cli/run.js.map

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

package/dist/cli/search.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `helios search "query"` — full-text search across all session histories.
+ */
+import { Command } from "@effect/cli";
+export declare const search: Command.Command<"search", never, never, {
+    readonly query: string;
+    readonly limit: number;
+}>;
+//# sourceMappingURL=search.d.ts.map

package/dist/cli/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/cli/search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,OAAO,EAAiB,MAAM,aAAa,CAAC;AAYrD,eAAO,MAAM,MAAM;;;EA8DlB,CAAC"}

package/dist/cli/search.js

@@ -0,0 +1,52 @@
+/**
+ * `helios search "query"` — full-text search across all session histories.
+ */
+import { Effect } from "effect";
+import { Command, Args, Options } from "@effect/cli";
+const query = Args.text({ name: "query" }).pipe(Args.withDescription("Text to search for across all sessions"));
+const limit = Options.integer("limit").pipe(Options.withAlias("n"), Options.withDescription("Max results to show"), Options.withDefault(20));
+export const search = Command.make("search", { query, limit }, ({ query, limit }) => Effect.promise(async () => {
+    const { getDb } = await import("../store/database.js");
+    const { truncate } = await import("../ui/format.js");
+    const db = getDb();
+    const agentId = process.env.AGENTHUB_AGENT ?? "";
+    // Search messages with LIKE (SQLite doesn't have full-text by default)
+    const rows = db.prepare(`SELECT m.session_id, m.role, m.content, m.timestamp, s.provider
+         FROM messages m
+         JOIN sessions s ON s.id = m.session_id
+         WHERE s.agent_id = ? AND m.content LIKE ? ESCAPE '\'
+         ORDER BY m.timestamp DESC
+         LIMIT ?`).all(agentId, `%${query.replace(/[%_]/g, "\\$&")}%`, limit);
+    if (rows.length === 0) {
+        console.log(`No results for "${query}".`);
+        return;
+    }
+    console.log(`Found ${rows.length} result${rows.length > 1 ? "s" : ""} for "${query}":\n`);
+    for (const row of rows) {
+        const time = new Date(row.timestamp).toLocaleString();
+        const roleColor = row.role === "user" ? "\x1b[33m" : row.role === "assistant" ? "\x1b[36m" : "\x1b[2m";
+        // Find the query match in context
+        const idx = row.content.toLowerCase().indexOf(query.toLowerCase());
+        const start = Math.max(0, idx - 60);
+        const end = Math.min(row.content.length, idx + query.length + 60);
+        let snippet = row.content.slice(start, end).replace(/\n/g, " ");
+        if (start > 0)
+            snippet = "..." + snippet;
+        if (end < row.content.length)
+            snippet = snippet + "...";
+        // Highlight the match
+        const matchIdx = snippet.toLowerCase().indexOf(query.toLowerCase());
+        if (matchIdx >= 0) {
+            snippet =
+                snippet.slice(0, matchIdx) +
+                    "\x1b[43m\x1b[30m" +
+                    snippet.slice(matchIdx, matchIdx + query.length) +
+                    "\x1b[0m" +
+                    snippet.slice(matchIdx + query.length);
+        }
+        console.log(`${roleColor}${row.role}\x1b[0m  \x1b[2m${time}  session:${row.session_id.slice(0, 8)}\x1b[0m`);
+        console.log(`  ${snippet}`);
+        console.log();
+    }
+}));
+//# sourceMappingURL=search.js.map

package/dist/cli/search.js.map

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

package/dist/cli/sessions.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `helios sessions` — list recent sessions.
+ */
+import { Command } from "@effect/cli";
+export declare const sessions: Command.Command<"sessions", never, never, {
+    readonly limit: number;
+}>;
+//# sourceMappingURL=sessions.d.ts.map

package/dist/cli/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../src/cli/sessions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,OAAO,EAAW,MAAM,aAAa,CAAC;AAQ/C,eAAO,MAAM,QAAQ;;EA4CpB,CAAC"}