Crate vigil_ui_protocol 

vigil-ui-protocol

I08a(ADR 0008):framework-agnostic UI protocol —— CLI / Tauri / Web / 测试 harness 都通过本 crate 的 UiCommand / UiResponse / UiError 交互。

安全不变量(ADR §I-8.1 ~ §I-8.6):

• 协议层不直接持 Arc<Ledger>;dispatcher 是集成层的责任
• UiError 所有变种不含 raw secret / 后端原始错误文本
• 写命令必须 capability=ui.write,静态检查
• SandboxProfile.profile_json 必须 JCS 规范化后 hash

Structs

ApprovalDetailDto

Approval 完整细节。

ApprovalResolutionDto

Approval resolve 结果。

ApprovalSummary

Approval 列表项(不含 effect vector,节省传输)。

ApproveServerCommandDriftReq

ApproveServerCommandDrift 参数。

ApproveToolDriftReq

ApproveToolDrift 参数。

ApproveToolReq

ApproveTool 参数(首次批准)。

BindServerSandboxProfileReq

BindServerSandboxProfile 参数。

ChainVerifyReport

hash chain verify 报告。

EventDetail

单条事件的完整 payload(从 events 表直读,payload 已 JCS 规范化 + 脱敏)。

EventSummary

Activity Feed 单行摘要(不含完整 payload)。

ExportSessionReplayReq

ISS-018 — ExportSessionReplay 参数。

FtsSearchReq

FtsSearch 参数。

GetApprovalDetailReq

GetApprovalDetail 参数。

GetEventDetailReq

GetEventDetail 参数。

GetSandboxProfileReq

GetSandboxProfile 参数。

GetServerOnboardingReq

GetServerOnboarding 参数。

ListPendingApprovalsReq

ListPendingApprovals 参数。

ListPrivacyFindingsReq

ListPrivacyFindings 参数(ISS-017)。

ListRecentEventsReq

ListRecentEvents 参数。

ListSessionsReq

ListSessions 参数。

PrivacyFindingDto

ISS-014 — Privacy Findings 区块单项(按 PrivacyLabel 聚合)。

PrivacyFindingsDto

ISS-017 — Privacy Findings 面板的聚合 payload。

RedactionScanSummaryDto

ISS-017 — Privacy Findings 面板单条 scan 摘要(不含原文)。

RejectServerCommandDriftReq

RejectServerCommandDrift 参数。

RejectToolDriftReq

RejectToolDrift 参数。

ReplaySessionReq

ReplaySession 参数。

ResolveApprovalReq

ResolveApproval 参数。

SandboxProfileUpsertDto

Sandbox profile upsert 结果。

SecretBindingSummary

某 server 的 secret binding 概览(辅助 onboarding)。

SessionExportDto

ISS-018 — Safe Export 输出 DTO。

SessionReplay

Session replay 结果。

SessionSummary

Session 列表项。

UpsertSandboxProfileReq

UpsertSandboxProfile 参数。

Enums

ApprovalAction

Resolve approval 的动作。

Capability

每条命令所需的权限级别。

ExportFormat

ISS-018 — Safe Export 输出格式。

UiCommand

UI 层的所有命令。每个变种带自己的 payload struct。

UiError

UI 协议错误。所有变种不得含真实 secret 或原始 SQL / keyring 后端文本。 LedgerError 只承载 AuditError::Display 的结果,AuditError 自身已结构化脱敏。

UiResponse

UI 响应的 tagged union。

Constants

ITERATION

当前迭代号。