Kanshō/Scope escalation request

Scope escalation request

The agent asks for additional capability. The card makes the cost of the change explicit: current scope, what changes, the risk tier, and how long the grant holds.

Included in the single kansho full pack. Components are not offered as separate installs.

Medium-risk write request

Live demo — buttons update the outcome below
Scope escalationSE-44Medium risk14:14
Plan & dispatchclaude-opus-4-7· M-2014

Needs to write the compaction migration to staging.audit_chunks to verify the row delta.

The current grant covers read on audit.logs but not write on audit.chunks. Without this, the rest of the mission can't proceed.

  • postgres/audit.chunks
    readwritecreate
  • postgres/audit.logs
    readread-bulk
TTL 30m· remembers decision

Demo outcome: pending

High-risk — production secret

Static preview — buttons are intentionally disabled
Scope escalationSE-45High risk14:16
Vault rotatorclaude-haiku-4-5· M-2020

Requested rotate on production-scope keys for the upcoming quarterly key rotation.

Quarterly rotation grants are typically auto-approved during the maintenance window, but this request lands 26 minutes outside the window.

  • vault/prod/sk-*
    readrotateread
TTL 15m
Static preview — actions disabled

Included components

This page is the canonical destination for these components. All ship in the single Kansho pack.

Scope chip

components/ui/scope-chip.tsx

Scope escalation request

components/control-plane/scope-escalation-request.tsx

Supporting sources

These installed helpers belong to components documented on this page. They do not increase the public component count.

components/ui/tone.ts

Shared permission tone type and class mapping.

Component documentation

Scope chip

components/ui/scope-chip.tsx

Purpose

Displays a permission scope with a compact tone marker.

Appropriate use

Use within permission summaries and escalation requests where the scope string must remain visible.

Example

components/ui/scope-chip.tsx has a representative live example in the "Medium-risk write request" section on /components/scope-escalation.

States

Supports allowed, scoped, denied, and neutral tones with an optional leading icon.

API and props

ScopeChip accepts scope, tone, icon, and className.

Dependencies

React, the shared tone map, and the Kansho cn utility.

Accessibility

The scope is visible text; tone and icon are supplemental and do not replace the label.

Limitations

Long scope strings are not truncated, so callers must provide enough horizontal space or their own wrapping strategy.

Source

Source: components/ui/scope-chip.tsx.

Full pack

components/ui/scope-chip.tsx is documented at /components/scope-escalation and installs only through the single Kansho full pack; no individual component install is offered.

Scope escalation request

components/control-plane/scope-escalation-request.tsx

Purpose

Presents a time-bounded permission escalation with risk, scope changes, rationale, and decisions.

Appropriate use

Use at a human permission gate when approve, deny, and optional always-allow decisions can be applied by the host.

Example

components/control-plane/scope-escalation-request.tsx has a representative live example in the "Medium-risk write request" section on /components/scope-escalation.

States

Risk is low, medium, or high; scope deltas carry add/remove access; approval actions can be live or explicitly disabled by staticPreview.

API and props

ScopeEscalationRequest accepts id, agent, rationale, detail, risk, scopeDelta, ttl, remember, mission, staticPreview, onApprove, onDeny, onAlwaysAllow, requestedAt, and className.

Dependencies

Direct imports are React, Lucide icons, AgentDot, ApprovalActions, ScopeChip, Tag, ApprovalCardBase, and cn.

Accessibility

Risk and scope changes use text labels, card structure keeps reading order, and static-preview decisions are disabled rather than inert.

Limitations

It does not enforce policy, persist approval, count down TTL, confirm always-allow, or report pending/error results.

Source

Source: components/control-plane/scope-escalation-request.tsx.

Full pack

components/control-plane/scope-escalation-request.tsx is documented at /components/scope-escalation and installs only through the single Kansho full pack; no individual component install is offered.