kiro-discord-bot

Operation Matrix #

Use this matrix before releasing changes that affect agent engines, Discord commands, usage accounting, thread agents, or MCP/audit behavior.

Engine Scopes #

ScopeKiroOMP
New channelUses AGENT_ENGINE unless /engine stores an override.Same; requires AGENT_ENGINE=omp or /engine omp with OMP enabled.
Existing channelUses stored Session.Engine; empty means runtime default.Same. Engine switch starts a fresh ACP session and replays recent chat context.
New threadInherits parent channel engine unless the thread stores an override.Same.
Existing threadUses thread override first, then parent channel engine.Same.

Command Behavior #

CommandChannelThreadInactive KiroInactive OMP
/engineShows or switches channel engine.Shows or switches thread override.Works if Kiro is enabled.Works if OMP is enabled.
/modelsLists channel agent models.Lists thread agent models.Falls back to kiro-cli chat --list-models.Requires an active ACP session because models come from session/new.
/model <id>Switches channel model dynamically when possible, otherwise restarts.Respawns thread agent with the model.Validates through Kiro CLI fallback.Validates through the active ACP session.
/agentLists channel agent modes.Lists thread agent modes.Requires active session.Requires active session.
/agent <id>Switches channel agent mode.Switches thread agent mode.Uses ACP session/set_mode.Uses ACP session/set_mode.
/statusShows engine, agent version, model, queue, context usage.Same for thread agent.Shows active Kiro version/model.Shows active OMP version/model.
/usagePrivate guild-wide report: self by default; Manage Guild/Administrator can aggregate all users or select another member.Same guild-wide scope and permission rules.Credits come from Kiro metering metadata.USD cost comes from OMP usage_update.
/usage-historyPrivate guild-wide detailed usage history with user/period/status/source filters; self-only unless requester has Manage Guild/Administrator.Same guild-wide scope and permission rules.Reads SQLite usage history.Reads SQLite usage history.
/audit promptUses a short-lived scoped agent and records usage under the Discord caller.Same, with thread target metadata.Uses channel engine.Uses channel engine.

Release Checklist #