heyiam 0.1.7 → 0.1.9

package/dist/context-export.js

@@ -0,0 +1,230 @@
+// Context Export — compresses a Session into AI-consumable Markdown
+// Three tiers: compact (~500 tokens), summary (~2000 tokens), full (~10000+ tokens)
+import { SOURCE_DISPLAY_NAMES } from "./parsers/types.js";
+import { formatLoc } from './format-utils.js';
+/** Estimate token count from character length (rough ~4 chars/token). */
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+/** Format a date string as "Mar 22, 2026". */
+function formatDate(iso) {
+    const d = new Date(iso);
+    if (isNaN(d.getTime()))
+        return iso;
+    const months = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
+    return `${months[d.getMonth()]} ${d.getDate()}, ${d.getFullYear()}`;
+}
+/** Get display name for a source tool. */
+function sourceName(source) {
+    if (!source)
+        return "Unknown";
+    return SOURCE_DISPLAY_NAMES[source] ?? source;
+}
+// ── Metadata header (shared across all tiers) ──────────────────
+function renderMetadata(session) {
+    const lines = [];
+    lines.push(`# Session: ${session.title}`);
+    lines.push(`Project: ${session.projectName} | Source: ${sourceName(session.source)} | Date: ${formatDate(session.date)}`);
+    const stats = [];
+    if (session.durationMinutes > 0)
+        stats.push(`${session.durationMinutes}m`);
+    stats.push(`${session.turns} turns`);
+    if (session.filesChanged.length > 0)
+        stats.push(`${session.filesChanged.length} files`);
+    if (session.linesOfCode > 0)
+        stats.push(`${formatLoc(session.linesOfCode)} LOC`);
+    lines.push(`Duration: ${stats.join(" | ")}`);
+    if (session.skills.length > 0) {
+        lines.push(`Skills: ${session.skills.join(", ")}`);
+    }
+    return lines.join("\n");
+}
+// ── Context block ──────────────────────────────────────────────
+function renderContext(session) {
+    if (!session.context)
+        return "";
+    return `\n## Context\n${session.context}`;
+}
+// ── Execution path ─────────────────────────────────────────────
+function renderExecutionPath(steps) {
+    if (steps.length === 0)
+        return "";
+    const lines = steps.map((s) => `${s.stepNumber}. ${s.title} — ${s.description}`);
+    return `\n## Execution Path\n${lines.join("\n")}`;
+}
+// ── Files changed ──────────────────────────────────────────────
+function renderFilesChanged(files) {
+    if (files.length === 0)
+        return "";
+    const lines = files.map((f) => `${f.path} (+${f.additions}, -${f.deletions})`);
+    return `\n## Files Changed\n${lines.join("\n")}`;
+}
+// ── Key exchanges (summary tier) ───────────────────────────────
+/** Determine if a turn is a "key exchange" worth including in summary. */
+function isKeyExchange(turn, index, turns) {
+    // Always exclude thinking blocks
+    if (turn.type === "thinking")
+        return false;
+    // Include user prompts (questions/directives)
+    if (turn.type === "prompt")
+        return true;
+    // Include error outputs
+    if (turn.type === "error")
+        return true;
+    // Include assistant responses that precede tool use (plans)
+    if (turn.type === "response") {
+        const next = turns[index + 1];
+        if (next && next.type === "tool")
+            return true;
+        // Include if it's the last response (conclusion)
+        const remaining = turns.slice(index + 1);
+        if (remaining.every((t) => t.type !== "response"))
+            return true;
+        return false;
+    }
+    // For tool turns: include edits/writes, errors in output
+    if (turn.type === "tool") {
+        if (turn.toolName === "Edit" || turn.toolName === "Write")
+            return true;
+        if (turn.toolOutput && turn.toolOutput.toLowerCase().includes("error"))
+            return true;
+        return false;
+    }
+    return false;
+}
+/** Format a turn for the key exchanges section. */
+function formatTurnForExchange(turn) {
+    if (turn.type === "prompt") {
+        const text = truncate(turn.content, 300);
+        return `[User]: ${text}`;
+    }
+    if (turn.type === "response") {
+        const text = truncate(turn.content, 300);
+        return `[Assistant]: ${text}`;
+    }
+    if (turn.type === "error") {
+        return `[Error]: ${truncate(turn.content, 200)}`;
+    }
+    if (turn.type === "tool") {
+        return formatToolTurn(turn);
+    }
+    return `[${turn.type}]: ${truncate(turn.content, 200)}`;
+}
+/** Format a tool turn, summarizing large outputs. */
+function formatToolTurn(turn) {
+    const name = turn.toolName ?? "Tool";
+    if (name === "Read") {
+        return `[Tool:Read]: ${turn.toolInput ?? "unknown file"}`;
+    }
+    if (name === "Edit") {
+        const path = turn.toolInput ?? "unknown file";
+        return `[Tool:Edit]: ${path}`;
+    }
+    if (name === "Write") {
+        const path = turn.toolInput ?? "unknown file";
+        return `[Tool:Write]: ${path}`;
+    }
+    if (name === "Bash") {
+        const cmd = turn.toolInput ?? turn.content;
+        return `[Tool:Bash]: ${truncate(cmd, 150)}`;
+    }
+    if (name === "Grep" || name === "Glob") {
+        return `[Tool:${name}]: ${turn.toolInput ?? ""}`;
+    }
+    return `[Tool:${name}]: ${truncate(turn.toolInput ?? turn.content, 150)}`;
+}
+/** Format a turn for the full tier (includes tool output). */
+function formatTurnFull(turn) {
+    if (turn.type === "thinking")
+        return "";
+    if (turn.type === "tool") {
+        const base = formatToolTurn(turn);
+        if (turn.toolOutput) {
+            // Summarize large tool outputs
+            if (turn.toolOutput.length > 500) {
+                const preview = turn.toolOutput.slice(0, 200).trim();
+                return `${base}\n  → [${turn.toolOutput.length} chars] ${preview}...`;
+            }
+            return `${base}\n  → ${turn.toolOutput}`;
+        }
+        return base;
+    }
+    return formatTurnForExchange(turn);
+}
+function truncate(text, maxLen) {
+    const cleaned = text.replace(/\n+/g, " ").trim();
+    if (cleaned.length <= maxLen)
+        return cleaned;
+    return cleaned.slice(0, maxLen - 3) + "...";
+}
+// ── Tier renderers ─────────────────────────────────────────────
+export function renderCompact(session) {
+    const parts = [
+        renderMetadata(session),
+        renderContext(session),
+        renderExecutionPath(session.executionPath),
+    ];
+    return parts.filter(Boolean).join("\n");
+}
+function renderSummary(session, turns) {
+    const keyExchanges = turns
+        .map((turn, i) => ({ turn, i }))
+        .filter(({ turn, i }) => isKeyExchange(turn, i, turns))
+        .map(({ turn }) => formatTurnForExchange(turn));
+    const parts = [
+        renderMetadata(session),
+        renderContext(session),
+        renderExecutionPath(session.executionPath),
+    ];
+    if (keyExchanges.length > 0) {
+        parts.push(`\n## Key Exchanges\n${keyExchanges.join("\n")}`);
+    }
+    parts.push(renderFilesChanged(session.filesChanged));
+    return parts.filter(Boolean).join("\n");
+}
+function renderFull(session, turns) {
+    const allTurns = turns
+        .map((turn) => formatTurnFull(turn))
+        .filter(Boolean);
+    const parts = [
+        renderMetadata(session),
+        renderContext(session),
+        renderExecutionPath(session.executionPath),
+    ];
+    if (allTurns.length > 0) {
+        parts.push(`\n## Conversation\n${allTurns.join("\n")}`);
+    }
+    parts.push(renderFilesChanged(session.filesChanged));
+    return parts.filter(Boolean).join("\n");
+}
+// ── Main export function ───────────────────────────────────────
+/**
+ * Export a session as compressed Markdown for AI context consumption.
+ *
+ * @param session - A fully loaded Session object from the analyzer
+ * @param turns - The ParsedTurn[] from the analyzer input (needed for full content)
+ * @param options - Export options (tier selection)
+ * @returns ExportResult with content string, estimated token count, and tier used
+ */
+export function exportSessionContext(session, turns, options = {}) {
+    const tier = options.tier ?? "summary";
+    let content;
+    switch (tier) {
+        case "compact":
+            content = renderCompact(session);
+            break;
+        case "full":
+            content = renderFull(session, turns);
+            break;
+        case "summary":
+        default:
+            content = renderSummary(session, turns);
+            break;
+    }
+    return {
+        content,
+        tokens: estimateTokens(content),
+        tier,
+    };
+}
+//# sourceMappingURL=context-export.js.map

package/dist/context-export.js.map

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

package/dist/daemon-install.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Map process.platform + process.arch to the asset name produced by CI.
+ * Returns null if the current platform is unsupported.
+ */
+export declare function getAssetName(): string | null;
+/**
+ * Returns the directory where the daemon binary is stored.
+ */
+export declare function getDaemonDir(): string;
+/**
+ * Returns the full path to the daemon binary.
+ */
+export declare function getDaemonBinaryPath(): string;
+export interface InstallResult {
+    version: string;
+    binaryPath: string;
+    assetName: string;
+    size: number;
+}
+/**
+ * Download and install the daemon binary for the current platform.
+ */
+export declare function installDaemon(onProgress?: (message: string) => void): Promise<InstallResult>;

package/dist/daemon-install.js

@@ -0,0 +1,155 @@
+// Download and install the heyiam tray daemon binary from GitHub releases.
+//
+// Detects platform + arch, fetches the correct binary from the latest
+// daemon release, and saves it to ~/.config/heyiam/daemon/heyiam-tray.
+import { createWriteStream, mkdirSync, chmodSync, existsSync, renameSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { pipeline } from 'node:stream/promises';
+import { Readable } from 'node:stream';
+const GITHUB_REPO = 'interactivecats/heyi.am';
+const RELEASES_API = `https://api.github.com/repos/${GITHUB_REPO}/releases`;
+/**
+ * Map process.platform + process.arch to the asset name produced by CI.
+ * Returns null if the current platform is unsupported.
+ */
+export function getAssetName() {
+    const platform = process.platform;
+    const arch = process.arch;
+    if (platform === 'darwin' && arch === 'arm64')
+        return 'heyiam-tray-darwin-arm64';
+    if (platform === 'darwin' && arch === 'x64')
+        return 'heyiam-tray-darwin-x64';
+    if (platform === 'linux' && arch === 'x64')
+        return 'heyiam-tray-linux-x64';
+    if (platform === 'win32' && arch === 'x64')
+        return 'heyiam-tray-windows-x64.exe';
+    return null;
+}
+/**
+ * Returns the directory where the daemon binary is stored.
+ */
+export function getDaemonDir() {
+    return join(homedir(), '.config', 'heyiam', 'daemon');
+}
+/**
+ * Returns the full path to the daemon binary.
+ */
+export function getDaemonBinaryPath() {
+    const ext = process.platform === 'win32' ? '.exe' : '';
+    return join(getDaemonDir(), `heyiam-tray${ext}`);
+}
+/**
+ * Fetch the latest daemon release from GitHub.
+ * Only considers releases whose tag starts with "daemon-v".
+ */
+async function fetchLatestDaemonRelease() {
+    const response = await fetch(`${RELEASES_API}?per_page=20`, {
+        headers: {
+            'Accept': 'application/vnd.github.v3+json',
+            'User-Agent': 'heyiam-cli',
+        },
+    });
+    if (!response.ok) {
+        throw new Error(`GitHub API returned ${response.status}: ${response.statusText}`);
+    }
+    const releases = await response.json();
+    const daemonRelease = releases.find(r => r.tag_name.startsWith('daemon-v'));
+    if (!daemonRelease) {
+        throw new Error('No daemon release found. Check https://github.com/interactivecats/heyi.am/releases');
+    }
+    return daemonRelease;
+}
+/**
+ * Download a file from a URL to a local path.
+ * Uses a temp file + rename for atomicity -- a partial download
+ * never overwrites an existing working binary.
+ */
+async function downloadFile(url, destPath, onProgress) {
+    const response = await fetch(url, {
+        headers: { 'User-Agent': 'heyiam-cli' },
+        redirect: 'follow',
+    });
+    if (!response.ok) {
+        throw new Error(`Download failed: ${response.status} ${response.statusText}`);
+    }
+    const total = parseInt(response.headers.get('content-length') ?? '0', 10);
+    const tmpPath = destPath + '.tmp';
+    // Clean up any prior partial download
+    if (existsSync(tmpPath)) {
+        unlinkSync(tmpPath);
+    }
+    const fileStream = createWriteStream(tmpPath);
+    const body = response.body;
+    if (!body) {
+        throw new Error('Response body is null');
+    }
+    let downloaded = 0;
+    const reader = body.getReader();
+    const nodeStream = new Readable({
+        async read() {
+            const { done, value } = await reader.read();
+            if (done) {
+                this.push(null);
+                return;
+            }
+            downloaded += value.byteLength;
+            if (onProgress && total > 0) {
+                onProgress(downloaded, total);
+            }
+            this.push(Buffer.from(value));
+        },
+    });
+    await pipeline(nodeStream, fileStream);
+    // Atomic rename: only replace the binary once download is fully complete
+    renameSync(tmpPath, destPath);
+}
+/**
+ * Download and install the daemon binary for the current platform.
+ */
+export async function installDaemon(onProgress) {
+    const assetName = getAssetName();
+    if (!assetName) {
+        throw new Error(`Unsupported platform: ${process.platform}-${process.arch}. ` +
+            'Supported: darwin-arm64, darwin-x64, linux-x64, windows-x64');
+    }
+    const log = onProgress ?? (() => { });
+    log('  Checking for latest daemon release...');
+    const release = await fetchLatestDaemonRelease();
+    const asset = release.assets.find(a => a.name === assetName);
+    if (!asset) {
+        const available = release.assets.map(a => a.name).join(', ');
+        throw new Error(`No binary found for ${assetName} in release ${release.tag_name}. ` +
+            `Available assets: ${available}`);
+    }
+    const daemonDir = getDaemonDir();
+    mkdirSync(daemonDir, { recursive: true });
+    const binaryPath = getDaemonBinaryPath();
+    log(`  Downloading ${assetName} (${formatBytes(asset.size)})...`);
+    let lastPct = -1;
+    await downloadFile(asset.browser_download_url, binaryPath, (downloaded, total) => {
+        const pct = Math.floor((downloaded / total) * 100);
+        if (pct !== lastPct && pct % 10 === 0) {
+            lastPct = pct;
+            log(`  Downloading... ${pct}%`);
+        }
+    });
+    // Make executable on unix
+    if (process.platform !== 'win32') {
+        chmodSync(binaryPath, 0o755);
+    }
+    return {
+        version: release.tag_name,
+        binaryPath,
+        assetName,
+        size: asset.size,
+    };
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+//# sourceMappingURL=daemon-install.js.map

package/dist/daemon-install.js.map

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

package/dist/db.d.ts

@@ -0,0 +1,117 @@
+import Database from 'better-sqlite3';
+import type { SessionAnalysis } from './parsers/types.js';
+import type { ParsedTurn, ParsedFileChange, Session } from './analyzer.js';
+import type { SessionMeta } from './parsers/index.js';
+export declare const DB_PATH: string;
+export interface SessionRow {
+    id: string;
+    project_dir: string;
+    source: string;
+    title: string | null;
+    start_time: string | null;
+    end_time: string | null;
+    duration_minutes: number | null;
+    wall_clock_minutes: number | null;
+    turns: number | null;
+    loc_added: number | null;
+    loc_removed: number | null;
+    loc_net: number | null;
+    files_changed: number | null;
+    tool_calls: number | null;
+    skills: string | null;
+    files_touched: string | null;
+    models_used: string | null;
+    cwd: string | null;
+    parent_session_id: string | null;
+    agent_role: string | null;
+    is_subagent: number;
+    file_path: string | null;
+    file_mtime: number | null;
+    file_size: number | null;
+    indexed_at: string | null;
+    context_summary: string | null;
+}
+/** Stats shape compatible with the old SessionStats from server.ts */
+export interface SessionStats {
+    loc: number;
+    duration: number;
+    files: number;
+    turns: number;
+    skills: string[];
+    date: string;
+    endTime?: string;
+}
+export interface ProjectStats {
+    projectDir: string;
+    projectName: string;
+    sessionCount: number;
+    totalLoc: number;
+    totalDuration: number;
+    totalTurns: number;
+    skills: string[];
+    sources: string[];
+    latestDate: string;
+}
+export declare function getDatabase(dbPath?: string): Database.Database;
+export declare function openDatabase(dbPath?: string): Database.Database;
+export declare function isSessionStale(db: Database.Database, sessionId: string, filePath: string): boolean;
+export interface UpsertSessionInput {
+    meta: SessionMeta;
+    analysis: SessionAnalysis;
+    session: Session;
+    fileMtime: number;
+    fileSize: number;
+    contextSummary?: string;
+}
+export declare function upsertSession(db: Database.Database, input: UpsertSessionInput): void;
+export declare function indexSessionContent(db: Database.Database, sessionId: string, turns: ParsedTurn[]): void;
+export declare function indexSessionFiles(db: Database.Database, sessionId: string, files: ParsedFileChange[]): void;
+export declare function indexSession(db: Database.Database, input: UpsertSessionInput, turns: ParsedTurn[]): void;
+export declare function getSessionStats(db: Database.Database, sessionId: string): SessionStats | null;
+export declare function getAllProjectStats(db: Database.Database): ProjectStats[];
+export declare function getSessionRow(db: Database.Database, sessionId: string): SessionRow | null;
+export declare function getContextSummary(db: Database.Database, sessionId: string): string | null;
+export declare function getSessionsByProject(db: Database.Database, projectDir: string): SessionRow[];
+export declare function deleteSession(db: Database.Database, sessionId: string): void;
+export declare function rebuildIndex(db: Database.Database, onProgress?: (current: number, total: number) => void): void;
+/** F17: Merge FTS5 segments for better query performance. Call after bulk indexing. */
+export declare function optimizeFtsIndex(db: Database.Database): void;
+/** Count sessions whose source file no longer exists (preserved in DB). */
+export declare function countPreservedSessions(db: Database.Database): number;
+export interface FtsSearchResult {
+    sessionId: string;
+    snippet: string;
+    rank: number;
+}
+export declare function searchFts(db: Database.Database, query: string, limit?: number): FtsSearchResult[];
+export declare function searchByFile(db: Database.Database, filePath: string): Array<{
+    sessionId: string;
+    additions: number;
+    deletions: number;
+}>;
+export interface SessionMetaFromDb {
+    path: string;
+    source: string;
+    sessionId: string;
+    projectDir: string;
+    isSubagent: boolean;
+    parentSessionId?: string;
+    agentRole?: string;
+}
+export declare function getAllSessionMetas(db: Database.Database): SessionMetaFromDb[];
+export declare function getSessionCount(db: Database.Database): number;
+export interface DashboardStats {
+    sessionCount: number;
+    projectCount: number;
+    sourceCount: number;
+    projects: Array<{
+        projectDir: string;
+        projectName: string;
+        sessionCount: number;
+        totalLoc: number;
+        totalDuration: number;
+        skills: string[];
+        latestDate: string;
+    }>;
+}
+export declare function getDashboardStats(db: Database.Database): DashboardStats;