Skip to content

Filter sidecar Haiku flows so session title generation stops leaking into the transcript #25

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Juliusolsson05 merged 1 commit into from
Apr 27, 2026
Merged

Filter sidecar Haiku flows so session title generation stops leaking into the transcript #25

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion packages/claude-code-headless
Open in desktop
Submodule claude-code-headless updated 17 files
+0 −18 package-lock.json
+0 −1 package.json
+22 −43 src/ClaudeCodeHeadless.ts
+0 −12 src/channels/ScreenChannel.ts
+0 −8 src/channels/types.ts
+0 −13 src/conditions/compaction.ts
+0 −52 src/conditions/evaluateClaudeConditions.ts
+0 −25 src/conditions/index.ts
+0 −20 src/conditions/permissionPrompt.ts
+0 −16 src/conditions/resumePrompt.ts
+0 −16 src/conditions/slashPicker.ts
+0 −19 src/conditions/trustDialog.ts
+0 −70 src/conditions/types.ts
+0 −17 src/index.ts
+149 −0 src/proxy/ClaudeProxyAdapter.ts
+411 −0 src/testing/verify-sidecar-haiku.ts
+0 −32 src/testing/verify.ts
37 changes: 36 additions & 1 deletion src/providers/claude/runtime/claudeSession.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -254,7 +254,42 @@ export class ClaudeSession extends EventEmitter {
// semantic events would still yield screen-sourced deltas
// (source='screen', confidence='fallback') — but consumers
// that opted into proxy specifically want the richer stream.
proxy: this.useProxy ? {} : undefined,
proxy: this.useProxy
? {
// Sidecar Haiku filtering — see ClaudeProxyAdapter for the
// full rationale. Without this, Claude Code's auxiliary
// Haiku calls (session title generation, compaction
// summaries, hook agents, teleport title-and-branch) leak
// into the visible transcript as orphan ghost entries
// because Claude Code never writes them to the JSONL
// rollout, so the renderer's ghost-supersede path can
// never fire.
//
// We default to assuming the user is on a non-Haiku
// primary model. Why this is OK as a default:
//
// * The vast majority of cc-shell users today run
// Sonnet/Opus; the Anthropic Max / Pro defaults land
// here.
// * The filter only fires when BOTH the flow's model
// matches `/haiku/i` AND the session model does NOT
// — so if the user IS on Haiku as primary, they need
// to opt out. The escape hatch is the
// `CC_SHELL_PRIMARY_MODEL` env var below; setting it
// to a Haiku model id disables filtering.
// * The exact returned string doesn't matter as long as
// it doesn't match `/haiku/i`. The adapter only uses
// it for the pattern test, never as an authoritative
// model id.
//
// TODO(model-from-screen): replace this constant default
// with parsing of Claude Code's header line ("Opus 4.7
// (1M context) …") so we always know the actual primary
// model and the env-var escape hatch becomes redundant.
getSessionModel: () =>
process.env.CC_SHELL_PRIMARY_MODEL ?? 'claude-opus-4-7',
}
: undefined,
})

// Pipe proxy transport events into the adapter. Only fires when
Expand Down