[BUG] Permission request fails to show for sub-agent runs in Claude Code

[Troyanovsky]

What version of HAPI is running?

0.16.7

What platform is your computer?

Darwin 24.6.0 Arm64

What issue are you seeing?

In Claude Code, when a sub-agent is dispatched and the agent requests permission. The status indicator shows an orange premission requested, but the permission option don't show up, so I can't give permission to continue the run.
But when I go to the local terminal and double press space bar to continue on local, the sub-agent run will be interrupted.

What steps can reproduce the bug?

Launch claude code with hapi
In remote mode, launch a sub-agent for a task that may request permissions
When the sub-agent needs permissions, the issue happens.

What is the expected behavior?

• When the sub-agent needs permissions, show the permission option picker correctly.
• Or alternatively, don't interrupt the sub-agent session when the user switches to local mode to approve the permission request.

Additional information

No response

[github-actions]

Thanks for the report. I found the relevant path in the current code.

The orange "permission required" status can appear even if the picker is not rendered: the status bar checks agentState.requests directly, while the permission buttons only render when the chat reducer attaches that pending request to a visible tool card. For Claude sub-agents, HAPI groups sidechain output under the parent Task tool and has a special path to show pending child permission blocks outside the collapsed Task details. So this looks like a web rendering/reducer gap around sub-agent Task children, not a missing hub permission RPC path.

I also verified the local fallback behavior you described: switching from remote to local via double-space currently requests a remote-session switch, aborts the remote Claude run, and resets/cancels pending permission requests. That means approving locally during an in-flight sub-agent permission request can interrupt the run with current behavior.

Relevant code:

• cli/src/claude/sdk/query.ts:266 - Claude can_use_tool control requests call HAPI's canCallTool callback.
• cli/src/claude/utils/permissionHandler.ts:312 - permission flow resolves a Claude tool-call id before creating the pending request.
• cli/src/modules/common/permission/BasePermissionHandler.ts:129 - pending permission requests are stored in agentState.requests.
• web/src/components/AssistantChat/StatusBar.tsx:48 - orange permission status is based directly on agentState.requests.
• web/src/chat/reducer.ts:54 - permission-only tool cards are only created when no matching transcript tool/result exists.
• web/src/chat/reducerTimeline.ts:262 - Task sidechain messages are reduced as children of the parent Task tool.
• web/src/components/AssistantChat/messages/ToolMessage.tsx:33 - pending permission child blocks under Task are intended to render outside collapsed Task details.
• web/src/components/ToolCard/PermissionFooter.tsx:143 - approval/deny buttons post the permission response.
• cli/src/claude/claudeRemoteLauncher.ts:56 - remote-to-local switch path aborts the remote run.
• cli/src/claude/utils/permissionHandler.ts:470 - permission reset marks pending requests as canceled with Session switched to local mode.

Need more info:

• A debug log around the permission request and double-space switch, if available.
• A screenshot of the web session when the orange permission status is visible but no picker is shown.
• Whether the missing picker is inside a collapsed Task details section or absent entirely.

---

HAPI Bot