@snoglobe/helios 0.1.0 → 0.2.0

package/dist/metrics/store.js

@@ -1,17 +1,21 @@
 import { getDb } from "../store/database.js";
 export class MetricStore {
+    agentId;
+    constructor(agentId = "") {
+        this.agentId = agentId;
+    }
     insert(taskId, machineId, point) {
         const db = getDb();
-        db.prepare(`INSERT INTO metrics (task_id, machine_id, metric_name, value, step, timestamp)
-       VALUES (?, ?, ?, ?, ?, ?)`).run(taskId, machineId, point.metricName, point.value, point.step ?? null, point.timestamp);
+        db.prepare(`INSERT INTO metrics (task_id, machine_id, metric_name, value, step, timestamp, agent_id)
+       VALUES (?, ?, ?, ?, ?, ?, ?)`).run(taskId, machineId, point.metricName, point.value, point.step ?? null, point.timestamp, this.agentId);
     }
     insertBatch(taskId, machineId, points) {
         const db = getDb();
-        const stmt = db.prepare(`INSERT INTO metrics (task_id, machine_id, metric_name, value, step, timestamp)
-       VALUES (?, ?, ?, ?, ?, ?)`);
+        const stmt = db.prepare(`INSERT INTO metrics (task_id, machine_id, metric_name, value, step, timestamp, agent_id)
+       VALUES (?, ?, ?, ?, ?, ?, ?)`);
         const insertMany = db.transaction((pts) => {
             for (const p of pts) {
-                stmt.run(taskId, machineId, p.metricName, p.value, p.step ?? null, p.timestamp);
+                stmt.run(taskId, machineId, p.metricName, p.value, p.step ?? null, p.timestamp, this.agentId);
             }
         });
         insertMany(points);
@@ -20,9 +24,9 @@ export class MetricStore {
         const db = getDb();
         const row = db
             .prepare(`SELECT * FROM metrics
-         WHERE task_id = ? AND metric_name = ?
+         WHERE task_id = ? AND metric_name = ? AND agent_id = ?
          ORDER BY timestamp DESC LIMIT 1`)
-            .get(taskId, metricName);
+            .get(taskId, metricName, this.agentId);
         if (!row)
             return null;
         return {
@@ -37,11 +41,11 @@ export class MetricStore {
         const rows = db
             .prepare(`SELECT * FROM (
            SELECT * FROM metrics
-           WHERE task_id = ? AND metric_name = ?
+           WHERE task_id = ? AND metric_name = ? AND agent_id = ?
            ORDER BY timestamp DESC
            LIMIT ?
          ) ORDER BY timestamp ASC`)
-            .all(taskId, metricName, limit);
+            .all(taskId, metricName, this.agentId, limit);
         return rows.map((row) => ({
             metricName: row.metric_name,
             value: row.value,
@@ -52,24 +56,24 @@ export class MetricStore {
     getMetricNames(taskId) {
         const db = getDb();
         const rows = db
-            .prepare(`SELECT DISTINCT metric_name FROM metrics WHERE task_id = ?`)
-            .all(taskId);
+            .prepare(`SELECT DISTINCT metric_name FROM metrics WHERE task_id = ? AND agent_id = ?`)
+            .all(taskId, this.agentId);
         return rows.map((r) => r.metric_name);
     }
     /** Get all distinct task IDs that have metrics */
     getTaskIds() {
         const db = getDb();
         const rows = db
-            .prepare("SELECT DISTINCT task_id FROM metrics")
-            .all();
+            .prepare("SELECT DISTINCT task_id FROM metrics WHERE agent_id = ?")
+            .all(this.agentId);
         return rows.map((r) => r.task_id);
     }
-    /** Get all metric names across all tasks */
+    /** Get all metric names across all tasks for this agent */
     getAllMetricNames() {
         const db = getDb();
         const rows = db
-            .prepare("SELECT DISTINCT metric_name FROM metrics")
-            .all();
+            .prepare("SELECT DISTINCT metric_name FROM metrics WHERE agent_id = ?")
+            .all(this.agentId);
         return rows.map((r) => r.metric_name);
     }
     /** Get series for a metric name across all tasks, merged by timestamp */
@@ -78,11 +82,11 @@ export class MetricStore {
         const rows = db
             .prepare(`SELECT * FROM (
            SELECT * FROM metrics
-           WHERE metric_name = ?
+           WHERE metric_name = ? AND agent_id = ?
            ORDER BY timestamp DESC
            LIMIT ?
          ) ORDER BY timestamp ASC`)
-            .all(metricName, limit);
+            .all(metricName, this.agentId, limit);
         return rows.map((row) => ({
             metricName: row.metric_name,
             value: row.value,
@@ -90,19 +94,43 @@ export class MetricStore {
             timestamp: row.timestamp,
         }));
     }
+    /** Get recent series for ALL metric names in a single query. Returns a map of name → values. */
+    getAllSeries(limit = 50) {
+        const db = getDb();
+        // Get the most recent `limit` points per metric name
+        const rows = db
+            .prepare(`SELECT metric_name, value FROM (
+           SELECT metric_name, value, timestamp,
+             ROW_NUMBER() OVER (PARTITION BY metric_name ORDER BY timestamp DESC) AS rn
+           FROM metrics
+           WHERE agent_id = ?
+         ) WHERE rn <= ?
+         ORDER BY metric_name, timestamp ASC`)
+            .all(this.agentId, limit);
+        const result = new Map();
+        for (const row of rows) {
+            let arr = result.get(row.metric_name);
+            if (!arr) {
+                arr = [];
+                result.set(row.metric_name, arr);
+            }
+            arr.push(row.value);
+        }
+        return result;
+    }
     /** Get a summary of final metrics for a task (latest value of each metric) */
     getTaskSummary(taskId) {
         const db = getDb();
         const rows = db
             .prepare(`SELECT metric_name,
-                (SELECT value FROM metrics m2 WHERE m2.task_id = m1.task_id AND m2.metric_name = m1.metric_name ORDER BY timestamp DESC LIMIT 1) as latest,
+                (SELECT value FROM metrics m2 WHERE m2.task_id = m1.task_id AND m2.metric_name = m1.metric_name AND m2.agent_id = ? ORDER BY timestamp DESC LIMIT 1) as latest,
                 MIN(value) as min_val,
                 MAX(value) as max_val,
                 COUNT(*) as cnt
          FROM metrics m1
-         WHERE task_id = ?
+         WHERE task_id = ? AND agent_id = ?
          GROUP BY metric_name`)
-            .all(taskId);
+            .all(this.agentId, taskId, this.agentId);
         const summary = {};
         for (const row of rows) {
             summary[row.metric_name] = {
@@ -118,23 +146,59 @@ export class MetricStore {
     clearTask(taskId) {
         const db = getDb();
         const result = db
-            .prepare("DELETE FROM metrics WHERE task_id = ?")
-            .run(taskId);
+            .prepare("DELETE FROM metrics WHERE task_id = ? AND agent_id = ?")
+            .run(taskId, this.agentId);
         return result.changes;
     }
-    /** Delete all metrics */
+    /** Delete all metrics for this agent */
     clear() {
         const db = getDb();
-        const result = db.prepare("DELETE FROM metrics").run();
+        const result = db
+            .prepare("DELETE FROM metrics WHERE agent_id = ?")
+            .run(this.agentId);
         return result.changes;
     }
+    /** Get latest value for every metric of a given task in a single query. */
+    getLatestAll(taskId) {
+        const db = getDb();
+        const rows = db
+            .prepare(`SELECT metric_name, value FROM metrics m1
+         WHERE task_id = ? AND agent_id = ?
+           AND timestamp = (
+             SELECT MAX(timestamp) FROM metrics m2
+             WHERE m2.task_id = m1.task_id AND m2.metric_name = m1.metric_name AND m2.agent_id = m1.agent_id
+           )`)
+            .all(taskId, this.agentId);
+        const result = {};
+        for (const row of rows) {
+            result[row.metric_name] = row.value;
+        }
+        return result;
+    }
+    /** Get the latest value for every metric name across all tasks in one query. */
+    getLatestPerMetric() {
+        const db = getDb();
+        const rows = db
+            .prepare(`SELECT metric_name, value FROM metrics m1
+         WHERE agent_id = ?
+           AND timestamp = (
+             SELECT MAX(timestamp) FROM metrics m2
+             WHERE m2.metric_name = m1.metric_name AND m2.agent_id = m1.agent_id
+           )`)
+            .all(this.agentId);
+        const result = {};
+        for (const row of rows) {
+            result[row.metric_name] = row.value;
+        }
+        return result;
+    }
     /** Clean up metrics older than retentionDays */
     cleanup(retentionDays) {
         const db = getDb();
         const cutoff = Date.now() - retentionDays * 24 * 60 * 60 * 1000;
         const result = db
-            .prepare("DELETE FROM metrics WHERE timestamp < ?")
-            .run(cutoff);
+            .prepare("DELETE FROM metrics WHERE timestamp < ? AND agent_id = ?")
+            .run(cutoff, this.agentId);
         return result.changes;
     }
 }

package/dist/metrics/store.js.map

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

package/dist/notifications/index.d.ts

@@ -0,0 +1,2 @@
+export { Notifier, type NotificationChannel, type NotificationConfig, type NotificationPayload, } from "./notifier.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/notifications/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,eAAe,CAAC"}

package/dist/notifications/index.js

@@ -0,0 +1,2 @@
+export { Notifier, } from "./notifier.js";
+//# sourceMappingURL=index.js.map

package/dist/notifications/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,GAIT,MAAM,eAAe,CAAC"}

package/dist/notifications/notifier.d.ts

@@ -0,0 +1,36 @@
+export type NotificationChannel = {
+    type: "desktop";
+} | {
+    type: "webhook";
+    url: string;
+    method?: "GET" | "POST";
+    headers?: Record<string, string>;
+} | {
+    type: "command";
+    command: string;
+};
+export interface NotificationConfig {
+    channels: NotificationChannel[];
+    /** Only send notifications for these events. If empty, send all. */
+    events?: ("task_complete" | "task_failed" | "metric_threshold" | "agent_idle")[];
+}
+export interface NotificationPayload {
+    event: string;
+    title: string;
+    body: string;
+    machineId?: string;
+    pid?: number;
+    metrics?: Record<string, number>;
+    timestamp: number;
+}
+export declare class Notifier {
+    private config;
+    constructor(config: NotificationConfig);
+    notify(payload: NotificationPayload): Promise<void>;
+    notifyAll(payload: NotificationPayload): Promise<void>;
+    private sendToChannel;
+    private sendDesktop;
+    private sendWebhook;
+    private sendCommand;
+}
+//# sourceMappingURL=notifier.d.ts.map

package/dist/notifications/notifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifier.d.ts","sourceRoot":"","sources":["../../src/notifications/notifier.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAC3F;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,oEAAoE;IACpE,MAAM,CAAC,EAAE,CAAC,eAAe,GAAG,aAAa,GAAG,kBAAkB,GAAG,YAAY,CAAC,EAAE,CAAC;CAClF;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAqB;gBAEvB,MAAM,EAAE,kBAAkB;IAIhC,MAAM,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnD,SAAS,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;YAW9C,aAAa;IAuB3B,OAAO,CAAC,WAAW;YAuBL,WAAW;IAkCzB,OAAO,CAAC,WAAW;CA0BpB"}

package/dist/notifications/notifier.js

@@ -0,0 +1,102 @@
+import { exec } from "node:child_process";
+import { shellQuote, formatError } from "../ui/format.js";
+export class Notifier {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async notify(payload) {
+        const sends = this.config.channels.map((channel) => this.sendToChannel(channel, payload));
+        await Promise.allSettled(sends);
+    }
+    async notifyAll(payload) {
+        if (this.config.events &&
+            this.config.events.length > 0 &&
+            !this.config.events.includes(payload.event)) {
+            return;
+        }
+        await this.notify(payload);
+    }
+    async sendToChannel(channel, payload) {
+        try {
+            switch (channel.type) {
+                case "desktop":
+                    await this.sendDesktop(payload);
+                    break;
+                case "webhook":
+                    await this.sendWebhook(channel, payload);
+                    break;
+                case "command":
+                    await this.sendCommand(channel, payload);
+                    break;
+            }
+        }
+        catch (err) {
+            process.stderr.write(`[helios] notification error (${channel.type}): ${formatError(err)}\n`);
+        }
+    }
+    sendDesktop(payload) {
+        let cmd;
+        if (process.platform === "darwin") {
+            // AppleScript strings use backslash-escaped double quotes
+            const escapeAS = (s) => s.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\n/g, " ");
+            const script = `display notification "${escapeAS(payload.body)}" with title "${escapeAS(payload.title)}"`;
+            cmd = `osascript -e ${shellQuote(script)}`;
+        }
+        else {
+            cmd = `notify-send ${shellQuote(payload.title)} ${shellQuote(payload.body)}`;
+        }
+        return new Promise((resolve) => {
+            exec(cmd, (err) => {
+                if (err) {
+                    process.stderr.write(`[helios] desktop notification error: ${err.message}\n`);
+                }
+                resolve();
+            });
+        });
+    }
+    async sendWebhook(channel, payload) {
+        const method = channel.method ?? "POST";
+        const headers = {
+            "Content-Type": "application/json",
+            ...channel.headers,
+        };
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 10_000);
+        try {
+            const options = {
+                method,
+                headers,
+                signal: controller.signal,
+            };
+            if (method === "POST") {
+                options.body = JSON.stringify(payload);
+            }
+            await fetch(channel.url, options);
+        }
+        catch (err) {
+            process.stderr.write(`[helios] webhook error (${channel.url}): ${formatError(err)}\n`);
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    sendCommand(channel, payload) {
+        return new Promise((resolve) => {
+            exec(channel.command, {
+                env: {
+                    ...process.env,
+                    HELIOS_EVENT: payload.event,
+                    HELIOS_TITLE: payload.title,
+                    HELIOS_BODY: payload.body,
+                },
+            }, (err) => {
+                if (err) {
+                    process.stderr.write(`[helios] command notification error: ${err.message}\n`);
+                }
+                resolve();
+            });
+        });
+    }
+}
+//# sourceMappingURL=notifier.js.map

package/dist/notifications/notifier.js.map

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

package/dist/paths.d.ts

@@ -0,0 +1,3 @@
+/** Root config/data directory. Override with HELIOS_HOME env var. */
+export declare const HELIOS_DIR: string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAGA,qEAAqE;AACrE,eAAO,MAAM,UAAU,QAAwD,CAAC"}

package/dist/paths.js

@@ -0,0 +1,5 @@
+import { join } from "node:path";
+import { homedir } from "node:os";
+/** Root config/data directory. Override with HELIOS_HOME env var. */
+export const HELIOS_DIR = process.env.HELIOS_HOME ?? join(homedir(), ".helios");
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,qEAAqE;AACrE,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC"}

package/dist/providers/claude/provider.d.ts

@@ -1,5 +1,6 @@
-import { type ModelProvider, type ModelInfo, type ToolDefinition, type Session, type SessionConfig, type AgentEvent, type ReasoningEffort } from "../types.js";
+import { type ModelProvider, type ModelInfo, type ToolDefinition, type Session, type SessionConfig, type AgentEvent, type ReasoningEffort, type Attachment } from "../types.js";
 import type { AuthManager } from "../auth/auth-manager.js";
+import { SessionStore } from "../../store/session-store.js";
 type AuthMode = "cli" | "api_key";
 export declare class ClaudeProvider implements ModelProvider {
     readonly name: "claude";
@@ -17,7 +18,7 @@ export declare class ClaudeProvider implements ModelProvider {
     private systemPrompts;
     private cliPendingByName;
     private cliToolResults;
-    constructor(authManager: AuthManager, preferredMode?: "cli" | "api");
+    constructor(authManager: AuthManager, preferredMode?: "cli" | "api", sessionStore?: SessionStore);
     get currentAuthMode(): AuthMode;
     /** Force a specific auth mode. Re-authenticates on next send. */
     setPreferredAuthMode(mode: "cli" | "api"): void;
@@ -25,7 +26,7 @@ export declare class ClaudeProvider implements ModelProvider {
     authenticate(): Promise<void>;
     createSession(config: SessionConfig): Promise<Session>;
     resumeSession(id: string): Promise<Session>;
-    send(session: Session, message: string, tools: ToolDefinition[]): AsyncGenerator<AgentEvent>;
+    send(session: Session, message: string, tools: ToolDefinition[], attachments?: Attachment[]): AsyncGenerator<AgentEvent>;
     interrupt(_session: Session): void;
     resetHistory(session: Session, briefingMessage: string): void;
     closeSession(session: Session): Promise<void>;
@@ -33,9 +34,12 @@ export declare class ClaudeProvider implements ModelProvider {
     private sendViaCli;
     private doSendViaCli;
     private sendViaRawApi;
+    /** Remove attachment content blocks from history so they aren't re-sent to the API. */
+    private stripAttachmentData;
     private streamRawApi;
     /** Strip the MCP server prefix (e.g. "mcp__helios__remote_exec" → "remote_exec") */
     private stripMcpPrefix;
+    private _cliAvailable;
     private isClaudeCliAvailable;
     private buildMcpServer;
     private buildZodSchema;

package/dist/providers/claude/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/providers/claude/provider.ts"],"names":[],"mappings":"AAaA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAO3D,KAAK,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;AAmClC,qBAAa,cAAe,YAAW,aAAa;IAClD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,QAAQ,CAAC,WAAW,YAAY;IAChC,YAAY,EAAE,MAAM,CAAiB;IACrC,eAAe,EAAE,eAAe,CAAY;IAE5C,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,iBAAiB,CAAkB;IAC3C,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,mBAAmB,CAAyC;IACpE,OAAO,CAAC,aAAa,CAA6B;IAGlD,OAAO,CAAC,gBAAgB,CAA+B;IACvD,OAAO,CAAC,cAAc,CAAoE;gBAE9E,WAAW,EAAE,WAAW,EAAE,aAAa,CAAC,EAAE,KAAK,GAAG,KAAK;IAMnE,IAAI,eAAe,IAAI,QAAQ,CAE9B;IAED,iEAAiE;IACjE,oBAAoB,CAAC,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,IAAI;IAIzC,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAMnC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IA4C7B,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IActD,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS1C,IAAI,CACT,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,cAAc,EAAE,GACtB,cAAc,CAAC,UAAU,CAAC;IAU7B,SAAS,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAUlC,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI;IAQvD,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAU7C,WAAW,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YAS1B,UAAU;YAQV,YAAY;YAiFZ,aAAa;YAqHb,YAAY;IA6L3B,oFAAoF;IACpF,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,cAAc;IAiCtB,OAAO,CAAC,cAAc;IA0CtB,OAAO,CAAE,aAAa;CA6DvB;;AAED,oEAAoE"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/providers/claude/provider.ts"],"names":[],"mappings":"AAaA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,UAAU,EAChB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAM5D,KAAK,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;AAqClC,qBAAa,cAAe,YAAW,aAAa;IAClD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,QAAQ,CAAC,WAAW,YAAY;IAChC,YAAY,EAAE,MAAM,CAAiB;IACrC,eAAe,EAAE,eAAe,CAAY;IAE5C,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,iBAAiB,CAAkB;IAC3C,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,mBAAmB,CAAyC;IACpE,OAAO,CAAC,aAAa,CAA6B;IAGlD,OAAO,CAAC,gBAAgB,CAA+B;IACvD,OAAO,CAAC,cAAc,CAAoE;gBAE9E,WAAW,EAAE,WAAW,EAAE,aAAa,CAAC,EAAE,KAAK,GAAG,KAAK,EAAE,YAAY,CAAC,EAAE,YAAY;IAMhG,IAAI,eAAe,IAAI,QAAQ,CAE9B;IAED,iEAAiE;IACjE,oBAAoB,CAAC,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,IAAI;IAIzC,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAMnC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IA4C7B,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IActD,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS1C,IAAI,CACT,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,cAAc,EAAE,EACvB,WAAW,CAAC,EAAE,UAAU,EAAE,GACzB,cAAc,CAAC,UAAU,CAAC;IAe7B,SAAS,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAUlC,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI;IAQvD,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAU7C,WAAW,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YAS1B,UAAU;YAQV,YAAY;YAiFZ,aAAa;IAqI5B,uFAAuF;IACvF,OAAO,CAAC,mBAAmB;YAkBZ,YAAY;IA6L3B,oFAAoF;IACpF,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,aAAa,CAAwB;IAC7C,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,cAAc;IAiCtB,OAAO,CAAC,cAAc;IA0CtB,OAAO,CAAE,aAAa;CA6DvB;;AAED,oEAAoE"}

package/dist/providers/claude/provider.js

@@ -35,9 +35,9 @@ export class ClaudeProvider {
     // Keyed by original tool name → queue of call IDs (per-tool FIFO, not global FIFO)
     cliPendingByName = new Map();
     cliToolResults = [];
-    constructor(authManager, preferredMode) {
+    constructor(authManager, preferredMode, sessionStore) {
         this.authManager = authManager;
-        this.sessionStore = new SessionStore();
+        this.sessionStore = sessionStore ?? new SessionStore();
         this.preferredAuthMode = preferredMode === "cli" ? "cli" : preferredMode === "api" ? "api_key" : null;
     }
     get currentAuthMode() {
@@ -104,15 +104,18 @@ export class ClaudeProvider {
         }
         return session;
     }
-    async *send(session, message, tools) {
+    async *send(session, message, tools, attachments) {
         if (this.authMode === "cli") {
+            if (attachments?.length) {
+                process.stderr.write("[helios] Warning: file attachments are not supported in Claude CLI mode. Switch to API mode (--claude-mode api) to send files.\n");
+            }
             yield* this.sendViaCli(session, message, tools);
         }
         else {
             const creds = await this.authManager.getCredentials("claude");
             if (!creds?.apiKey)
                 throw new Error("No API key — re-authenticate");
-            yield* this.sendViaRawApi(session, message, tools, creds.apiKey);
+            yield* this.sendViaRawApi(session, message, tools, creds.apiKey, attachments);
         }
     }
     interrupt(_session) {
@@ -216,9 +219,25 @@ export class ClaudeProvider {
         }
     }
     // ========== Raw API Mode (API Key) — Streaming ==========
-    async *sendViaRawApi(session, message, tools, apiKey) {
+    async *sendViaRawApi(session, message, tools, apiKey, attachments) {
         const history = this.conversationHistory.get(session.id) ?? [];
-        history.push({ role: "user", content: message });
+        // Build user message — plain text or multimodal with attachments
+        if (attachments && attachments.length > 0) {
+            const content = [];
+            for (const att of attachments) {
+                if (att.mediaType === "application/pdf") {
+                    content.push({ type: "document", source: { type: "base64", media_type: att.mediaType, data: att.data } });
+                }
+                else if (att.mediaType.startsWith("image/")) {
+                    content.push({ type: "image", source: { type: "base64", media_type: att.mediaType, data: att.data } });
+                }
+            }
+            content.push({ type: "text", text: message });
+            history.push({ role: "user", content });
+        }
+        else {
+            history.push({ role: "user", content: message });
+        }
         const MAX_RETRIES = 3;
         let continueLoop = true;
         while (continueLoop) {
@@ -312,8 +331,25 @@ export class ClaudeProvider {
                 };
             }
         }
+        // Strip base64 data from attachment blocks so they aren't re-sent on every turn
+        this.stripAttachmentData(history);
         this.conversationHistory.set(session.id, history);
     }
+    /** Remove attachment content blocks from history so they aren't re-sent to the API. */
+    stripAttachmentData(history) {
+        for (const msg of history) {
+            if (!Array.isArray(msg.content))
+                continue;
+            msg.content = msg.content.map((block) => {
+                if ((block.type === "image" || block.type === "document") &&
+                    "source" in block &&
+                    block.source.data.length > 100) {
+                    return { type: "text", text: `[${block.type} attachment stripped]` };
+                }
+                return block;
+            });
+        }
+    }
     // ─── SSE Streaming for Raw API ──────────────────────
     async *streamRawApi(session, apiKey, messages, tools) {
         this.abortController = new AbortController();
@@ -483,14 +519,18 @@ export class ClaudeProvider {
         const prefix = "mcp__helios__";
         return name.startsWith(prefix) ? name.slice(prefix.length) : name;
     }
+    _cliAvailable = null;
     isClaudeCliAvailable() {
+        if (this._cliAvailable !== null)
+            return this._cliAvailable;
         try {
             execSync("which claude", { stdio: "ignore" });
-            return true;
+            this._cliAvailable = true;
         }
         catch {
-            return false;
+            this._cliAvailable = false;
         }
+        return this._cliAvailable;
     }
     buildMcpServer(tools) {
         const mcpTools = tools.map((t) => sdkTool(t.name, t.description, this.buildZodSchema(t), async (args) => {