@zhijiewang/openharness 0.12.1 → 1.2.0

package/dist/commands/index.js

@@ -29,7 +29,7 @@ register("help", "Show available commands", () => {
         'Git': ['diff', 'undo', 'rewind', 'commit', 'log'],
         'Info': ['help', 'cost', 'status', 'config', 'files', 'model', 'memory', 'doctor', 'context', 'mcp', 'mcp-registry'],
         'Settings': ['theme', 'vim', 'companion', 'fast', 'keys'],
-        'AI': ['plan', 'review', 'roles'],
+        'AI': ['plan', 'review', 'roles', 'agents', 'plugins'],
         'Pet': ['cybergotchi'],
     };
     const lines = [];
@@ -354,6 +354,27 @@ register("roles", "List available agent specialization roles", () => {
     lines.push("Usage: Agent({ subagent_type: 'code-reviewer', prompt: '...' })");
     return { output: lines.join("\n"), handled: true };
 });
+register("agents", "Discover running openHarness agents on this machine", () => {
+    const { discoverAgents } = require('../services/a2a.js');
+    const agents = discoverAgents();
+    if (agents.length === 0) {
+        return { output: "No other openHarness agents running on this machine.\n\nOther oh sessions will appear here automatically via the A2A protocol.", handled: true };
+    }
+    const lines = [`Running Agents (${agents.length}):\n`];
+    for (const agent of agents) {
+        const age = Math.round((Date.now() - agent.registeredAt) / 60_000);
+        lines.push(`  ${agent.name}`);
+        lines.push(`    ID:       ${agent.id}`);
+        lines.push(`    Provider: ${agent.provider ?? 'unknown'} / ${agent.model ?? 'unknown'}`);
+        lines.push(`    Dir:      ${agent.workingDir ?? 'unknown'}`);
+        lines.push(`    Endpoint: ${agent.endpoint.type}${agent.endpoint.port ? ':' + agent.endpoint.port : ''}`);
+        lines.push(`    Uptime:   ${age}m`);
+        lines.push(`    Caps:     ${agent.capabilities.map((c) => c.name).join(', ')}`);
+        lines.push('');
+    }
+    lines.push("Send messages with: Agent({ prompt: 'ask the other agent...', allowed_tools: ['SendMessage'] })");
+    return { output: lines.join("\n"), handled: true };
+});
 register("fast", "Toggle fast mode (optimized for speed)", () => {
     return { output: "", handled: true, toggleFastMode: true };
 });
@@ -473,18 +494,61 @@ register("doctor", "Run diagnostic health checks", (_args, ctx) => {
     lines.push(`  Session:       ${ctx.sessionId}`);
     lines.push(`  Messages:      ${ctx.messages.length}`);
     lines.push(`  Cost:          $${ctx.totalCost.toFixed(4)}`);
-    // Disk space (basic check)
+    // Disk space & storage
     try {
-        const { statSync } = require("node:fs");
         const ohDir = join(homedir(), ".oh");
         if (existsSync(ohDir)) {
-            const sessions = readdirSync(join(ohDir, "sessions")).length;
-            lines.push(`  Sessions:      ${sessions} saved`);
-            if (sessions > 80)
-                issues.push(`${sessions} saved sessions. Consider cleaning old ones.`);
+            const sessionsDir = join(ohDir, "sessions");
+            const sessCount = existsSync(sessionsDir) ? readdirSync(sessionsDir).filter(f => f.endsWith('.json')).length : 0;
+            lines.push(`  Sessions:      ${sessCount} saved`);
+            if (sessCount > 80)
+                issues.push(`${sessCount} saved sessions. Consider cleaning old ones.`);
+            // Memory stats
+            const memDir = join(ohDir, "memory");
+            const memCount = existsSync(memDir) ? readdirSync(memDir).filter(f => f.endsWith('.md')).length : 0;
+            lines.push(`  Memories:      ${memCount} global`);
+            // Cron stats
+            const cronDir = join(ohDir, "crons");
+            const cronCount = existsSync(cronDir) ? readdirSync(cronDir).filter(f => f.endsWith('.json')).length : 0;
+            lines.push(`  Cron tasks:    ${cronCount}`);
         }
     }
     catch { /* ignore */ }
+    // Project-level stats
+    try {
+        const projMemDir = join(".oh", "memory");
+        const projMemCount = existsSync(projMemDir) ? readdirSync(projMemDir).filter(f => f.endsWith('.md')).length : 0;
+        if (projMemCount > 0)
+            lines.push(`  Project mems:  ${projMemCount}`);
+        const skillsDir = join(".oh", "skills");
+        const skillCount = existsSync(skillsDir) ? readdirSync(skillsDir).filter(f => f.endsWith('.md')).length : 0;
+        if (skillCount > 0)
+            lines.push(`  Skills:        ${skillCount}`);
+    }
+    catch { /* ignore */ }
+    // Global config
+    const globalCfg = existsSync(join(homedir(), ".oh", "config.yaml"));
+    lines.push(`  Global config: ${globalCfg ? "~/.oh/config.yaml ✓" : "not set (optional)"}`);
+    // Verification config
+    try {
+        const { getVerificationConfig } = require('../harness/verification.js');
+        const vCfg = getVerificationConfig();
+        if (vCfg?.enabled) {
+            lines.push(`  Verification:  ✓ (${vCfg.rules.length} rules, mode: ${vCfg.mode})`);
+        }
+        else {
+            lines.push(`  Verification:  off (no rules detected)`);
+        }
+    }
+    catch { /* ignore */ }
+    // Tools
+    lines.push("");
+    lines.push(`  Tools:         ${ctx.messages.length > 0 ? 'ready' : 'loaded'}`);
+    // Node.js version
+    lines.push(`  Node.js:       ${process.version}`);
+    const [major] = process.version.slice(1).split('.').map(Number);
+    if (major && major < 18)
+        issues.push(`Node.js ${process.version} is below minimum (18+). Upgrade Node.js.`);
     // Issues summary
     if (issues.length > 0) {
         lines.push("");
@@ -571,6 +635,53 @@ function setPinned(args, ctx, pinned) {
 }
 register("pin", "Pin a message (survives /compact)", (args, ctx) => setPinned(args, ctx, true));
 register("unpin", "Unpin a message", (args, ctx) => setPinned(args, ctx, false));
+register("plugins", "List installed plugins and discover new ones", (args) => {
+    const { discoverPlugins, discoverSkills } = require('../harness/plugins.js');
+    const query = args.trim();
+    if (query === 'search' || query.startsWith('search ')) {
+        // npm registry search
+        const keyword = query.replace(/^search\s*/, '').trim() || 'openharness-plugin';
+        return {
+            output: `To discover plugins, search npm:\n\n  npm search openharness-plugin${keyword !== 'openharness-plugin' ? ' ' + keyword : ''}\n\nInstall with:\n  npm install <package-name>\n\nPlugins are auto-discovered from node_modules/ if they contain openharness-plugin.json.`,
+            handled: true,
+        };
+    }
+    // List installed
+    const plugins = discoverPlugins();
+    const skills = discoverSkills();
+    const lines = [];
+    if (plugins.length > 0) {
+        lines.push(`Installed Plugins (${plugins.length}):`);
+        for (const p of plugins) {
+            lines.push(`  ${p.name}@${p.version} — ${p.description || 'no description'}`);
+            if (p.skills?.length)
+                lines.push(`    Skills: ${p.skills.length}`);
+            if (p.mcpServers?.length)
+                lines.push(`    MCP servers: ${p.mcpServers.map((s) => s.name).join(', ')}`);
+        }
+        lines.push('');
+    }
+    if (skills.length > 0) {
+        lines.push(`Available Skills (${skills.length}):`);
+        const bySource = {};
+        for (const s of skills) {
+            (bySource[s.source] ??= []).push(s);
+        }
+        for (const [source, sourceSkills] of Object.entries(bySource)) {
+            lines.push(`  ${source}:`);
+            for (const s of sourceSkills) {
+                lines.push(`    ${s.name} — ${s.description}${s.trigger ? ` (trigger: "${s.trigger}")` : ''}`);
+            }
+        }
+    }
+    else if (plugins.length === 0) {
+        lines.push('No plugins or skills installed.');
+        lines.push('');
+        lines.push('Create skills in .oh/skills/ or ~/.oh/skills/');
+        lines.push('Run /plugins search to find npm packages.');
+    }
+    return { output: lines.join('\n'), handled: true };
+});
 // ── Command Parser ──
 /**
  * Check if input is a slash command. If so, execute it.

package/dist/components/InitWizard.js

@@ -30,9 +30,30 @@ const PERMISSION_MODES = [
     { key: "trust", label: "trust — auto-approve everything" },
     { key: "deny", label: "deny  — read-only, block write/run tools" },
 ];
+/** Auto-detect provider from environment variables */
+function detectProviderFromEnv() {
+    if (process.env.ANTHROPIC_API_KEY)
+        return PROVIDERS.findIndex(p => p.key === "anthropic");
+    if (process.env.OPENAI_API_KEY)
+        return PROVIDERS.findIndex(p => p.key === "openai");
+    if (process.env.OPENROUTER_API_KEY)
+        return PROVIDERS.findIndex(p => p.key === "openrouter");
+    return 0; // Default to Ollama
+}
+/** Get the detected API key for a provider */
+function getEnvApiKey(providerKey) {
+    const envMap = {
+        anthropic: 'ANTHROPIC_API_KEY',
+        openai: 'OPENAI_API_KEY',
+        openrouter: 'OPENROUTER_API_KEY',
+    };
+    const envVar = envMap[providerKey];
+    return envVar ? (process.env[envVar] ?? '') : '';
+}
 export default function InitWizard({ onDone }) {
+    const detectedIdx = detectProviderFromEnv();
     const [step, setStep] = useState("provider");
-    const [providerIdx, setProviderIdx] = useState(0);
+    const [providerIdx, setProviderIdx] = useState(detectedIdx);
     const [apiKey, setApiKey] = useState("");
     const [baseUrl, setBaseUrl] = useState("");
     const [model, setModel] = useState("");
@@ -43,6 +64,9 @@ export default function InitWizard({ onDone }) {
     const [permIdx, setPermIdx] = useState(0);
     const [hatchGotchi, setHatchGotchi] = useState(false);
     const [showSetup, setShowSetup] = useState(false);
+    const [suggestedMcp, setSuggestedMcp] = useState([]);
+    const [selectedMcp, setSelectedMcp] = useState(new Set());
+    const [mcpIdx, setMcpIdx] = useState(0);
     const provider = PROVIDERS[providerIdx];
     // ── Keyboard navigation ──
     useInput(useCallback((input, key) => {
@@ -54,11 +78,19 @@ export default function InitWizard({ onDone }) {
             if (key.return) {
                 setBaseUrl(provider.defaultBaseUrl ?? "");
                 setModel(provider.defaultModel);
+                // Auto-fill API key from environment if available
+                const envKey = getEnvApiKey(provider.key);
+                if (envKey)
+                    setApiKey(envKey);
                 if (!provider.needsApiKey) {
-                    // Skip API key, go straight to testing
                     runTest(provider, "", provider.defaultBaseUrl ?? "");
                     setStep("testing");
                 }
+                else if (envKey) {
+                    // Have env API key — skip manual entry, go to testing
+                    runTest(provider, envKey, provider.defaultBaseUrl ?? "");
+                    setStep("testing");
+                }
                 else {
                     setStep("apikey");
                 }
@@ -69,8 +101,37 @@ export default function InitWizard({ onDone }) {
                 setPermIdx(i => Math.max(0, i - 1));
             if (key.downArrow)
                 setPermIdx(i => Math.min(PERMISSION_MODES.length - 1, i + 1));
+            if (key.return) {
+                // Suggest popular MCP servers
+                setSuggestedMcp(['github', 'memory', 'fetch', 'sequential-thinking', 'brave-search']);
+                setMcpIdx(0);
+                setSelectedMcp(new Set());
+                setStep("mcp");
+            }
+        }
+        if (step === "mcp") {
+            if (key.upArrow)
+                setMcpIdx(i => Math.max(0, i - 1));
+            if (key.downArrow)
+                setMcpIdx(i => Math.min(suggestedMcp.length - 1, i + 1));
+            if (input === " ") {
+                // Toggle selection
+                const name = suggestedMcp[mcpIdx];
+                if (name) {
+                    setSelectedMcp(prev => {
+                        const next = new Set(prev);
+                        if (next.has(name))
+                            next.delete(name);
+                        else
+                            next.add(name);
+                        return next;
+                    });
+                }
+            }
             if (key.return)
                 setStep("gotchi");
+            if (input === "s" || input === "S")
+                setStep("gotchi"); // Skip
         }
         if (step === "model" && availableModels.length > 0) {
             if (key.upArrow)
@@ -120,16 +181,34 @@ export default function InitWizard({ onDone }) {
     // ── Write final config ──
     const writeFinal = useCallback(() => {
         const selectedModel = availableModels.length > 0 ? (availableModels[modelIdx] ?? model) : model;
+        // Build MCP server configs from selected registry entries
+        let mcpServers;
+        if (selectedMcp.size > 0) {
+            try {
+                const { MCP_REGISTRY } = require('../mcp/registry.js');
+                mcpServers = [...selectedMcp]
+                    .map(name => MCP_REGISTRY.find((e) => e.name === name))
+                    .filter(Boolean)
+                    .map((e) => ({
+                    name: e.name,
+                    command: 'npx',
+                    args: ['-y', e.package, ...(e.args ?? [])],
+                    ...(e.envVars?.length ? { env: Object.fromEntries(e.envVars.map((v) => [v, `YOUR_${v}`])) } : {}),
+                }));
+            }
+            catch { /* ignore */ }
+        }
         writeOhConfig({
             provider: provider.key,
             model: selectedModel || provider.defaultModel,
             permissionMode: PERMISSION_MODES[permIdx].key,
             ...(apiKey ? { apiKey } : {}),
             ...(baseUrl ? { baseUrl } : {}),
+            ...(mcpServers?.length ? { mcpServers } : {}),
         });
         setStep("done");
         setTimeout(() => onDone?.(), 1500);
-    }, [provider, model, availableModels, modelIdx, permIdx, apiKey, baseUrl]);
+    }, [provider, model, availableModels, modelIdx, permIdx, apiKey, baseUrl, selectedMcp]);
     // ── Render ──
     if (showSetup) {
         return _jsx(CybergotchiSetup, { onComplete: () => { setShowSetup(false); writeFinal(); }, onSkip: () => { setShowSetup(false); writeFinal(); } });
@@ -137,7 +216,7 @@ export default function InitWizard({ onDone }) {
     if (step === "done") {
         return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsx(Text, { color: "green", children: "\u2713 OpenHarness configured!" }), _jsx(Text, { dimColor: true, children: "Config saved to .oh/config.yaml" }), _jsx(Text, { dimColor: true, children: "Run: oh" })] }));
     }
-    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "OpenHarness Setup" }), _jsx(Text, { children: " " }), step === "provider" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: "Select provider:" }), PROVIDERS.map((p, i) => (_jsxs(Text, { color: i === providerIdx ? "cyan" : undefined, children: [i === providerIdx ? "▶ " : "  ", p.label] }, p.key))), _jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: "\u2191\u2193 navigate  Enter select" })] })), step === "apikey" && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: ["API key for ", _jsx(Text, { color: "cyan", children: provider.label }), ":"] }), _jsx(TextInput, { value: apiKey, onChange: setApiKey, mask: "*", onSubmit: (val) => {
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "OpenHarness Setup" }), _jsx(Text, { children: " " }), step === "provider" && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: ["Select provider:", detectedIdx > 0 ? _jsx(Text, { dimColor: true, children: " (auto-detected from env)" }) : ''] }), PROVIDERS.map((p, i) => (_jsxs(Text, { color: i === providerIdx ? "cyan" : undefined, children: [i === providerIdx ? "▶ " : "  ", p.label] }, p.key))), _jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: "\u2191\u2193 navigate  Enter select" })] })), step === "apikey" && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: ["API key for ", _jsx(Text, { color: "cyan", children: provider.label }), ":"] }), _jsx(TextInput, { value: apiKey, onChange: setApiKey, mask: "*", onSubmit: (val) => {
                             if (!val.trim())
                                 return;
                             if (provider.key === "custom") {
@@ -158,6 +237,6 @@ export default function InitWizard({ onDone }) {
                                     const gi = start + vi;
                                     return (_jsxs(Text, { color: gi === modelIdx ? "cyan" : undefined, children: [gi === modelIdx ? "▶ " : "  ", m] }, m));
                                 }), start + WINDOW < availableModels.length && (_jsxs(Text, { dimColor: true, children: ["  \u2193 ", availableModels.length - start - WINDOW, " more"] }))] }));
-                    })() : (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { dimColor: true, children: "Could not fetch model list. Enter model name:" }), _jsx(TextInput, { value: model, onChange: setModel, onSubmit: () => setStep("permission") })] })), availableModels.length > 0 && _jsx(Text, { dimColor: true, children: "\u2191\u2193 navigate  Enter select" })] })), step === "permission" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: "Permission mode:" }), PERMISSION_MODES.map((p, i) => (_jsxs(Text, { color: i === permIdx ? "cyan" : undefined, children: [i === permIdx ? "▶ " : "  ", p.label] }, p.key))), _jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: "\u2191\u2193 navigate  Enter select" })] })), step === "gotchi" && (_jsx(Box, { flexDirection: "column", children: _jsxs(Text, { children: ["Hatch a cybergotchi companion? ", _jsx(Text, { dimColor: true, children: "(Y/n)" })] }) }))] }));
+                    })() : (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { dimColor: true, children: "Could not fetch model list. Enter model name:" }), _jsx(TextInput, { value: model, onChange: setModel, onSubmit: () => setStep("permission") })] })), availableModels.length > 0 && _jsx(Text, { dimColor: true, children: "\u2191\u2193 navigate  Enter select" })] })), step === "permission" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: "Permission mode:" }), PERMISSION_MODES.map((p, i) => (_jsxs(Text, { color: i === permIdx ? "cyan" : undefined, children: [i === permIdx ? "▶ " : "  ", p.label] }, p.key))), _jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: "\u2191\u2193 navigate  Enter select" })] })), step === "mcp" && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: ["Add MCP servers? ", _jsx(Text, { dimColor: true, children: "(Space to toggle, Enter to confirm, S to skip)" })] }), _jsx(Text, { children: " " }), suggestedMcp.map((name, i) => (_jsxs(Text, { color: i === mcpIdx ? "cyan" : undefined, children: [i === mcpIdx ? "▶ " : "  ", selectedMcp.has(name) ? "[✓] " : "[ ] ", name] }, name))), _jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: "\u2191\u2193 navigate  Space toggle  Enter confirm  S skip" })] })), step === "gotchi" && (_jsx(Box, { flexDirection: "column", children: _jsxs(Text, { children: ["Hatch a cybergotchi companion? ", _jsx(Text, { dimColor: true, children: "(Y/n)" })] }) }))] }));
 }
 //# sourceMappingURL=InitWizard.js.map

package/dist/harness/config.d.ts

@@ -51,6 +51,23 @@ export type OhConfig = {
     memory?: {
         consolidateOnExit?: boolean;
     };
+    /** Multi-model router — use different models for different task types */
+    modelRouter?: {
+        fast?: string;
+        balanced?: string;
+        powerful?: string;
+    };
+    /** Opt-in telemetry (default: off) */
+    telemetry?: {
+        enabled?: boolean;
+        endpoint?: string;
+    };
+    /** Remote server security settings */
+    remote?: {
+        tokens?: string[];
+        rateLimit?: number;
+        allowedTools?: string[];
+    };
 };
 /** Clear cached config (call after writes or to force re-read) */
 export declare function invalidateConfigCache(): void;

package/dist/harness/telemetry.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Opt-in telemetry — anonymous usage tracking for feature prioritization.
+ *
+ * Default: OFF. Enable via config.yaml:
+ *   telemetry:
+ *     enabled: true
+ *
+ * Privacy: never logs file paths, prompts, tool output, or API keys.
+ * Only tracks: tool names, durations, error categories, session metadata.
+ *
+ * Events are batched locally as JSONL in ~/.oh/telemetry/.
+ * Optional: POST to configurable endpoint on session end.
+ */
+export type TelemetryEvent = {
+    type: 'session_start' | 'tool_call' | 'error' | 'session_end';
+    timestamp: number;
+    sessionId: string;
+    payload: TelemetryPayload;
+};
+export type TelemetryPayload = {
+    provider?: string;
+    model?: string;
+    platform?: string;
+    toolName?: string;
+    durationMs?: number;
+    isError?: boolean;
+    errorCategory?: string;
+    totalTurns?: number;
+    totalCost?: number;
+    totalToolCalls?: number;
+    durationMinutes?: number;
+};
+/** Record a telemetry event (no-op if telemetry disabled) */
+export declare function recordEvent(event: TelemetryEvent): void;
+/** Convenience: record a tool call event */
+export declare function recordToolCall(sessionId: string, toolName: string, durationMs: number, isError: boolean): void;
+/** Convenience: record session start */
+export declare function recordSessionStart(sessionId: string, provider: string, model: string): void;
+/** Convenience: record session end with stats */
+export declare function recordSessionEnd(sessionId: string, stats: {
+    totalTurns: number;
+    totalCost: number;
+    totalToolCalls: number;
+    durationMinutes: number;
+}): void;
+/** Convenience: record an error */
+export declare function recordError(sessionId: string, category: string): void;
+/** Read local telemetry events for a session */
+export declare function readSessionEvents(sessionId: string): TelemetryEvent[];
+/** Get aggregate stats across all sessions */
+export declare function getAggregateStats(): {
+    totalSessions: number;
+    totalEvents: number;
+    toolUsage: Record<string, number>;
+    errorCategories: Record<string, number>;
+};
+/** Reset telemetry cache (for testing or config changes) */
+export declare function resetTelemetry(): void;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/harness/telemetry.js

@@ -0,0 +1,129 @@
+/**
+ * Opt-in telemetry — anonymous usage tracking for feature prioritization.
+ *
+ * Default: OFF. Enable via config.yaml:
+ *   telemetry:
+ *     enabled: true
+ *
+ * Privacy: never logs file paths, prompts, tool output, or API keys.
+ * Only tracks: tool names, durations, error categories, session metadata.
+ *
+ * Events are batched locally as JSONL in ~/.oh/telemetry/.
+ * Optional: POST to configurable endpoint on session end.
+ */
+import { appendFileSync, mkdirSync, existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { readOhConfig } from './config.js';
+const TELEMETRY_DIR = join(homedir(), '.oh', 'telemetry');
+// ── State ──
+let _enabled;
+let _sessionFile = null;
+function isEnabled() {
+    if (_enabled !== undefined)
+        return _enabled;
+    const config = readOhConfig();
+    _enabled = config?.telemetry?.enabled === true;
+    return _enabled;
+}
+function getSessionFile(sessionId) {
+    if (_sessionFile)
+        return _sessionFile;
+    mkdirSync(TELEMETRY_DIR, { recursive: true });
+    _sessionFile = join(TELEMETRY_DIR, `${sessionId}.jsonl`);
+    return _sessionFile;
+}
+// ── Public API ──
+/** Record a telemetry event (no-op if telemetry disabled) */
+export function recordEvent(event) {
+    if (!isEnabled())
+        return;
+    try {
+        const file = getSessionFile(event.sessionId);
+        appendFileSync(file, JSON.stringify(event) + '\n');
+    }
+    catch { /* never crash on telemetry failure */ }
+}
+/** Convenience: record a tool call event */
+export function recordToolCall(sessionId, toolName, durationMs, isError) {
+    recordEvent({
+        type: 'tool_call',
+        timestamp: Date.now(),
+        sessionId,
+        payload: { toolName, durationMs, isError },
+    });
+}
+/** Convenience: record session start */
+export function recordSessionStart(sessionId, provider, model) {
+    recordEvent({
+        type: 'session_start',
+        timestamp: Date.now(),
+        sessionId,
+        payload: { provider, model, platform: process.platform },
+    });
+}
+/** Convenience: record session end with stats */
+export function recordSessionEnd(sessionId, stats) {
+    recordEvent({
+        type: 'session_end',
+        timestamp: Date.now(),
+        sessionId,
+        payload: stats,
+    });
+}
+/** Convenience: record an error */
+export function recordError(sessionId, category) {
+    recordEvent({
+        type: 'error',
+        timestamp: Date.now(),
+        sessionId,
+        payload: { errorCategory: category },
+    });
+}
+/** Read local telemetry events for a session */
+export function readSessionEvents(sessionId) {
+    const file = join(TELEMETRY_DIR, `${sessionId}.jsonl`);
+    if (!existsSync(file))
+        return [];
+    try {
+        return readFileSync(file, 'utf-8')
+            .split('\n')
+            .filter(Boolean)
+            .map(line => JSON.parse(line));
+    }
+    catch {
+        return [];
+    }
+}
+/** Get aggregate stats across all sessions */
+export function getAggregateStats() {
+    if (!existsSync(TELEMETRY_DIR))
+        return { totalSessions: 0, totalEvents: 0, toolUsage: {}, errorCategories: {} };
+    const files = readdirSync(TELEMETRY_DIR).filter(f => f.endsWith('.jsonl'));
+    const toolUsage = {};
+    const errorCategories = {};
+    let totalEvents = 0;
+    for (const file of files) {
+        try {
+            const lines = readFileSync(join(TELEMETRY_DIR, file), 'utf-8').split('\n').filter(Boolean);
+            totalEvents += lines.length;
+            for (const line of lines) {
+                const event = JSON.parse(line);
+                if (event.type === 'tool_call' && event.payload.toolName) {
+                    toolUsage[event.payload.toolName] = (toolUsage[event.payload.toolName] ?? 0) + 1;
+                }
+                if (event.type === 'error' && event.payload.errorCategory) {
+                    errorCategories[event.payload.errorCategory] = (errorCategories[event.payload.errorCategory] ?? 0) + 1;
+                }
+            }
+        }
+        catch { /* skip malformed files */ }
+    }
+    return { totalSessions: files.length, totalEvents, toolUsage, errorCategories };
+}
+/** Reset telemetry cache (for testing or config changes) */
+export function resetTelemetry() {
+    _enabled = undefined;
+    _sessionFile = null;
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/main.js

@@ -15,13 +15,13 @@ import { join } from "node:path";
 import { createRequire } from 'node:module';
 const _require = createRequire(import.meta.url);
 const VERSION = _require('../package.json').version;
-const BANNER = `        ___
-       /   \\
-      (     )        ___  ___  ___ _  _ _  _   _ ___ _  _ ___ ___ ___
-       \`~w~\`        / _ \\| _ \\| __| \\| | || | /_\\ | _ \\ \\| | __/ __/ __|
-       (( ))       | (_) |  _/| _|| .\` | __ |/ _ \\|   / .\` | _|\\__ \\__ \\
-        ))((        \\___/|_|  |___|_|\\_|_||_/_/ \\_\\_|_\\_|\\_|___|___/___/
-       ((  ))
+const BANNER = `        ___
+       /   \\
+      (     )        ___  ___  ___ _  _ _  _   _ ___ _  _ ___ ___ ___
+       \`~w~\`        / _ \\| _ \\| __| \\| | || | /_\\ | _ \\ \\| | __/ __/ __|
+       (( ))       | (_) |  _/| _|| .\` | __ |/ _ \\|   / .\` | _|\\__ \\__ \\
+        ))((        \\___/|_|  |___|_|\\_|_||_/_/ \\_\\_|_\\_|\\_|___|___/___/
+       ((  ))
         \`--\``;
 const program = new Command();
 program
@@ -29,39 +29,39 @@ program
     .description("Open-source terminal coding agent. Works with any LLM.")
     .version(VERSION);
 // ── Headless run command ──
-const DEFAULT_SYSTEM_PROMPT = `You are OpenHarness, an AI coding assistant running in the user's terminal.
-You have access to tools for reading, writing, and searching files, running shell commands, and more.
-
-# Tool usage
-- Use Read (not cat/head/tail) to read files. Use Edit (not sed/awk) to modify files. Use Write only to create new files or complete rewrites. Use Grep (not grep/rg) to search content. Use Glob (not find) to find files by pattern. Use Bash only for shell commands that dedicated tools cannot handle.
-- Read a file before editing it. Understand existing code before suggesting modifications.
-- Prefer editing existing files over creating new ones.
-- You can call multiple tools in a single response. Call independent tools in parallel for efficiency. Call dependent tools sequentially.
-
-# Coding standards
-- Do not add features, refactor code, or make improvements beyond what was asked.
-- Do not add comments, docstrings, or type annotations to code you didn't change.
-- Do not add error handling or validation for scenarios that can't happen.
-- Do not create abstractions for one-time operations. Three similar lines is better than a premature abstraction.
-- Be careful not to introduce security vulnerabilities (command injection, XSS, SQL injection, etc.).
-- If you wrote insecure code, fix it immediately.
-
-# Git safety
-- NEVER run destructive git commands (push --force, reset --hard, checkout ., clean -f, branch -D) unless the user explicitly requests it.
-- NEVER skip hooks (--no-verify) or bypass signing (--no-gpg-sign) unless the user explicitly asks.
-- Prefer creating NEW commits over amending existing ones.
-- Before staging, prefer adding specific files by name rather than "git add -A" which can include sensitive files.
-- Only commit when the user explicitly asks you to.
-
-# Careful actions
-- For actions that are hard to reverse or affect shared systems, check with the user before proceeding.
-- Do not use destructive actions as shortcuts. Investigate root causes rather than bypassing safety checks.
-- If you discover unexpected state (unfamiliar files, branches, config), investigate before deleting or overwriting.
-
-# Output style
-- Be concise. Lead with the answer or action, not the reasoning.
-- When referencing code, include file_path:line_number.
-- Do not restate what the user said. Do not add trailing summaries unless asked.
+const DEFAULT_SYSTEM_PROMPT = `You are OpenHarness, an AI coding assistant running in the user's terminal.
+You have access to tools for reading, writing, and searching files, running shell commands, and more.
+
+# Tool usage
+- Use Read (not cat/head/tail) to read files. Use Edit (not sed/awk) to modify files. Use Write only to create new files or complete rewrites. Use Grep (not grep/rg) to search content. Use Glob (not find) to find files by pattern. Use Bash only for shell commands that dedicated tools cannot handle.
+- Read a file before editing it. Understand existing code before suggesting modifications.
+- Prefer editing existing files over creating new ones.
+- You can call multiple tools in a single response. Call independent tools in parallel for efficiency. Call dependent tools sequentially.
+
+# Coding standards
+- Do not add features, refactor code, or make improvements beyond what was asked.
+- Do not add comments, docstrings, or type annotations to code you didn't change.
+- Do not add error handling or validation for scenarios that can't happen.
+- Do not create abstractions for one-time operations. Three similar lines is better than a premature abstraction.
+- Be careful not to introduce security vulnerabilities (command injection, XSS, SQL injection, etc.).
+- If you wrote insecure code, fix it immediately.
+
+# Git safety
+- NEVER run destructive git commands (push --force, reset --hard, checkout ., clean -f, branch -D) unless the user explicitly requests it.
+- NEVER skip hooks (--no-verify) or bypass signing (--no-gpg-sign) unless the user explicitly asks.
+- Prefer creating NEW commits over amending existing ones.
+- Before staging, prefer adding specific files by name rather than "git add -A" which can include sensitive files.
+- Only commit when the user explicitly asks you to.
+
+# Careful actions
+- For actions that are hard to reverse or affect shared systems, check with the user before proceeding.
+- Do not use destructive actions as shortcuts. Investigate root causes rather than bypassing safety checks.
+- If you discover unexpected state (unfamiliar files, branches, config), investigate before deleting or overwriting.
+
+# Output style
+- Be concise. Lead with the answer or action, not the reasoning.
+- When referencing code, include file_path:line_number.
+- Do not restate what the user said. Do not add trailing summaries unless asked.
 - Keep responses short and direct. If you can say it in one sentence, don't use three.`;
 function buildSystemPrompt(model) {
     const parts = [DEFAULT_SYSTEM_PROMPT];