SlashCommandResult
Defined in: _worktrees/docs-release/gaunt-sloth/packages/agent/src/modules/slashCommands.ts:319
The effects a dispatched command can request. The component interprets these; the command itself stays pure (no React, no I/O) so it is trivially testable.
Properties
Section titled “Properties”approvals?
Section titled “approvals?”
optionalapprovals?: {show:true; } | {rung:"write"|"auto"|"manual"|"assisted"|"bypass"; } | {trust:McpTrustRequest; } | {undeny: {index:number; }; }
Defined in: _worktrees/docs-release/gaunt-sloth/packages/agent/src/modules/slashCommands.ts:357
CFG-27 — a requested action from /approvals. { show: true } asks the surface to DISPLAY
the current posture; { rung } asks it to switch the session to that rung. The command itself
stays pure — it cannot read the runner’s posture — so the surface owns the apply + the
resulting-state notice (mirroring how /verbose / /debug defer their state-aware copy to
the App).
There is deliberately NO toggle action: with five ordered rungs a flip has no honest
meaning, which is also why /auto-approve and /bypass-approve were retired with the
three-mode vocabulary that gave them their names.
EXT-70 adds { trust } — start or stop believing specific annotation hints from one MCP
server (§4.7.1). It takes the same route for the same reason: the command cannot read or write
the runner’s posture, so it states the request and the surface applies it and reports what
landed.
clearTranscript?
Section titled “clearTranscript?”
optionalclearTranscript?:boolean
Defined in: _worktrees/docs-release/gaunt-sloth/packages/agent/src/modules/slashCommands.ts:330
When true, the component clears the transcript.
optionalexit?:boolean
Defined in: _worktrees/docs-release/gaunt-sloth/packages/agent/src/modules/slashCommands.ts:372
When true, the component quits the app (runs onExit).
level?
Section titled “level?”
optionallevel?:string
Defined in: _worktrees/docs-release/gaunt-sloth/packages/agent/src/modules/slashCommands.ts:328
Level for the system line; defaults to ‘info’.
message?
Section titled “message?”
optionalmessage?:string
Defined in: _worktrees/docs-release/gaunt-sloth/packages/agent/src/modules/slashCommands.ts:326
A terse system line (incidental/error output); commands prefer notice.
notice?
Section titled “notice?”
optionalnotice?:SlashCommandNotice
Defined in: _worktrees/docs-release/gaunt-sloth/packages/agent/src/modules/slashCommands.ts:324
A structured notice to commit into the transcript (the command’s user-visible feedback).
Preferred over message for all commands so feedback is consistent and noticeable (TUI-C14).
reprintReasoning?
Section titled “reprintReasoning?”
optionalreprintReasoning?:object
Defined in: _worktrees/docs-release/gaunt-sloth/packages/agent/src/modules/slashCommands.ts:370
TUI-C18 — a committed turn’s thinking to REPRINT into the transcript (the /reasoning command).
Recall rather than retro-mutation: a fresh block reusing the TUI-C15 💭/gutter styling appears
at the bottom of the conversation, where the user is looking, instead of changing a turn they
have scrolled away from. The App turns this into a reasoning transcript item; the command stays
pure (it resolves the target from turnReasonings). Absent when the command instead returns a
friendly notice (no reasoning / out-of-range).
reasoning
Section titled “reasoning”reasoning:
string
turnNumber
Section titled “turnNumber”turnNumber:
number
setMouse?
Section titled “setMouse?”
optionalsetMouse?:boolean
Defined in: _worktrees/docs-release/gaunt-sloth/packages/agent/src/modules/slashCommands.ts:340
TUI-C37 — the state /mouse asks the surface to move terminal mouse reporting to. The command
stays pure (it cannot write escape sequences), so the App applies it and owns the actual
enable/disable, the same division /approvals uses for the runner’s posture.
toggleDebug?
Section titled “toggleDebug?”
optionaltoggleDebug?:boolean
Defined in: _worktrees/docs-release/gaunt-sloth/packages/agent/src/modules/slashCommands.ts:332
When true, the component toggles the docked debug panel (the debug views).
toggleTools?
Section titled “toggleTools?”
optionaltoggleTools?:boolean
Defined in: _worktrees/docs-release/gaunt-sloth/packages/agent/src/modules/slashCommands.ts:334
When true, the component toggles tool-call panels between collapsed and expanded.