Skip to content
Merged
Show file tree
Hide file tree
Changes from 14 commits
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
4250ad9
feat(cli): track config scope for each permission key
brunoagatao Jul 23, 2026
073df16
feat(cli): resolve why a tool call was auto-approved
brunoagatao Jul 23, 2026
c1530a9
feat(cli): record tool-call approval provenance on tool metadata
brunoagatao Jul 23, 2026
e389860
feat(ui): show why a tool call was auto-approved
brunoagatao Jul 23, 2026
e72068d
feat(vscode): surface tool auto-approval provenance in chat
brunoagatao Jul 23, 2026
59782ae
docs: note project config reload for auto-approve
brunoagatao Jul 23, 2026
85dbf44
chore: changeset for tool auto-approval provenance
brunoagatao Jul 23, 2026
ff02a97
test(cli): cover approval-provenance metadata preservation
brunoagatao Jul 23, 2026
69960b1
Merge remote-tracking branch 'origin/main' into feat/explain-tool-aut…
brunoagatao Jul 23, 2026
75862be
refactor(ui): move tool-approval provenance UI into kilo-owned packages
brunoagatao Jul 24, 2026
207fecc
fix(ui): restore unrelated deleteQueued string dropped during i18n move
brunoagatao Jul 24, 2026
7f37d01
fix(cli): tag permission rules by origin so auto-approval provenance …
brunoagatao Jul 24, 2026
b36b24e
fix(cli): track auto-approval provenance per permission pattern, not …
brunoagatao Jul 24, 2026
0eb9fac
Merge remote-tracking branch 'origin/main' into feat/explain-tool-aut…
brunoagatao Jul 24, 2026
d4da7dd
chore(vscode): format AssistantMessage import
brunoagatao Jul 24, 2026
6edf6ca
Merge branch 'main' into feat/explain-tool-auto-approval
brunoagatao Jul 24, 2026
9c16457
Merge remote-tracking branch 'origin/main' into feat/explain-tool-aut…
brunoagatao Jul 24, 2026
c3a38ea
Merge branch 'feat/explain-tool-auto-approval' of github.com:Kilo-Org…
brunoagatao Jul 24, 2026
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
5 changes: 5 additions & 0 deletions .changeset/tool-auto-approval-provenance.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"kilo-code": minor
---

Show why a tool call was auto-approved. Expanding a tool call now explains whether it ran automatically or after your approval, and which rule allowed it — from your agent, the project config, your global config, or auto-approve (YOLO) mode.
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,10 @@ description: "Configure automatic approval settings for Kilo Code operations"

Auto-approve settings speed up your workflow by eliminating repetitive confirmation prompts, but they significantly increase security risks. The VS Code extension and CLI share the same permission model; choose the tab that matches how you configure Kilo Code.

{% callout type="note" %}
**Editing project config while a session is running:** Kilo caches project-level `kilo.jsonc` / `kilo.json` (in `.kilo/`) when it first loads a workspace, and does not re-read it on every prompt. If you add, change, or remove a project permission rule while the backend is already running, reload the VS Code window (or start a fresh CLI session) for the change to take effect. Until then, Kilo keeps using the previously loaded rules — so an auto-approved call may still cite a project rule you just edited. Global config (`~/.config/kilo/`) is reloaded automatically.
Comment thread
brunoagatao marked this conversation as resolved.
Resolved
{% /callout %}

{% tabs %}
{% tab label="VSCode" %}

Expand Down
22 changes: 22 additions & 0 deletions packages/kilo-ui/src/components/basic-tool.css
Original file line number Diff line number Diff line change
Expand Up @@ -494,3 +494,25 @@ html[data-theme="kilo-vscode"] [data-component="tool-part-wrapper"][data-part-ty
}
}
}

/* "why was this allowed" line inside a tool's expanded body */
[data-slot="tool-approval-line"] {
display: flex;
flex-wrap: wrap;
align-items: baseline;
gap: 4px;
padding: 4px 0 6px;
font-family: var(--font-family-sans);
font-size: var(--font-size-small);
line-height: var(--line-height-normal);
color: var(--text-weak);

[data-slot="tool-approval-decision"] {
font-weight: var(--font-weight-medium);
color: var(--text-strong);
}

[data-slot="tool-approval-rule"] {
font-family: var(--font-family-mono);
}
}
16 changes: 13 additions & 3 deletions packages/kilo-ui/src/components/basic-tool.tsx
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
import { Show } from "solid-js"
import { BasicTool as Base, GenericTool } from "@opencode-ai/ui/basic-tool"
import type { BasicToolProps as BaseProps, TriggerTitle } from "@opencode-ai/ui/basic-tool"
import { toolOpenKey, readToolOpen, writeToolOpen } from "./tool-open-state"
import { useToolApproval, ToolApprovalLine } from "./tool-approval"

export { GenericTool }
export type { TriggerTitle }
Expand All @@ -20,16 +22,24 @@ export function initialOpen(props: OpenProps) {
export function BasicTool(props: BasicToolProps) {
const key = () => toolOpenKey(props)
const initial = () => initialOpen(props)
const approval = useToolApproval()
const change = (open: boolean) => {
writeToolOpen(key(), open)
props.onOpenChange?.(open)
}
if (!("children" in props)) {
// The "why was this allowed" line lives in the expanded body, above any tool-specific details.
const details = () => (
<div data-slot="basic-tool-details">
<Show when={approval()}>{(value) => <ToolApprovalLine display={value()} />}</Show>
{props.children}
</div>
)
if (!("children" in props) && !approval()) {
return <Base {...props} defaultOpen={initial()} retainDetails={props.defer} onOpenChange={change} />
}
return (
<Base {...props} defaultOpen={initial()} retainDetails={props.defer} onOpenChange={change}>
<div data-slot="basic-tool-details">{props.children}</div>
<Base {...props} defaultOpen={initial()} retainDetails={props.defer} onOpenChange={change} hasDetails>
{details()}
</Base>
)
}
44 changes: 24 additions & 20 deletions packages/kilo-ui/src/components/message-part.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,8 @@ import { checksum } from "@opencode-ai/core/util/encode"
import { Tooltip } from "./tooltip"
import { IconButton } from "./icon-button"
import { TextShimmer } from "@opencode-ai/ui/text-shimmer"
import { ToolApprovalProvider, resolveToolApproval } from "./tool-approval"
export { ToolApprovalProvider, resolveToolApproval } from "./tool-approval"
import { GrowBox } from "./grow-box"
import { COLLAPSIBLE_SPRING } from "./motion"
import { busy, createThrottledValue, useToolFade, useContextToolPending } from "./tool-utils"
Expand Down Expand Up @@ -1307,26 +1309,28 @@ PART_MAPPING["tool"] = function ToolPartDisplay(props) {
}}
</Match>
<Match when={true}>
<Dynamic
component={render()}
input={input()}
tool={part.tool}
partID={part.id}
callID={part.callID}
metadata={meta()}
partMetadata={top()}
// @ts-expect-error
output={part.state.output}
status={part.state.status}
// @ts-expect-error
attachments={part.state.attachments}
hideDetails={props.hideDetails}
defaultOpen={props.defaultOpen}
forceOpen={props.forceOpen}
forceOpenFile={props.forceOpenFile}
animate
reveal={props.animate}
/>
<ToolApprovalProvider value={() => resolveToolApproval(meta(), i18n.t as (k: string, p?: Record<string, string | number | boolean>) => string)}>
<Dynamic
component={render()}
input={input()}
tool={part.tool}
partID={part.id}
callID={part.callID}
metadata={meta()}
partMetadata={top()}
// @ts-expect-error
output={part.state.output}
status={part.state.status}
// @ts-expect-error
attachments={part.state.attachments}
hideDetails={props.hideDetails}
defaultOpen={props.defaultOpen}
forceOpen={props.forceOpen}
forceOpenFile={props.forceOpenFile}
animate
reveal={props.animate}
/>
</ToolApprovalProvider>
</Match>
</Switch>
</div>
Expand Down
86 changes: 86 additions & 0 deletions packages/kilo-ui/src/components/tool-approval.tsx
Original file line number Diff line number Diff line change
@@ -0,0 +1,86 @@
import { createContext, useContext, Show, type Accessor, type ParentProps } from "solid-js"

/**
* Explains why a tool call was auto-approved, inside the expanded tool row.
*
* The backend records this on the tool part's `state.metadata.approval`. The display strings are
* resolved by the caller (which owns the localized `t`) and carried on the context, so this stays
* free of any i18n key coupling.
*/
export type ToolApproval = {
source: "agent" | "global" | "project" | "yolo" | "session" | "manual" | "default"
agent?: string
rule?: { permission: string; pattern: string; action: string }
}

/** Pre-resolved, localized text plus the raw approval, supplied by the caller. */
export type ToolApprovalDisplay = {
approval: ToolApproval
decision: string
source?: string
rule?: string
}

const SOURCE_KEYS = ["agent", "global", "project", "yolo", "session", "manual", "default"] as const

const Context = createContext<Accessor<ToolApprovalDisplay | undefined>>(() => undefined)

/** Provide the resolved approval to the tool row below. */
export function ToolApprovalProvider(props: ParentProps<{ value: Accessor<ToolApprovalDisplay | undefined> }>) {
return <Context.Provider value={props.value}>{props.children}</Context.Provider>
}

export function useToolApproval() {
return useContext(Context)
}

/** Read the raw approval payload off a tool part's metadata, if present. */
export function toolApprovalFrom(metadata: Record<string, unknown> | undefined): ToolApproval | undefined {
const value = metadata?.approval
if (!value || typeof value !== "object") return undefined
const approval = value as ToolApproval
return SOURCE_KEYS.includes(approval.source) ? approval : undefined
}

type Translate = (key: string, params?: Record<string, string | number | boolean>) => string

/** Resolve an approval read off metadata into localized display text via the caller's `t`. */
export function resolveToolApproval(
metadata: Record<string, unknown> | undefined,
t: Translate,
): ToolApprovalDisplay | undefined {
const approval = toolApprovalFrom(metadata)
if (!approval) return undefined
const sourceText = () => {
if (approval.source === "agent")
return approval.agent
? t("ui.approval.source.agent", { agent: approval.agent })
: t("ui.approval.source.agent.default")
if (approval.source === "manual") return undefined
return t(`ui.approval.source.${approval.source}`)
}
return {
approval,
decision: approval.source === "manual" ? t("ui.approval.manual") : t("ui.approval.auto"),
source: sourceText(),
rule: approval.rule
? t("ui.approval.rule", { permission: approval.rule.permission, pattern: approval.rule.pattern })
: undefined,
}
}

/** The single "why was this allowed" line shown inside a tool row's expanded body. */
export function ToolApprovalLine(props: { display: ToolApprovalDisplay }) {
const manual = () => props.display.approval.source === "manual"
return (
<div data-slot="tool-approval-line" data-source={props.display.approval.source}>
<span data-slot="tool-approval-decision">{props.display.decision}</span>
<Show when={!manual()}>
<Show when={props.display.source}>
{(text) => <span data-slot="tool-approval-source">{text()}</span>}
</Show>
<Show when={props.display.rule}>{(text) => <span data-slot="tool-approval-rule">{text()}</span>}</Show>
</Show>
</div>
)
}
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@

import { Component, For, Show, createMemo, type JSX } from "solid-js"
import { Dynamic } from "solid-js/web"
import { Part, PART_MAPPING, ToolRegistry } from "@kilocode/kilo-ui/message-part"
import { Part, PART_MAPPING, ToolRegistry, ToolApprovalProvider, resolveToolApproval } from "@kilocode/kilo-ui/message-part"
import type { MessageFeedbackControls } from "@kilocode/kilo-ui/message-part"
import type {
AssistantMessage as SDKAssistantMessage,
Expand Down Expand Up @@ -119,22 +119,25 @@ type ToolStateProps = {
function TodoToolCard(props: { part: ToolPart; forceOpen?: boolean }) {
const render = ToolRegistry.render(props.part.tool)
const state = () => props.part.state as ToolStateProps
const language = useLanguage()
return (
<Show when={render}>
{(renderFn) => (
<Dynamic
component={renderFn()}
input={state()?.input ?? {}}
metadata={state()?.metadata ?? {}}
tool={props.part.tool}
partID={props.part.id}
callID={props.part.callID}
output={state()?.output}
status={state()?.status}
defaultOpen
forceOpen={props.forceOpen}
reveal={false}
/>
<ToolApprovalProvider value={() => resolveToolApproval(state()?.metadata, language.t)}>
<Dynamic
component={renderFn()}
input={state()?.input ?? {}}
metadata={state()?.metadata ?? {}}
tool={props.part.tool}
partID={props.part.id}
callID={props.part.callID}
output={state()?.output}
status={state()?.status}
defaultOpen
forceOpen={props.forceOpen}
reveal={false}
/>
</ToolApprovalProvider>
)}
</Show>
)
Expand All @@ -143,24 +146,27 @@ function TodoToolCard(props: { part: ToolPart; forceOpen?: boolean }) {
function BashToolCard(props: { part: ToolPart; defaultOpen: boolean; forceOpen?: boolean }) {
const render = ToolRegistry.render(props.part.tool)
const state = () => props.part.state as ToolStateProps
const language = useLanguage()
return (
<Show when={render}>
{(card) => (
<Dynamic
component={card() as unknown as Component<Record<string, unknown>>}
input={state()?.input ?? {}}
metadata={state()?.metadata ?? {}}
partMetadata={props.part.metadata ?? {}}
tool={props.part.tool}
partID={props.part.id}
callID={props.part.callID}
output={state()?.output}
status={state()?.status}
defaultOpen={props.defaultOpen}
forceOpen={props.forceOpen}
animate
reveal={state()?.status === "pending" || state()?.status === "running"}
/>
<ToolApprovalProvider value={() => resolveToolApproval(state()?.metadata, language.t)}>
<Dynamic
component={card() as unknown as Component<Record<string, unknown>>}
input={state()?.input ?? {}}
metadata={state()?.metadata ?? {}}
partMetadata={props.part.metadata ?? {}}
tool={props.part.tool}
partID={props.part.id}
callID={props.part.callID}
output={state()?.output}
status={state()?.status}
defaultOpen={props.defaultOpen}
forceOpen={props.forceOpen}
animate
reveal={state()?.status === "pending" || state()?.status === "running"}
/>
</ToolApprovalProvider>
)}
</Show>
)
Expand Down
10 changes: 10 additions & 0 deletions packages/kilo-vscode/webview-ui/src/i18n/ar.ts

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

10 changes: 10 additions & 0 deletions packages/kilo-vscode/webview-ui/src/i18n/br.ts

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

10 changes: 10 additions & 0 deletions packages/kilo-vscode/webview-ui/src/i18n/bs.ts

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

10 changes: 10 additions & 0 deletions packages/kilo-vscode/webview-ui/src/i18n/da.ts

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading
Loading