β¨ feat(hetero): add --raw-dump to persist agent raw stream-json for debugging#15602
Merged
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
275f5ff to
19c2dee
Compare
Codecov Reportβ
All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## canary #15602 +/- ##
==========================================
+ Coverage 65.82% 67.13% +1.31%
==========================================
Files 3270 3353 +83
Lines 320011 338490 +18479
Branches 27141 35046 +7905
==========================================
+ Hits 210651 227258 +16607
- Misses 109169 111041 +1872
Partials 191 191
Flags with carried forward coverage won't be shown. Click here to find out more.
π New features to boost your workflow:
|
β¦ebugging The remote-device path (`spawnLhHeteroExec`) leaves no local execution record: `lh hetero exec` consumes the agent's stdout internally and only POSTs adapted events to the server, so a misbehaving remote run can't be inspected. The adapted/ingested view also can't distinguish a CC-side empty `tool_result` from an adapter extraction bug. Add `lh hetero exec --raw-dump <dir>`: spawnAgent gains an `onRawStdout` tee that captures the child's untouched stdout BEFORE the adapter; the CLI writes it (plus stderr + a meta.json) to `<dir>/<timestamp>-<operationId>/`, one file pair per spawn attempt. Fully best-effort β a dump failure never affects the run or exit code. Wire the desktop device path to pass `--raw-dump` (gated by the existing `shouldTraceCliOutput` toggle, into `resolveTraceRootDir`), so remote-device CC runs now leave a raw stream on the device β the same toggle/location the local trace path already uses. Reusable later for the server sandbox path. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
19c2dee to
7feb6bb
Compare
This was referenced Jun 9, 2026
arvinxx
added a commit
that referenced
this pull request
Jun 10, 2026
# π LobeHub Release (20260610) **Release Date:** June 10, 2026 **Since v2.2.2:** 131 merged PRs Β· 13 contributors > This weekly release strengthens agent collaboration across cloud, desktop, CLI, and workspace flows, with steadier runtime behavior and a broader foundation for workspace-scoped data. --- ## β¨ Highlights - **Agent execution across devices** β Unifies per-device working directories, project skill discovery, and sub-agent suspend/resume behavior across server, QStash, and device RPC flows. (#15543, #15566, #15481, #15620, #15591) - **Connector and sandbox platform** β Expands connector permissions, custom OAuth MCP connector onboarding, sandbox provider support, and user-uploaded file sync into cloud sandbox runs. (#15463, #15546, #15184, #15550) - **Desktop and CLI reliability** β Fixes desktop cold-start, auto-update, Windows build, CLI skill discovery, and `lh connect` agent dispatch paths. (#15547, #15525, #15527, #15562, #15632, #15634) - **Pages and sharing** β Refreshes topic sharing, improves Page Editor layout behavior, and routes Page Agent tool execution through the server-side editor path. (#15581, #15556, #15588, #15023, #15610) - **Model availability and provider updates** β Adds user-scoped LobeHub model availability, Claude Fable 5, Qwen thinking preservation, and MiniMax M3 updates. (#15590, #15639, #13494, #15376) --- ## ποΈ Core Product & Architecture ### Agent Runtime & Heterogeneous Agents - Improves sub-agent lifecycle handling, including async suspend/resume, queue-mode QStash resume delivery, and blocking nested sub-agent calls. (#15481, #15620, #15575) - Stabilizes heterogeneous agent ingestion and streaming with raw stream dumps, per-turn usage, image forwarding on regenerate, and duplicate-text fixes. (#15602, #15577, #15592, #15585) - Adds execution-device and working-directory controls across device RPC, legacy defaults, and remote-spawned Claude Code sessions. (#15543, #15566, #15591, #15572) - Improves runtime diagnostics and compatibility, including Gemini multimodal output capture, abort stream semantics, and trace quality analysis. (#15535, #13677, #15508) --- ## π± Platforms, Integrations & UX ### Connectors, Sandbox & Tools - Ships API-level connector tool permissions, custom OAuth MCP connector onboarding, and connector-first runtime execution. (#15463, #15546) - Adds sandbox provider support, cloud sandbox file sync, and safer external URL file input handling with SSRF validation. (#15184, #15550, #12657) - Improves tool visibility and execution with pinned app-fixed tools, ANSI output rendering, gateway-tunneled MCP calls, and automatic headless tool runs. (#15509, #15516, #15469, #15492) ### Desktop, CLI & Web UX - Restores desktop startup and reload behavior, preserves IPC error causes, and keeps the tab bar new-tab action visible across routes. (#15547, #15597, #15638) - Fixes desktop update and build stability for browser quit guards, macOS update signing, and Windows Visual Studio detection. (#15525, #15527, #15562) - Shows the plan-limit upgrade UI on desktop builds. (#15628) - Adds the Agent Run delivery checker and fixes CLI device dispatch plus skill list/search output. (#15489, #15634, #15632) - Refreshes onboarding, auth source preservation, topic UI states, referral/Fable campaign copy, and chat-input control bar behavior. (#15629, #15544, #15573, #15614, #15616, #15617, #15622, #15643) --- ## π Security, Reliability & Rollout Notes - External URL file input now includes SSRF validation for safer Google file handling. (#12657) - Database workspace-scope migrations are part of this release; self-hosted operators should run the normal migration path before serving the updated app. (#15446, #15465, #15468, #15472) - The release branch was re-cut from `canary` and includes the latest `main` release-version commit so `v2.2.2` is the verified compare base. --- ## π₯ Contributors @ONLY-yours, @sxjeru, @hardy-one, @xujingli, @hezhijie0327, @Coooolfan, @arvinxx, @tjx666, @Innei, @rivertwilight, @rdmclin2, @cy948, @AmAzing129 **Full Changelog**: v2.2.2...release/weekly-20260610-recut-3
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
π» Change Type
π Related Issue
Part of LOBE-10157. Debugging tooling follow-up to #15585 (which fixed the cross-message text duplication). This lands the raw-stream capture needed to root-cause the remaining bugs (notably the empty
tool_result).π Description of Change
The remote-device path (
spawnLhHeteroExec) leaves no local execution record:lh hetero execconsumes the agent process's stdout internally and only POSTs adapted events to the server, so a misbehaving remote run can't be inspected. The adapted/ingested view also can't distinguish a CC-side emptytool_resultfrom an adapter extraction bug.Adds
lh hetero exec --raw-dump <dir>:spawnAgentgains anonRawStdouttee that captures the child's untouched stdout before the adapter. Best-effort: a throwing sink can't break the stream.--raw-dump <dir>writes the raw stream to<dir>/<timestamp>-<operationId>/, with<attempt>.stdout.jsonl/<attempt>.stderr.log(the resume retry is a second attempt) plus ameta.json. Independent of--renderand the server-ingest path; a dump failure never affects the run or exit code.spawnLhHeteroExec): passes--raw-dumpgated by the existingshouldTraceCliOutputtoggle, intoresolveTraceRootDirβ so remote-device CC runs now leave a raw stream on the device, in the same location/toggle the local trace path already uses.spawnHeteroSandbox) to capture remote-server runs the same way.π§ͺ How to Test
Added/updated tests
spawnAgent.test.ts:onRawStdoutreceives the raw bytes verbatim (pre-adapter); a throwing sink doesn't disrupt the stream.hetero.test.ts:--raw-dumpcreates the session folder +meta.json, wiresonRawStdoutintospawnAgent, and tees stderr.Verified end-to-end against the real
claudeCLI: the dump contains the untouched CC stream-json (rawtool_resultcontent,message.id, raw blocks).π Additional Information
The capture is the missing piece for diagnosing LOBE-10157 Bug 2 (empty
tool_result), which was shown not to be an adapter extraction bug and needs the actual failing run's raw stream to root-cause.