@zhijiewang/openharness 2.29.0 → 2.30.1

package/README.md

@@ -21,7 +21,7 @@ AI coding agent in your terminal. Works with any LLM -- free local models or clo
   <img src="assets/openharness_v0.11.1_4.gif" alt="OpenHarness demo" width="800" />
 </p>
 
-[![npm version](https://img.shields.io/npm/v/@zhijiewang/openharness)](https://www.npmjs.com/package/@zhijiewang/openharness) [![npm downloads](https://img.shields.io/npm/dm/@zhijiewang/openharness)](https://www.npmjs.com/package/@zhijiewang/openharness) [![license](https://img.shields.io/npm/l/@zhijiewang/openharness)](LICENSE) ![tests](https://img.shields.io/badge/tests-890-brightgreen) ![tools](https://img.shields.io/badge/tools-42-blue) ![Node.js 18+](https://img.shields.io/badge/node-18%2B-green) ![TypeScript](https://img.shields.io/badge/typescript-strict-blue) [![GitHub stars](https://img.shields.io/github/stars/zhijiewong/openharness)](https://github.com/zhijiewong/openharness) [![GitHub issues](https://img.shields.io/github/issues-raw/zhijiewong/openharness)](https://github.com/zhijiewong/openharness/issues) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen)](https://github.com/zhijiewong/openharness/pulls)
+[![npm version](https://img.shields.io/npm/v/@zhijiewang/openharness)](https://www.npmjs.com/package/@zhijiewang/openharness) [![npm downloads](https://img.shields.io/npm/dm/@zhijiewang/openharness)](https://www.npmjs.com/package/@zhijiewang/openharness) [![license](https://img.shields.io/npm/l/@zhijiewang/openharness)](LICENSE) ![tests](https://img.shields.io/badge/tests-1502-brightgreen) ![tools](https://img.shields.io/badge/tools-44-blue) ![Node.js 18+](https://img.shields.io/badge/node-18%2B-green) ![TypeScript](https://img.shields.io/badge/typescript-strict-blue) [![GitHub stars](https://img.shields.io/github/stars/zhijiewong/openharness)](https://github.com/zhijiewong/openharness) [![GitHub issues](https://img.shields.io/github/issues-raw/zhijiewong/openharness)](https://github.com/zhijiewong/openharness/issues) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen)](https://github.com/zhijiewong/openharness/pulls)
 
 **English** | [简体中文](README.zh-CN.md)
 
@@ -32,7 +32,7 @@ AI coding agent in your terminal. Works with any LLM -- free local models or clo
 - [Quick Start](#quick-start)
 - [Why OpenHarness?](#why-openharness)
 - [Terminal UI](#terminal-ui)
-- [Tools (43)](#tools-43)
+- [Tools (44)](#tools-43)
 - [Slash Commands](#slash-commands)
 - [Permission Modes](#permission-modes)
 - [Hooks](#hooks)
@@ -114,8 +114,11 @@ Scrolling is handled by the terminal's native scrollbar. Completed messages flow
 - **Syntax highlighting** — keywords, strings, comments, numbers, types (JS/TS/Python/Rust/Go and 20+ languages)
 - **Collapsible code blocks** — blocks over 8 lines auto-collapse; `Ctrl+K` to expand all
 - **Collapsible thinking** — thinking blocks collapse to a one-line summary after completion; `Ctrl+O` to expand
-- **Shimmer spinner** — animated "Thinking" indicator with color transitions (magenta → yellow at 30s → red at 60s)
-- **Tool call display** — args preview, live streaming output, result summaries (line counts, elapsed time), expand/collapse with `Tab`
+- **Shimmer spinner** — animated indicator with stage label (`Thinking`, `Running <Tool>`, `Calling <server>:<tool>`, `Running N tools`) and color transitions (magenta → yellow at 30s → red at 60s)
+- **Tool call display** — args preview, live streaming output, result summaries (line counts, elapsed time), expand/collapse with `Tab`. Tool name color-coded by category (read tools cyan, mutating tools yellow, exec tools magenta, MCP tools green)
+- **Rich tool output** — JSON files render as a colored static tree (depth-3 collapse, line truncation); markdown files render with full styling (headings, code blocks, tables) instead of plain split-on-newline. Renderer dispatches via `outputType` field stamped by FileReadTool / WebFetchTool, with a heuristic fallback for unstamped tools
+- **Nested tool calls** — when `Agent` or `ParallelAgents` spawns inner tool calls (Read, Bash, Edit), the children render indented under their spawning parent. ParallelAgents shows per-task `Task` wrapper rows so child calls group by task instead of flat under the bundled parent. Depth-3 indent limit with `… (N more level)` collapse marker
+- **Multi-line input wrap glyph** — every non-last line of a multi-line input ends with a dim `↵` continuation marker so the wrap is visually obvious
 - **Permission prompts** — bordered box with risk coloring, bold colored **Y**es/**N**o/**D**iff keys, syntax-highlighted inline diffs
 - **Status line** — model name, token count, cost, context usage bar (customizable via config)
 - **Context warning** — yellow alert when context window exceeds 75%
@@ -146,7 +149,7 @@ statusLineFormat: '{model} │ {tokens} │ {cost} │ {ctx}'
 
 Available variables: `{model}`, `{tokens}` (input↑ output↓), `{cost}` ($X.XXXX), `{ctx}` (context usage bar). Empty sections are automatically collapsed.
 
-## Tools (43)
+## Tools (44)
 
 | Tool | Risk | Description |
 |------|------|-------------|

package/README.zh-CN.md

@@ -21,7 +21,7 @@
   <img src="assets/openharness_v0.11.1_4.gif" alt="OpenHarness demo" width="800" />
 </p>
 
-[![npm version](https://img.shields.io/npm/v/@zhijiewang/openharness)](https://www.npmjs.com/package/@zhijiewang/openharness) [![npm downloads](https://img.shields.io/npm/dm/@zhijiewang/openharness)](https://www.npmjs.com/package/@zhijiewang/openharness) [![license](https://img.shields.io/npm/l/@zhijiewang/openharness)](LICENSE) ![tests](https://img.shields.io/badge/tests-890-brightgreen) ![tools](https://img.shields.io/badge/tools-42-blue) ![Node.js 18+](https://img.shields.io/badge/node-18%2B-green) ![TypeScript](https://img.shields.io/badge/typescript-strict-blue) [![GitHub stars](https://img.shields.io/github/stars/zhijiewong/openharness)](https://github.com/zhijiewong/openharness) [![GitHub issues](https://img.shields.io/github/issues-raw/zhijiewong/openharness)](https://github.com/zhijiewong/openharness/issues) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen)](https://github.com/zhijiewong/openharness/pulls)
+[![npm version](https://img.shields.io/npm/v/@zhijiewang/openharness)](https://www.npmjs.com/package/@zhijiewang/openharness) [![npm downloads](https://img.shields.io/npm/dm/@zhijiewang/openharness)](https://www.npmjs.com/package/@zhijiewang/openharness) [![license](https://img.shields.io/npm/l/@zhijiewang/openharness)](LICENSE) ![tests](https://img.shields.io/badge/tests-1502-brightgreen) ![tools](https://img.shields.io/badge/tools-44-blue) ![Node.js 18+](https://img.shields.io/badge/node-18%2B-green) ![TypeScript](https://img.shields.io/badge/typescript-strict-blue) [![GitHub stars](https://img.shields.io/github/stars/zhijiewong/openharness)](https://github.com/zhijiewong/openharness) [![GitHub issues](https://img.shields.io/github/issues-raw/zhijiewong/openharness)](https://github.com/zhijiewong/openharness/issues) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen)](https://github.com/zhijiewong/openharness/pulls)
 
 [English](README.md) | **简体中文**
 
@@ -32,7 +32,7 @@
 - [快速开始](#快速开始)
 - [为什么选择 OpenHarness？](#为什么选择-openharness)
 - [终端界面](#终端界面)
-- [工具（43 个）](#工具43-个)
+- [工具（44 个）](#工具43-个)
 - [斜杠命令](#斜杠命令)
 - [权限模式](#权限模式)
 - [钩子](#钩子)
@@ -114,8 +114,11 @@ OpenHarness 采用受 Ink/Claude Code 默认模式启发的顺序式终端渲染
 - **语法高亮** —— 关键字、字符串、注释、数字、类型（支持 JS/TS/Python/Rust/Go 等 20+ 种语言）
 - **可折叠代码块** —— 超过 8 行的代码块会自动折叠；按 `Ctrl+K` 全部展开
 - **可折叠思考块** —— 思考块在完成后会折叠为一行摘要；按 `Ctrl+O` 展开
-- **流光加载动画** —— 带颜色过渡的 "Thinking" 指示器（30 秒后洋红 → 黄，60 秒后 → 红）
-- **工具调用显示** —— 参数预览、实时流式输出、结果摘要（行数、耗时），按 `Tab` 展开/折叠
+- **流光加载动画** —— 带阶段标签（`Thinking`、`Running <Tool>`、`Calling <server>:<tool>`、`Running N tools`）和颜色过渡的指示器（30 秒后洋红 → 黄，60 秒后 → 红）
+- **工具调用显示** —— 参数预览、实时流式输出、结果摘要（行数、耗时），按 `Tab` 展开/折叠。工具名称按类别着色（读取类青色、修改类黄色、执行类品红色、MCP 类绿色）
+- **富工具输出** —— JSON 文件以彩色静态树形渲染（深度 3 级折叠、行数截断）；Markdown 文件完整渲染样式（标题、代码块、表格），不再是普通的按行拆分。渲染器通过 `outputType` 字段分发（FileReadTool / WebFetchTool 会标注），未标注的工具走启发式回退路径
+- **嵌套工具调用** —— 当 `Agent` 或 `ParallelAgents` 派生内层工具调用（Read、Bash、Edit）时,子调用会缩进显示在派生它的父调用之下。ParallelAgents 还会显示每个任务的 `Task` 包装行,使子调用按任务分组,而不是平铺在合并的父调用之下。深度 3 级缩进上限,超过显示 `… (N more level)` 折叠标记
+- **多行输入折行符** —— 多行输入的每一非末尾行都以暗色 `↵` 续行符结尾,使折行视觉清晰
 - **权限提示** —— 带边框的提示框，按风险级别着色，醒目的 **Y**es/**N**o/**D**iff 按键，内联 diff 带语法高亮
 - **状态栏** —— 显示模型名称、token 计数、费用、上下文占用条（可通过配置自定义）
 - **上下文告警** —— 上下文窗口超过 75% 时显示黄色警告
@@ -146,7 +149,7 @@ statusLineFormat: '{model} │ {tokens} │ {cost} │ {ctx}'
 
 可用变量：`{model}`、`{tokens}`（输入↑ 输出↓）、`{cost}`（$X.XXXX）、`{ctx}`（上下文占用条）。空片段会自动折叠。
 
-## 工具（43 个）
+## 工具（44 个）
 
 | 工具 | 风险 | 描述 |
 |------|------|-------------|

package/dist/Tool.d.ts

@@ -29,6 +29,10 @@ export type ToolContext = {
     gitCommitPerTool?: boolean;
     /** Forward an inner-query tool event to the outer event stream, stamped with the parent's callId. Used by AgentTool and AgentDispatcher to surface nested tool calls. */
     emitChildEvent?: (event: ToolCallStart | ToolCallComplete | ToolCallEnd | ToolOutputDelta) => void;
+    /** Optional session tracer for OTel-style span emission around tool execution. */
+    tracer?: import("./harness/traces.js").SessionTracer;
+    /** Optional parent span ID for the current tool execution (set by query loop). */
+    parentSpanId?: string;
 };
 export type Tool<Input extends z.ZodType = z.ZodType> = {
     readonly name: string;

package/dist/commands/ai.js

@@ -1,7 +1,11 @@
 /**
  * AI commands — /plan, /review, /roles, /agents, /plugins, /btw, /loop
  */
+import { listRoles } from "../agents/roles.js";
 import { gitDiff, isGitRepo } from "../git/index.js";
+import { addMarketplace, formatInstalledPlugins, formatMarketplaceSearch, getInstalledPlugins, installPlugin, listMarketplaces, removeMarketplace, searchMarketplace, uninstallPlugin, } from "../harness/marketplace.js";
+import { discoverPlugins, discoverSkills } from "../harness/plugins.js";
+import { discoverAgents } from "../services/a2a.js";
 import { handleCybergotchiCommand } from "./cybergotchi.js";
 export function registerAICommands(register) {
     register("btw", "Ask a side question (ephemeral, no tools, not saved to history)", (args) => {
@@ -71,7 +75,6 @@ export function registerAICommands(register) {
         };
     });
     register("roles", "List available agent specialization roles", () => {
-        const { listRoles } = require("../agents/roles.js");
         const roles = listRoles();
         const lines = ["Available agent roles:\n"];
         for (const role of roles) {
@@ -86,7 +89,6 @@ export function registerAICommands(register) {
         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 {
@@ -110,8 +112,6 @@ export function registerAICommands(register) {
         return { output: lines.join("\n"), handled: true };
     });
     const pluginsHandler = (args) => {
-        const { discoverPlugins, discoverSkills } = require("../harness/plugins.js");
-        const { searchMarketplace, installPlugin, uninstallPlugin, getInstalledPlugins, listMarketplaces, addMarketplace, removeMarketplace, formatMarketplaceSearch, formatInstalledPlugins, } = require("../harness/marketplace.js");
         const parts = args.trim().split(/\s+/);
         const subcommand = parts[0] ?? "";
         const rest = parts.slice(1).join(" ");

package/dist/commands/git.js

@@ -3,6 +3,7 @@
  */
 import { execSync } from "node:child_process";
 import { gitBranch, gitCommit, gitDiff, gitLog, gitUndo, isGitRepo } from "../git/index.js";
+import { checkpointCount, listCheckpoints, rewindLastCheckpoint } from "../harness/checkpoints.js";
 export function registerGitCommands(register) {
     register("diff", "Show uncommitted git changes", () => {
         if (!isGitRepo()) {
@@ -22,7 +23,6 @@ export function registerGitCommands(register) {
         };
     });
     register("rewind", "Restore files from checkpoint (interactive picker or last)", (args) => {
-        const { rewindLastCheckpoint, listCheckpoints, checkpointCount } = require("../harness/checkpoints.js");
         const checkpoints = listCheckpoints();
         if (checkpoints.length === 0) {
             return { output: "No checkpoints available. Checkpoints are created before file modifications.", handled: true };

package/dist/commands/info.js

@@ -11,10 +11,12 @@ import { getContextWindow } from "../harness/cost.js";
 import { getHooks, invalidateHookCache } from "../harness/hooks.js";
 import { discoverPlugins, discoverSkills } from "../harness/plugins.js";
 import { invalidateSandboxCache } from "../harness/sandbox.js";
-import { invalidateVerificationCache } from "../harness/verification.js";
+import { formatTrace, listTracedSessions, loadTrace } from "../harness/traces.js";
+import { getVerificationConfig, invalidateVerificationCache } from "../harness/verification.js";
 import { normalizeMcpConfig } from "../mcp/config-normalize.js";
 import { connectedMcpServers, disconnectMcpClients, loadMcpTools } from "../mcp/loader.js";
 import { getAuthStatus } from "../mcp/oauth.js";
+import { formatRegistry, generateConfigBlock, MCP_REGISTRY, searchRegistry } from "../mcp/registry.js";
 import { getRouteSelection } from "../providers/router.js";
 import { formatHooksReport } from "./hooks-report.js";
 import { mcpLoginHandler, mcpLogoutHandler } from "./mcp-auth.js";
@@ -47,6 +49,7 @@ export function registerInfoCommands(register, getCommandMap) {
                 "memory",
                 "doctor",
                 "hooks",
+                "traces",
                 "context",
                 "mcp",
                 "mcp-login",
@@ -324,7 +327,6 @@ export function registerInfoCommands(register, getCommandMap) {
         const globalCfg = existsSync(join(homedir(), ".oh", "config.yaml"));
         lines.push(`  Global config: ${globalCfg ? "~/.oh/config.yaml ✓" : "not set (optional)"}`);
         try {
-            const { getVerificationConfig } = require("../harness/verification.js");
             const vCfg = getVerificationConfig();
             if (vCfg?.enabled) {
                 lines.push(`  Verification:  ✓ (${vCfg.rules.length} rules, mode: ${vCfg.mode})`);
@@ -358,6 +360,32 @@ export function registerInfoCommands(register, getCommandMap) {
     register("hooks", "List loaded hooks grouped by event", () => {
         return { output: formatHooksReport(getHooks()), handled: true };
     });
+    register("traces", "List sessions with persisted OTel-style traces (or show one with /traces <sessionId>)", (args) => {
+        const id = args.trim();
+        if (id) {
+            const spans = loadTrace(id);
+            if (spans.length === 0)
+                return { output: `No trace found for session ${id}.`, handled: true };
+            return { output: formatTrace(spans), handled: true };
+        }
+        const sessions = listTracedSessions();
+        if (sessions.length === 0) {
+            return {
+                output: "No persisted traces. Tracing is opt-in — start oh with OH_TRACE=1 to record spans to ~/.oh/traces/.",
+                handled: true,
+            };
+        }
+        const lines = [`${sessions.length} session(s) with traces (most recent first):`, ""];
+        for (const sid of sessions.slice(0, 20)) {
+            const spans = loadTrace(sid);
+            const totalMs = spans.reduce((sum, s) => sum + s.durationMs, 0);
+            const errors = spans.filter((s) => s.status === "error").length;
+            const errSuffix = errors > 0 ? ` ${errors} error(s)` : "";
+            lines.push(`  ${sid}  ${spans.length} spans, ${totalMs}ms total${errSuffix}`);
+        }
+        lines.push("", "Run `/traces <sessionId>` to see the full span tree.");
+        return { output: lines.join("\n"), handled: true };
+    });
     register("context", "Show context window usage breakdown", (_args, ctx) => {
         const ctxWindow = getContextWindow(ctx.model);
         let userTokens = 0, assistantTokens = 0, toolTokens = 0, systemTokens = 0;
@@ -450,7 +478,6 @@ export function registerInfoCommands(register, getCommandMap) {
         return { output: lines.join("\n"), handled: true };
     });
     register("mcp-registry", "Browse and add MCP servers from the curated registry", (args) => {
-        const { searchRegistry, formatRegistry, generateConfigBlock, MCP_REGISTRY } = require("../mcp/registry.js");
         const query = args.trim();
         if (!query) {
             const output = `MCP Server Registry (${MCP_REGISTRY.length} servers)\n${"─".repeat(50)}\n\n${formatRegistry()}\n\nUsage:\n  /mcp-registry <name>    Show install config for a server\n  /mcp-registry <keyword> Search by name, description, or category`;

package/dist/commands/session.js

@@ -2,7 +2,7 @@
  * Session commands — /clear, /compact, /copy, /export, /history, /browse, /resume, /fork, /pin, /unpin
  */
 import { spawnSync } from "node:child_process";
-import { existsSync, mkdirSync } from "node:fs";
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
 import { homedir, platform } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import { getContextWindow } from "../harness/cost.js";
@@ -134,7 +134,6 @@ export function registerSessionCommands(register) {
         const body = asJson ? JSON.stringify(ctx.messages, null, 2) : formatMessagesAsMarkdown(ctx.messages);
         try {
             mkdirSync(dirname(filename), { recursive: true });
-            const { writeFileSync } = require("node:fs");
             writeFileSync(filename, body);
             return { output: `Exported ${ctx.messages.length} messages to ${filename}`, handled: true };
         }

package/dist/commands/settings.js

@@ -8,6 +8,7 @@ import { dirname, join } from "node:path";
 import { readApprovalLog } from "../harness/approvals.js";
 import { readOhConfig } from "../harness/config.js";
 import { loadKeybindings } from "../harness/keybindings.js";
+import { sandboxStatus } from "../harness/sandbox.js";
 import { isTrusted, listTrusted, trust } from "../harness/trust.js";
 const KEYBINDINGS_TEMPLATE = `[
   { "key": "ctrl+d", "action": "/diff" },
@@ -136,7 +137,6 @@ export function registerSettingsCommands(register) {
         return { output: `Effort level set to: ${level}`, handled: true };
     });
     register("sandbox", "Show sandbox status and restrictions", () => {
-        const { sandboxStatus } = require("../harness/sandbox.js");
         return { output: `${sandboxStatus()}\n\nConfigure in .oh/config.yaml under sandbox:`, handled: true };
     });
     register("permissions", "View or change permission mode (or 'log' for approval history)", (args, ctx) => {

package/dist/commands/skills.js

@@ -1,9 +1,9 @@
 /**
  * Skill management commands — /skills, /skill-create, /skill-delete, /skill-edit, /skill-search, /skill-install
  */
-import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, unlinkSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
-import { discoverSkills } from "../harness/plugins.js";
+import { discoverSkills, findSkill } from "../harness/plugins.js";
 export function registerSkillCommands(register) {
     register("skills", "List all available skills", () => {
         const skills = discoverSkills();
@@ -76,12 +76,10 @@ How to confirm the skill worked correctly.
         const name = args.trim();
         if (!name)
             return { output: "Usage: /skill-delete <name>", handled: true };
-        const { findSkill } = require("../harness/plugins.js");
         const skill = findSkill(name);
         if (!skill)
             return { output: `Skill "${name}" not found.`, handled: true };
         try {
-            const { unlinkSync } = require("node:fs");
             unlinkSync(skill.filePath);
             return { output: `Deleted skill: ${skill.filePath}`, handled: true };
         }
@@ -93,7 +91,6 @@ How to confirm the skill worked correctly.
         const name = args.trim();
         if (!name)
             return { output: "Usage: /skill-edit <name>", handled: true };
-        const { findSkill } = require("../harness/plugins.js");
         const skill = findSkill(name);
         if (!skill)
             return { output: `Skill "${name}" not found.`, handled: true };

package/dist/components/InitWizard.js

@@ -15,6 +15,7 @@ import { Box, Text, useInput } from "ink";
 import TextInput from "ink-text-input";
 import { useCallback, useState } from "react";
 import { writeOhConfig } from "../harness/config.js";
+import { MCP_REGISTRY } from "../mcp/registry.js";
 import CybergotchiSetup from "./CybergotchiSetup.js";
 const PROVIDERS = [
     {
@@ -125,7 +126,6 @@ export default function InitWizard({ onDone }) {
         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)

package/dist/harness/config.js

@@ -127,13 +127,9 @@ export function appendToolPermission(toolName, action = "allow", root) {
 }
 export function writeOhConfig(cfg, root) {
     invalidateConfigCache();
-    // Emit configChange hook (lazy import to avoid circular dependency)
-    try {
-        require("./hooks.js").emitHook("configChange", {});
-    }
-    catch {
-        /* ignore */
-    }
+    // Emit configChange hook (dynamic import to avoid circular dependency
+    // with hooks.ts, which imports readOhConfig from this module).
+    import("./hooks.js").then((m) => m.emitHook("configChange", {})).catch(() => { });
     const p = configPath(root);
     mkdirSync(join(root ?? ".", ".oh"), { recursive: true });
     if (cfg.provider === "llamacpp" || cfg.provider === "lmstudio") {

package/dist/harness/plugins.js

@@ -14,6 +14,7 @@ import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join, relative } from "node:path";
 import { fileURLToPath } from "node:url";
+import { getInstalledPlugins } from "./marketplace.js";
 const PROJECT_SKILLS_DIR = join(".oh", "skills");
 const GLOBAL_SKILLS_DIR = join(homedir(), ".oh", "skills");
 // Claude Code ecosystem mirror paths (Anthropic convention)
@@ -178,7 +179,6 @@ export function discoverSkills() {
     skills.push(...loadSkillsFromDir(CC_GLOBAL_SKILLS_DIR, "global"));
     // Load skills from installed marketplace plugins (namespaced as plugin-name:skill-name)
     try {
-        const { getInstalledPlugins } = require("./marketplace.js");
         for (const plugin of getInstalledPlugins()) {
             const pluginSkillsDir = join(plugin.cachePath, "skills");
             const pluginSkills = loadSkillsFromDir(pluginSkillsDir, "plugin");

package/dist/harness/telemetry.js

@@ -15,10 +15,15 @@ import { appendFileSync, existsSync, mkdirSync, readdirSync, readFileSync } from
 import { homedir } from "node:os";
 import { join } from "node:path";
 import { readOhConfig } from "./config.js";
-const TELEMETRY_DIR = join(homedir(), ".oh", "telemetry");
+/**
+ * Telemetry directory. Resolved on each access so `OH_TELEMETRY_DIR` env-var
+ * overrides (used by tests) take effect even after this module loads.
+ */
+function telemetryDir() {
+    return process.env.OH_TELEMETRY_DIR ?? join(homedir(), ".oh", "telemetry");
+}
 // ── State ──
 let _enabled;
-let _sessionFile = null;
 function isEnabled() {
     if (_enabled !== undefined)
         return _enabled;
@@ -26,12 +31,13 @@ function isEnabled() {
     _enabled = config?.telemetry?.enabled === true;
     return _enabled;
 }
+/** Resolve the JSONL path for a sessionId. Stateless — was previously a module-level
+ * singleton that ignored `sessionId` after the first call, causing multi-session
+ * processes (e.g. `--resume`) to write every session into the first one's file. */
 function getSessionFile(sessionId) {
-    if (_sessionFile)
-        return _sessionFile;
-    mkdirSync(TELEMETRY_DIR, { recursive: true });
-    _sessionFile = join(TELEMETRY_DIR, `${sessionId}.jsonl`);
-    return _sessionFile;
+    const dir = telemetryDir();
+    mkdirSync(dir, { recursive: true });
+    return join(dir, `${sessionId}.jsonl`);
 }
 // ── Public API ──
 /** Record a telemetry event (no-op if telemetry disabled) */
@@ -84,7 +90,7 @@ export function recordError(sessionId, category) {
 }
 /** Read local telemetry events for a session */
 export function readSessionEvents(sessionId) {
-    const file = join(TELEMETRY_DIR, `${sessionId}.jsonl`);
+    const file = join(telemetryDir(), `${sessionId}.jsonl`);
     if (!existsSync(file))
         return [];
     try {
@@ -99,15 +105,16 @@ export function readSessionEvents(sessionId) {
 }
 /** Get aggregate stats across all sessions */
 export function getAggregateStats() {
-    if (!existsSync(TELEMETRY_DIR))
+    const dir = telemetryDir();
+    if (!existsSync(dir))
         return { totalSessions: 0, totalEvents: 0, toolUsage: {}, errorCategories: {} };
-    const files = readdirSync(TELEMETRY_DIR).filter((f) => f.endsWith(".jsonl"));
+    const files = readdirSync(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);
+            const lines = readFileSync(join(dir, file), "utf-8").split("\n").filter(Boolean);
             totalEvents += lines.length;
             for (const line of lines) {
                 const event = JSON.parse(line);
@@ -128,6 +135,5 @@ export function getAggregateStats() {
 /** Reset telemetry cache (for testing or config changes) */
 export function resetTelemetry() {
     _enabled = undefined;
-    _sessionFile = null;
 }
 //# sourceMappingURL=telemetry.js.map

package/dist/harness/traces.d.ts

@@ -22,16 +22,46 @@ export type TraceEvent = {
     timestamp: number;
     attributes?: Record<string, unknown>;
 };
+export type OTLPConfig = {
+    endpoint: string;
+    headers?: Record<string, string>;
+};
 export declare class SessionTracer {
     private sessionId;
     private spans;
     private activeSpans;
     private spanCounter;
-    constructor(sessionId: string);
+    private otlp?;
+    /**
+     * Pending spans that have ended but not yet been POSTed to OTLP. Drained
+     * by a microtask-debounced flush (one POST per microtask boundary even if
+     * many spans end in the same tick) and by the public `flush()` method.
+     */
+    private otlpBuffer;
+    private otlpFlushScheduled;
+    /** In-flight fetches so `flush()` can await any POSTs already on the wire. */
+    private otlpInFlight;
+    constructor(sessionId: string, otlp?: OTLPConfig);
     /** Start a new span. Returns the span ID. */
     startSpan(name: string, attributes?: Record<string, unknown>, parentSpanId?: string): string;
     /** End a span and record it. */
     endSpan(spanId: string, status?: "ok" | "error", extraAttributes?: Record<string, unknown>): TraceSpan | null;
+    /**
+     * Buffer the span for OTLP shipping. The actual POST is deferred to a
+     * microtask so multiple spans ending in the same tick coalesce into a
+     * single batch POST instead of one fetch each. Errors are swallowed —
+     * telemetry must never crash the agent.
+     */
+    private shipSpanOTLP;
+    /** Send whatever is in `otlpBuffer` as a single fire-and-forget POST. The
+     * returned promise is tracked in `otlpInFlight` so `flush()` can await it. */
+    private drainOTLPBuffer;
+    /**
+     * Drain any pending OTLP buffer and await every in-flight POST. Call this at
+     * session end so spans aren't dropped on `process.exit`. No-op when OTLP is
+     * not configured. Errors are swallowed (already, by `drainOTLPBuffer`).
+     */
+    flush(): Promise<void>;
     /** Get all completed spans */
     getSpans(): TraceSpan[];
     /** Get a summary of the trace */

package/dist/harness/traces.js

@@ -18,8 +18,19 @@ export class SessionTracer {
     spans = [];
     activeSpans = new Map();
     spanCounter = 0;
-    constructor(sessionId) {
+    otlp;
+    /**
+     * Pending spans that have ended but not yet been POSTed to OTLP. Drained
+     * by a microtask-debounced flush (one POST per microtask boundary even if
+     * many spans end in the same tick) and by the public `flush()` method.
+     */
+    otlpBuffer = [];
+    otlpFlushScheduled = false;
+    /** In-flight fetches so `flush()` can await any POSTs already on the wire. */
+    otlpInFlight = new Set();
+    constructor(sessionId, otlp) {
         this.sessionId = sessionId;
+        this.otlp = otlp;
     }
     /** Start a new span. Returns the span ID. */
     startSpan(name, attributes = {}, parentSpanId) {
@@ -50,8 +61,64 @@ export class SessionTracer {
             this.spans = this.spans.slice(-MAX_IN_MEMORY_SPANS);
         }
         this.persistSpan(span);
+        if (this.otlp)
+            this.shipSpanOTLP(span);
         return span;
     }
+    /**
+     * Buffer the span for OTLP shipping. The actual POST is deferred to a
+     * microtask so multiple spans ending in the same tick coalesce into a
+     * single batch POST instead of one fetch each. Errors are swallowed —
+     * telemetry must never crash the agent.
+     */
+    shipSpanOTLP(span) {
+        if (!this.otlp)
+            return;
+        this.otlpBuffer.push(span);
+        if (this.otlpFlushScheduled)
+            return;
+        this.otlpFlushScheduled = true;
+        queueMicrotask(() => {
+            this.otlpFlushScheduled = false;
+            this.drainOTLPBuffer();
+        });
+    }
+    /** Send whatever is in `otlpBuffer` as a single fire-and-forget POST. The
+     * returned promise is tracked in `otlpInFlight` so `flush()` can await it. */
+    drainOTLPBuffer() {
+        if (!this.otlp || this.otlpBuffer.length === 0)
+            return;
+        const batch = this.otlpBuffer;
+        this.otlpBuffer = [];
+        const payload = exportTraceOTLP(this.sessionId, batch);
+        const p = fetch(this.otlp.endpoint, {
+            method: "POST",
+            headers: { "Content-Type": "application/json", ...(this.otlp.headers ?? {}) },
+            body: JSON.stringify(payload),
+        }).then(() => undefined, () => undefined);
+        this.otlpInFlight.add(p);
+        p.finally(() => {
+            this.otlpInFlight.delete(p);
+        });
+    }
+    /**
+     * Drain any pending OTLP buffer and await every in-flight POST. Call this at
+     * session end so spans aren't dropped on `process.exit`. No-op when OTLP is
+     * not configured. Errors are swallowed (already, by `drainOTLPBuffer`).
+     */
+    async flush() {
+        if (!this.otlp)
+            return;
+        // Drain any not-yet-shipped buffer first; cancel pending microtask flush
+        // (the buffer becomes empty so the microtask would no-op anyway, but
+        // clearing the flag is explicit).
+        this.otlpFlushScheduled = false;
+        this.drainOTLPBuffer();
+        // Wait for every fetch we've kicked off (microtask-shipped or just now).
+        if (this.otlpInFlight.size > 0) {
+            await Promise.allSettled(Array.from(this.otlpInFlight));
+        }
+    }
     /** Get all completed spans */
     getSpans() {
         return [...this.spans];
@@ -153,8 +220,22 @@ export function formatTrace(spans) {
     lines.push(`Total: ${spans.length} spans, ${totalMs}ms, ${errors} errors`);
     return lines.join("\n");
 }
+/**
+ * Coerce an arbitrary string (UUID with hyphens, "span-N", etc.) into a fixed-length
+ * lowercase hex string suitable for OTLP. OTLP collectors (Jaeger, Tempo, OTel
+ * Collector) validate that traceId is 32 hex chars and spanId is 16 hex chars and
+ * reject anything containing `-` or non-hex letters. We strip non-hex chars, then
+ * pad-left with zeros (or truncate from the left) to the target length.
+ */
+function toHexId(input, length) {
+    const hex = input.toLowerCase().replace(/[^0-9a-f]/g, "");
+    if (hex.length === 0)
+        return "0".repeat(length);
+    return hex.length >= length ? hex.slice(0, length) : hex.padStart(length, "0");
+}
 /** Export trace in OpenTelemetry-compatible format */
 export function exportTraceOTLP(sessionId, spans) {
+    const traceId = toHexId(sessionId, 32);
     return {
         resourceSpans: [
             {
@@ -168,9 +249,9 @@ export function exportTraceOTLP(sessionId, spans) {
                     {
                         scope: { name: "openharness.agent" },
                         spans: spans.map((s) => ({
-                            traceId: sessionId.padEnd(32, "0").slice(0, 32),
-                            spanId: s.spanId.padEnd(16, "0").slice(0, 16),
-                            parentSpanId: s.parentSpanId?.padEnd(16, "0").slice(0, 16),
+                            traceId,
+                            spanId: toHexId(s.spanId, 16),
+                            parentSpanId: s.parentSpanId ? toHexId(s.parentSpanId, 16) : undefined,
                             name: s.name,
                             startTimeUnixNano: s.startTime * 1_000_000,
                             endTimeUnixNano: s.endTime * 1_000_000,

package/dist/providers/anthropic.js

@@ -134,6 +134,10 @@ export class AnthropicProvider {
         let currentToolId = "";
         let currentToolName = "";
         let currentToolArgs = "";
+        // Persist across chunk boundaries: a TCP/TLS framing boundary can land
+        // between the SSE `event:` and `data:` lines, leaving the event type
+        // staged for the next chunk's first `data:` line.
+        let currentEvent = "";
         while (true) {
             const { done, value } = await reader.read();
             if (done)
@@ -141,7 +145,6 @@ export class AnthropicProvider {
             buffer += decoder.decode(value, { stream: true });
             const lines = buffer.split("\n");
             buffer = lines.pop() ?? "";
-            let currentEvent = "";
             for (const line of lines) {
                 const trimmed = line.trim();
                 if (trimmed.startsWith("event:")) {