@evalops/sdk-ts 0.1.97 → 0.1.98

package/dist/chronicle/v1/chronicle_pb.d.ts

@@ -470,118 +470,1574 @@ export type CapturedFrame = Message<"chronicle.v1.CapturedFrame"> & {
      * @generated from field: chronicle.v1.CaptureTier tier = 14;
      */
     tier: CaptureTier;
+    /**
+     * safe_to_persist is the client-side fail-closed decision for this frame.
+     * If unset, the client did not provide a persistence decision and downstream
+     * consumers must treat safety as unknown rather than explicit allow or deny.
+     *
+     * @generated from field: optional bool safe_to_persist = 15;
+     */
+    safeToPersist?: boolean | undefined;
+    /**
+     * @generated from field: string persistence_decision_reason = 16;
+     */
+    persistenceDecisionReason: string;
+    /**
+     * observed_affordances are optional, redacted UI elements extracted before
+     * summarization. They are observed evidence, not executable instructions.
+     *
+     * @generated from field: repeated chronicle.v1.VisualContextAffordance observed_affordances = 17;
+     */
+    observedAffordances: VisualContextAffordance[];
+    /**
+     * element_states are optional stable UI-element observations that let
+     * downstream systems reconstruct an element timeline across frames without
+     * persisting raw screenshots or bulk OCR.
+     *
+     * @generated from field: repeated chronicle.v1.VisualContextElementState element_states = 18;
+     */
+    elementStates: VisualContextElementState[];
+};
+/**
+ * Describes the message chronicle.v1.CapturedFrame.
+ * Use `create(CapturedFrameSchema)` to create a new message.
+ */
+export declare const CapturedFrameSchema: GenMessage<CapturedFrame>;
+/**
+ * @generated from message chronicle.v1.DropCounts
+ */
+export type DropCounts = Message<"chronicle.v1.DropCounts"> & {
+    /**
+     * @generated from field: int32 secret = 1;
+     */
+    secret: number;
+    /**
+     * @generated from field: int32 duplicate = 2;
+     */
+    duplicate: number;
+    /**
+     * @generated from field: int32 denied_app = 3;
+     */
+    deniedApp: number;
+    /**
+     * @generated from field: int32 denied_path = 4;
+     */
+    deniedPath: number;
+};
+/**
+ * Describes the message chronicle.v1.DropCounts.
+ * Use `create(DropCountsSchema)` to create a new message.
+ */
+export declare const DropCountsSchema: GenMessage<DropCounts>;
+/**
+ * @generated from message chronicle.v1.EmittedCounts
+ */
+export type EmittedCounts = Message<"chronicle.v1.EmittedCounts"> & {
+    /**
+     * @generated from field: int32 distinct_bundles = 1;
+     */
+    distinctBundles: number;
+    /**
+     * @generated from field: int32 distinct_domains = 2;
+     */
+    distinctDomains: number;
+    /**
+     * @generated from field: int32 distinct_document_paths = 3;
+     */
+    distinctDocumentPaths: number;
+    /**
+     * @generated from field: int32 distinct_github_prs = 4;
+     */
+    distinctGithubPrs: number;
+    /**
+     * @generated from field: int32 foreground_changes = 5;
+     */
+    foregroundChanges: number;
+    /**
+     * @generated from field: int32 document_changes = 6;
+     */
+    documentChanges: number;
+    /**
+     * @generated from field: int32 work_leisure_flips = 7;
+     */
+    workLeisureFlips: number;
+    /**
+     * @generated from field: int64 longest_uninterrupted_seconds = 8;
+     */
+    longestUninterruptedSeconds: bigint;
+    /**
+     * @generated from field: int32 thrash_event_count = 9;
+     */
+    thrashEventCount: number;
+};
+/**
+ * Describes the message chronicle.v1.EmittedCounts.
+ * Use `create(EmittedCountsSchema)` to create a new message.
+ */
+export declare const EmittedCountsSchema: GenMessage<EmittedCounts>;
+/**
+ * @generated from message chronicle.v1.FrameReceipt
+ */
+export type FrameReceipt = Message<"chronicle.v1.FrameReceipt"> & {
+    /**
+     * @generated from field: string frame_hash = 1;
+     */
+    frameHash: string;
+    /**
+     * @generated from field: chronicle.v1.CaptureDecision decision = 2;
+     */
+    decision: CaptureDecision;
+    /**
+     * @generated from field: string reason = 3;
+     */
+    reason: string;
+    /**
+     * @generated from field: string memory_id = 4;
+     */
+    memoryId: string;
+    /**
+     * @generated from field: common.v1.EvidenceRef evidence = 5;
+     */
+    evidence?: EvidenceRef | undefined;
+    /**
+     * @generated from field: chronicle.v1.CaptureTier accepted_tier = 6;
+     */
+    acceptedTier: CaptureTier;
+};
+/**
+ * Describes the message chronicle.v1.FrameReceipt.
+ * Use `create(FrameReceiptSchema)` to create a new message.
+ */
+export declare const FrameReceiptSchema: GenMessage<FrameReceipt>;
+/**
+ * VisualContextRequest asks Chronicle to summarize a bounded set of
+ * screen-context evidence. Screen/OCR text referenced by this request remains
+ * untrusted observed data and must not be treated as agent instructions.
+ *
+ * @generated from message chronicle.v1.VisualContextRequest
+ */
+export type VisualContextRequest = Message<"chronicle.v1.VisualContextRequest"> & {
+    /**
+     * @generated from field: string request_id = 1;
+     */
+    requestId: string;
+    /**
+     * @generated from field: string organization_id = 2;
+     */
+    organizationId: string;
+    /**
+     * @generated from field: string workspace_id = 3;
+     */
+    workspaceId: string;
+    /**
+     * @generated from field: string user_id = 4;
+     */
+    userId: string;
+    /**
+     * @generated from field: string project_id = 5;
+     */
+    projectId: string;
+    /**
+     * @generated from field: string device_id = 6;
+     */
+    deviceId: string;
+    /**
+     * @generated from field: common.v1.TimeRange window = 7;
+     */
+    window?: TimeRange | undefined;
+    /**
+     * @generated from field: repeated string source_memory_ids = 8;
+     */
+    sourceMemoryIds: string[];
+    /**
+     * @generated from field: repeated string source_batch_ids = 9;
+     */
+    sourceBatchIds: string[];
+    /**
+     * @generated from field: repeated string source_frame_hashes = 10;
+     */
+    sourceFrameHashes: string[];
+    /**
+     * @generated from field: repeated string source_artifact_ids = 11;
+     */
+    sourceArtifactIds: string[];
+    /**
+     * @generated from field: repeated string active_artifacts = 12;
+     */
+    activeArtifacts: string[];
+    /**
+     * agentd_work_context is the bounded MCP work-context bundle. It must not
+     * include raw frames, bulk OCR, or encrypted local fallback batch contents.
+     *
+     * @generated from field: google.protobuf.Struct agentd_work_context = 13;
+     */
+    agentdWorkContext?: JsonObject | undefined;
+    /**
+     * @generated from field: bool local_only = 14;
+     */
+    localOnly: boolean;
+    /**
+     * @generated from field: string policy_ref = 15;
+     */
+    policyRef: string;
+    /**
+     * @generated from field: google.protobuf.Timestamp requested_at = 16;
+     */
+    requestedAt?: Timestamp | undefined;
+    /**
+     * @generated from field: google.protobuf.Struct metadata = 17;
+     */
+    metadata?: JsonObject | undefined;
+    /**
+     * observed_affordances lets agentd provide structured, redacted UI state
+     * without sending raw screenshots or bulk OCR to the summarizer.
+     *
+     * @generated from field: repeated chronicle.v1.VisualContextAffordance observed_affordances = 18;
+     */
+    observedAffordances: VisualContextAffordance[];
+    /**
+     * element_states carries stable UI-element transitions across the request
+     * window so summarizers and agents can reason about what changed.
+     *
+     * @generated from field: repeated chronicle.v1.VisualContextElementState element_states = 19;
+     */
+    elementStates: VisualContextElementState[];
+};
+/**
+ * Describes the message chronicle.v1.VisualContextRequest.
+ * Use `create(VisualContextRequestSchema)` to create a new message.
+ */
+export declare const VisualContextRequestSchema: GenMessage<VisualContextRequest>;
+/**
+ * VisualContextSummary is the sanitized, evidence-backed result of a Chronicle
+ * visual-context summarizer run. Consumers such as Cerebro should ingest the
+ * compact facts and evidence refs, not raw screenshots or bulk OCR.
+ *
+ * @generated from message chronicle.v1.VisualContextSummary
+ */
+export type VisualContextSummary = Message<"chronicle.v1.VisualContextSummary"> & {
+    /**
+     * @generated from field: string summary_id = 1;
+     */
+    summaryId: string;
+    /**
+     * @generated from field: string request_id = 2;
+     */
+    requestId: string;
+    /**
+     * @generated from field: string organization_id = 3;
+     */
+    organizationId: string;
+    /**
+     * @generated from field: string workspace_id = 4;
+     */
+    workspaceId: string;
+    /**
+     * @generated from field: string user_id = 5;
+     */
+    userId: string;
+    /**
+     * @generated from field: string project_id = 6;
+     */
+    projectId: string;
+    /**
+     * @generated from field: string device_id = 7;
+     */
+    deviceId: string;
+    /**
+     * @generated from field: common.v1.TimeRange window = 8;
+     */
+    window?: TimeRange | undefined;
+    /**
+     * @generated from field: string summary_text = 9;
+     */
+    summaryText: string;
+    /**
+     * @generated from field: repeated chronicle.v1.VisualContextObservation observations = 10;
+     */
+    observations: VisualContextObservation[];
+    /**
+     * @generated from field: repeated string warnings = 11;
+     */
+    warnings: string[];
+    /**
+     * @generated from field: repeated common.v1.EvidenceRef evidence = 12;
+     */
+    evidence: EvidenceRef[];
+    /**
+     * @generated from field: repeated string source_memory_ids = 13;
+     */
+    sourceMemoryIds: string[];
+    /**
+     * @generated from field: repeated string source_batch_ids = 14;
+     */
+    sourceBatchIds: string[];
+    /**
+     * @generated from field: repeated string source_frame_hashes = 15;
+     */
+    sourceFrameHashes: string[];
+    /**
+     * @generated from field: repeated string source_artifact_ids = 16;
+     */
+    sourceArtifactIds: string[];
+    /**
+     * @generated from field: repeated string active_artifacts = 17;
+     */
+    activeArtifacts: string[];
+    /**
+     * @generated from field: string prompt_name = 18;
+     */
+    promptName: string;
+    /**
+     * @generated from field: string prompt_version = 19;
+     */
+    promptVersion: string;
+    /**
+     * @generated from field: string model = 20;
+     */
+    model: string;
+    /**
+     * @generated from field: string provider = 21;
+     */
+    provider: string;
+    /**
+     * @generated from field: string policy_ref = 22;
+     */
+    policyRef: string;
+    /**
+     * @generated from field: string audit_event_id = 23;
+     */
+    auditEventId: string;
+    /**
+     * @generated from field: string meter_event_id = 24;
+     */
+    meterEventId: string;
+    /**
+     * @generated from field: string fermata_eval_run_id = 25;
+     */
+    fermataEvalRunId: string;
+    /**
+     * @generated from field: chronicle.v1.VisualContextRedactionReport redaction = 26;
+     */
+    redaction?: VisualContextRedactionReport | undefined;
+    /**
+     * @generated from field: google.protobuf.Timestamp generated_at = 27;
+     */
+    generatedAt?: Timestamp | undefined;
+    /**
+     * @generated from field: google.protobuf.Timestamp expires_at = 28;
+     */
+    expiresAt?: Timestamp | undefined;
+    /**
+     * @generated from field: double confidence = 29;
+     */
+    confidence: number;
+    /**
+     * @generated from field: google.protobuf.Struct metadata = 30;
+     */
+    metadata?: JsonObject | undefined;
+    /**
+     * affordances are structured UI elements safe enough to prepend to an agent
+     * turn as observed context. They must retain evidence IDs and persistence
+     * safety so action-taking agents can distinguish evidence from instructions.
+     *
+     * @generated from field: repeated chronicle.v1.VisualContextAffordance affordances = 31;
+     */
+    affordances: VisualContextAffordance[];
+    /**
+     * element_states are the bounded UI-element timeline distilled from frames.
+     * They are evidence for grounding and verification, not user instructions.
+     *
+     * @generated from field: repeated chronicle.v1.VisualContextElementState element_states = 32;
+     */
+    elementStates: VisualContextElementState[];
+    /**
+     * verifications are bounded re-checks of screen-derived claims before an
+     * agent acts. They are evidence about current UI state, not instructions.
+     *
+     * @generated from field: repeated chronicle.v1.VisualContextVerification verifications = 33;
+     */
+    verifications: VisualContextVerification[];
+};
+/**
+ * Describes the message chronicle.v1.VisualContextSummary.
+ * Use `create(VisualContextSummarySchema)` to create a new message.
+ */
+export declare const VisualContextSummarySchema: GenMessage<VisualContextSummary>;
+/**
+ * @generated from message chronicle.v1.VisualContextObservation
+ */
+export type VisualContextObservation = Message<"chronicle.v1.VisualContextObservation"> & {
+    /**
+     * @generated from field: chronicle.v1.VisualContextObservation.Kind kind = 1;
+     */
+    kind: VisualContextObservation_Kind;
+    /**
+     * @generated from field: string text = 2;
+     */
+    text: string;
+    /**
+     * @generated from field: double confidence = 3;
+     */
+    confidence: number;
+    /**
+     * @generated from field: repeated string evidence_ids = 4;
+     */
+    evidenceIds: string[];
+    /**
+     * @generated from field: google.protobuf.Timestamp observed_at = 5;
+     */
+    observedAt?: Timestamp | undefined;
+    /**
+     * @generated from field: google.protobuf.Timestamp expires_at = 6;
+     */
+    expiresAt?: Timestamp | undefined;
+    /**
+     * @generated from field: google.protobuf.Struct metadata = 7;
+     */
+    metadata?: JsonObject | undefined;
+};
+/**
+ * Describes the message chronicle.v1.VisualContextObservation.
+ * Use `create(VisualContextObservationSchema)` to create a new message.
+ */
+export declare const VisualContextObservationSchema: GenMessage<VisualContextObservation>;
+/**
+ * @generated from enum chronicle.v1.VisualContextObservation.Kind
+ */
+export declare enum VisualContextObservation_Kind {
+    /**
+     * @generated from enum value: KIND_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: KIND_CURRENT_FOCUS = 1;
+     */
+    CURRENT_FOCUS = 1,
+    /**
+     * @generated from enum value: KIND_ACTIVE_ARTIFACT = 2;
+     */
+    ACTIVE_ARTIFACT = 2,
+    /**
+     * @generated from enum value: KIND_BLOCKER = 3;
+     */
+    BLOCKER = 3,
+    /**
+     * @generated from enum value: KIND_PERMISSION_WARNING = 4;
+     */
+    PERMISSION_WARNING = 4,
+    /**
+     * @generated from enum value: KIND_RISK_WARNING = 5;
+     */
+    RISK_WARNING = 5,
+    /**
+     * @generated from enum value: KIND_NEXT_ACTION_CONTEXT = 6;
+     */
+    NEXT_ACTION_CONTEXT = 6
+}
+/**
+ * Describes the enum chronicle.v1.VisualContextObservation.Kind.
+ */
+export declare const VisualContextObservation_KindSchema: GenEnum<VisualContextObservation_Kind>;
+/**
+ * @generated from message chronicle.v1.VisualContextRedactionReport
+ */
+export type VisualContextRedactionReport = Message<"chronicle.v1.VisualContextRedactionReport"> & {
+    /**
+     * @generated from field: bool raw_frames_excluded = 1;
+     */
+    rawFramesExcluded: boolean;
+    /**
+     * @generated from field: bool bulk_ocr_excluded = 2;
+     */
+    bulkOcrExcluded: boolean;
+    /**
+     * @generated from field: bool encrypted_batches_excluded = 3;
+     */
+    encryptedBatchesExcluded: boolean;
+    /**
+     * @generated from field: int32 excerpt_count = 4;
+     */
+    excerptCount: number;
+    /**
+     * @generated from field: int32 redacted_secret_count = 5;
+     */
+    redactedSecretCount: number;
+    /**
+     * @generated from field: repeated string redaction_reasons = 6;
+     */
+    redactionReasons: string[];
+};
+/**
+ * Describes the message chronicle.v1.VisualContextRedactionReport.
+ * Use `create(VisualContextRedactionReportSchema)` to create a new message.
+ */
+export declare const VisualContextRedactionReportSchema: GenMessage<VisualContextRedactionReport>;
+/**
+ * @generated from message chronicle.v1.ScreenBounds
+ */
+export type ScreenBounds = Message<"chronicle.v1.ScreenBounds"> & {
+    /**
+     * @generated from field: int32 x = 1;
+     */
+    x: number;
+    /**
+     * @generated from field: int32 y = 2;
+     */
+    y: number;
+    /**
+     * @generated from field: int32 width = 3;
+     */
+    width: number;
+    /**
+     * @generated from field: int32 height = 4;
+     */
+    height: number;
+    /**
+     * @generated from field: int32 display_width_px = 5;
+     */
+    displayWidthPx: number;
+    /**
+     * @generated from field: int32 display_height_px = 6;
+     */
+    displayHeightPx: number;
+    /**
+     * @generated from field: string display_id = 7;
+     */
+    displayId: string;
+};
+/**
+ * Describes the message chronicle.v1.ScreenBounds.
+ * Use `create(ScreenBoundsSchema)` to create a new message.
+ */
+export declare const ScreenBoundsSchema: GenMessage<ScreenBounds>;
+/**
+ * @generated from message chronicle.v1.VisualContextAffordance
+ */
+export type VisualContextAffordance = Message<"chronicle.v1.VisualContextAffordance"> & {
+    /**
+     * @generated from field: string affordance_id = 1;
+     */
+    affordanceId: string;
+    /**
+     * @generated from field: chronicle.v1.VisualContextAffordance.Kind kind = 2;
+     */
+    kind: VisualContextAffordance_Kind;
+    /**
+     * @generated from field: string label = 3;
+     */
+    label: string;
+    /**
+     * @generated from field: string text = 4;
+     */
+    text: string;
+    /**
+     * @generated from field: string role = 5;
+     */
+    role: string;
+    /**
+     * @generated from field: string app_bundle_id = 6;
+     */
+    appBundleId: string;
+    /**
+     * @generated from field: string window_title = 7;
+     */
+    windowTitle: string;
+    /**
+     * @generated from field: chronicle.v1.ScreenBounds bounds = 8;
+     */
+    bounds?: ScreenBounds | undefined;
+    /**
+     * @generated from field: double confidence = 9;
+     */
+    confidence: number;
+    /**
+     * @generated from field: repeated string evidence_ids = 10;
+     */
+    evidenceIds: string[];
+    /**
+     * If unset, the producing stage did not provide a persistence decision.
+     *
+     * @generated from field: optional bool safe_to_persist = 11;
+     */
+    safeToPersist?: boolean | undefined;
+    /**
+     * @generated from field: string persistence_decision_reason = 12;
+     */
+    persistenceDecisionReason: string;
+    /**
+     * @generated from field: google.protobuf.Struct metadata = 13;
+     */
+    metadata?: JsonObject | undefined;
+    /**
+     * action_grounding describes what kind of UI action this affordance could
+     * support. It is not an instruction to execute the action.
+     *
+     * @generated from field: chronicle.v1.VisualContextActionGrounding action_grounding = 14;
+     */
+    actionGrounding?: VisualContextActionGrounding | undefined;
+    /**
+     * stable_element_id links this affordance to the same UI element across
+     * frames/windows when the producer can infer identity.
+     *
+     * @generated from field: string stable_element_id = 15;
+     */
+    stableElementId: string;
+    /**
+     * verification is the latest bounded re-check of this affordance, when a
+     * verifier has looked at fresh screen evidence before an agent acts.
+     *
+     * @generated from field: chronicle.v1.VisualContextVerification verification = 16;
+     */
+    verification?: VisualContextVerification | undefined;
+};
+/**
+ * Describes the message chronicle.v1.VisualContextAffordance.
+ * Use `create(VisualContextAffordanceSchema)` to create a new message.
+ */
+export declare const VisualContextAffordanceSchema: GenMessage<VisualContextAffordance>;
+/**
+ * @generated from enum chronicle.v1.VisualContextAffordance.Kind
+ */
+export declare enum VisualContextAffordance_Kind {
+    /**
+     * @generated from enum value: KIND_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: KIND_BUTTON = 1;
+     */
+    BUTTON = 1,
+    /**
+     * @generated from enum value: KIND_TEXT_FIELD = 2;
+     */
+    TEXT_FIELD = 2,
+    /**
+     * @generated from enum value: KIND_LINK = 3;
+     */
+    LINK = 3,
+    /**
+     * @generated from enum value: KIND_MENU_ITEM = 4;
+     */
+    MENU_ITEM = 4,
+    /**
+     * @generated from enum value: KIND_TAB = 5;
+     */
+    TAB = 5,
+    /**
+     * @generated from enum value: KIND_WINDOW = 6;
+     */
+    WINDOW = 6,
+    /**
+     * @generated from enum value: KIND_TEXT = 7;
+     */
+    TEXT = 7,
+    /**
+     * @generated from enum value: KIND_IMAGE = 8;
+     */
+    IMAGE = 8,
+    /**
+     * @generated from enum value: KIND_CODE_EDITOR = 9;
+     */
+    CODE_EDITOR = 9,
+    /**
+     * @generated from enum value: KIND_TERMINAL = 10;
+     */
+    TERMINAL = 10,
+    /**
+     * @generated from enum value: KIND_OTHER = 11;
+     */
+    OTHER = 11
+}
+/**
+ * Describes the enum chronicle.v1.VisualContextAffordance.Kind.
+ */
+export declare const VisualContextAffordance_KindSchema: GenEnum<VisualContextAffordance_Kind>;
+/**
+ * @generated from message chronicle.v1.VisualContextActionGrounding
+ */
+export type VisualContextActionGrounding = Message<"chronicle.v1.VisualContextActionGrounding"> & {
+    /**
+     * @generated from field: chronicle.v1.VisualContextActionGrounding.ActionKind action_kind = 1;
+     */
+    actionKind: VisualContextActionGrounding_ActionKind;
+    /**
+     * @generated from field: string target_action = 2;
+     */
+    targetAction: string;
+    /**
+     * If unset, the producer did not provide a confirmation requirement signal.
+     *
+     * @generated from field: optional bool requires_confirmation = 3;
+     */
+    requiresConfirmation?: boolean | undefined;
+    /**
+     * If unset, the producer did not provide a destructive-action signal.
+     *
+     * @generated from field: optional bool destructive = 4;
+     */
+    destructive?: boolean | undefined;
+    /**
+     * If unset, the producer did not provide an enabled/disabled signal.
+     *
+     * @generated from field: optional bool disabled = 5;
+     */
+    disabled?: boolean | undefined;
+    /**
+     * @generated from field: string disabled_reason = 6;
+     */
+    disabledReason: string;
+    /**
+     * @generated from field: string verification_hint = 7;
+     */
+    verificationHint: string;
+    /**
+     * @generated from field: string guardrail_reason = 8;
+     */
+    guardrailReason: string;
+    /**
+     * @generated from field: google.protobuf.Struct metadata = 9;
+     */
+    metadata?: JsonObject | undefined;
+};
+/**
+ * Describes the message chronicle.v1.VisualContextActionGrounding.
+ * Use `create(VisualContextActionGroundingSchema)` to create a new message.
+ */
+export declare const VisualContextActionGroundingSchema: GenMessage<VisualContextActionGrounding>;
+/**
+ * @generated from enum chronicle.v1.VisualContextActionGrounding.ActionKind
+ */
+export declare enum VisualContextActionGrounding_ActionKind {
+    /**
+     * @generated from enum value: ACTION_KIND_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: ACTION_KIND_NONE = 1;
+     */
+    NONE = 1,
+    /**
+     * @generated from enum value: ACTION_KIND_CLICK = 2;
+     */
+    CLICK = 2,
+    /**
+     * @generated from enum value: ACTION_KIND_TYPE_TEXT = 3;
+     */
+    TYPE_TEXT = 3,
+    /**
+     * @generated from enum value: ACTION_KIND_SELECT = 4;
+     */
+    SELECT = 4,
+    /**
+     * @generated from enum value: ACTION_KIND_SUBMIT = 5;
+     */
+    SUBMIT = 5,
+    /**
+     * @generated from enum value: ACTION_KIND_OPEN = 6;
+     */
+    OPEN = 6,
+    /**
+     * @generated from enum value: ACTION_KIND_CONFIRM = 7;
+     */
+    CONFIRM = 7,
+    /**
+     * @generated from enum value: ACTION_KIND_DISMISS = 8;
+     */
+    DISMISS = 8
+}
+/**
+ * Describes the enum chronicle.v1.VisualContextActionGrounding.ActionKind.
+ */
+export declare const VisualContextActionGrounding_ActionKindSchema: GenEnum<VisualContextActionGrounding_ActionKind>;
+/**
+ * @generated from message chronicle.v1.VisualContextElementState
+ */
+export type VisualContextElementState = Message<"chronicle.v1.VisualContextElementState"> & {
+    /**
+     * @generated from field: string stable_element_id = 1;
+     */
+    stableElementId: string;
+    /**
+     * @generated from field: string affordance_id = 2;
+     */
+    affordanceId: string;
+    /**
+     * @generated from field: chronicle.v1.VisualContextElementState.Transition transition = 3;
+     */
+    transition: VisualContextElementState_Transition;
+    /**
+     * @generated from field: chronicle.v1.VisualContextAffordance affordance = 4;
+     */
+    affordance?: VisualContextAffordance | undefined;
+    /**
+     * @generated from field: google.protobuf.Timestamp observed_at = 5;
+     */
+    observedAt?: Timestamp | undefined;
+    /**
+     * @generated from field: google.protobuf.Timestamp previous_observed_at = 6;
+     */
+    previousObservedAt?: Timestamp | undefined;
+    /**
+     * @generated from field: repeated string evidence_ids = 7;
+     */
+    evidenceIds: string[];
+    /**
+     * @generated from field: chronicle.v1.VisualContextActionGrounding action_grounding = 8;
+     */
+    actionGrounding?: VisualContextActionGrounding | undefined;
+    /**
+     * If unset, the producing stage did not provide a persistence decision.
+     *
+     * @generated from field: optional bool safe_to_persist = 9;
+     */
+    safeToPersist?: boolean | undefined;
+    /**
+     * @generated from field: string persistence_decision_reason = 10;
+     */
+    persistenceDecisionReason: string;
+    /**
+     * @generated from field: google.protobuf.Struct metadata = 11;
+     */
+    metadata?: JsonObject | undefined;
+    /**
+     * verification is the latest bounded re-check of this stable UI element.
+     * It is evidence about current screen state, not action authorization.
+     *
+     * @generated from field: chronicle.v1.VisualContextVerification verification = 12;
+     */
+    verification?: VisualContextVerification | undefined;
+};
+/**
+ * Describes the message chronicle.v1.VisualContextElementState.
+ * Use `create(VisualContextElementStateSchema)` to create a new message.
+ */
+export declare const VisualContextElementStateSchema: GenMessage<VisualContextElementState>;
+/**
+ * @generated from enum chronicle.v1.VisualContextElementState.Transition
+ */
+export declare enum VisualContextElementState_Transition {
+    /**
+     * @generated from enum value: TRANSITION_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: TRANSITION_APPEARED = 1;
+     */
+    APPEARED = 1,
+    /**
+     * @generated from enum value: TRANSITION_UPDATED = 2;
+     */
+    UPDATED = 2,
+    /**
+     * @generated from enum value: TRANSITION_UNCHANGED = 3;
+     */
+    UNCHANGED = 3,
+    /**
+     * @generated from enum value: TRANSITION_DISAPPEARED = 4;
+     */
+    DISAPPEARED = 4
+}
+/**
+ * Describes the enum chronicle.v1.VisualContextElementState.Transition.
+ */
+export declare const VisualContextElementState_TransitionSchema: GenEnum<VisualContextElementState_Transition>;
+/**
+ * @generated from message chronicle.v1.VisualContextVerification
+ */
+export type VisualContextVerification = Message<"chronicle.v1.VisualContextVerification"> & {
+    /**
+     * @generated from field: string verification_id = 1;
+     */
+    verificationId: string;
+    /**
+     * @generated from field: string stable_element_id = 2;
+     */
+    stableElementId: string;
+    /**
+     * @generated from field: string affordance_id = 3;
+     */
+    affordanceId: string;
+    /**
+     * @generated from field: chronicle.v1.VisualContextVerification.Result result = 4;
+     */
+    result: VisualContextVerification_Result;
+    /**
+     * @generated from field: google.protobuf.Timestamp checked_at = 5;
+     */
+    checkedAt?: Timestamp | undefined;
+    /**
+     * @generated from field: repeated string evidence_ids = 6;
+     */
+    evidenceIds: string[];
+    /**
+     * @generated from field: string verifier_id = 7;
+     */
+    verifierId: string;
+    /**
+     * @generated from field: double confidence = 8;
+     */
+    confidence: number;
+    /**
+     * current_frame_checked means the verifier looked at a current bounded frame
+     * or current element snapshot, not only an older summary.
+     *
+     * @generated from field: bool current_frame_checked = 9;
+     */
+    currentFrameChecked: boolean;
+    /**
+     * safe_to_act is a verifier-local guardrail result. It is not a replacement
+     * for product policy, user confirmation, or action authorization.
+     *
+     * @generated from field: bool safe_to_act = 10;
+     */
+    safeToAct: boolean;
+    /**
+     * @generated from field: string guardrail_reason = 11;
+     */
+    guardrailReason: string;
+    /**
+     * @generated from field: string mismatch_reason = 12;
+     */
+    mismatchReason: string;
+    /**
+     * @generated from field: chronicle.v1.VisualContextActionGrounding action_grounding = 13;
+     */
+    actionGrounding?: VisualContextActionGrounding | undefined;
+    /**
+     * @generated from field: google.protobuf.Struct metadata = 14;
+     */
+    metadata?: JsonObject | undefined;
+};
+/**
+ * Describes the message chronicle.v1.VisualContextVerification.
+ * Use `create(VisualContextVerificationSchema)` to create a new message.
+ */
+export declare const VisualContextVerificationSchema: GenMessage<VisualContextVerification>;
+/**
+ * @generated from enum chronicle.v1.VisualContextVerification.Result
+ */
+export declare enum VisualContextVerification_Result {
+    /**
+     * @generated from enum value: RESULT_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: RESULT_PRESENT = 1;
+     */
+    PRESENT = 1,
+    /**
+     * @generated from enum value: RESULT_ABSENT = 2;
+     */
+    ABSENT = 2,
+    /**
+     * @generated from enum value: RESULT_CHANGED = 3;
+     */
+    CHANGED = 3,
+    /**
+     * @generated from enum value: RESULT_DISABLED = 4;
+     */
+    DISABLED = 4,
+    /**
+     * @generated from enum value: RESULT_BLOCKED = 5;
+     */
+    BLOCKED = 5,
+    /**
+     * @generated from enum value: RESULT_STALE = 6;
+     */
+    STALE = 6
+}
+/**
+ * Describes the enum chronicle.v1.VisualContextVerification.Result.
+ */
+export declare const VisualContextVerification_ResultSchema: GenEnum<VisualContextVerification_Result>;
+/**
+ * VisualAgentEpisode records a complete screen-grounded agent loop. It is the
+ * durable audit/eval envelope for observe -> ground -> verify -> propose/act ->
+ * outcome. It must carry cited, redacted evidence only; raw frames, screenshots,
+ * bulk OCR, and encrypted fallback batches remain outside this contract.
+ *
+ * @generated from message chronicle.v1.VisualAgentEpisode
+ */
+export type VisualAgentEpisode = Message<"chronicle.v1.VisualAgentEpisode"> & {
+    /**
+     * @generated from field: string episode_id = 1;
+     */
+    episodeId: string;
+    /**
+     * @generated from field: string organization_id = 2;
+     */
+    organizationId: string;
+    /**
+     * @generated from field: string workspace_id = 3;
+     */
+    workspaceId: string;
+    /**
+     * @generated from field: string user_id = 4;
+     */
+    userId: string;
+    /**
+     * @generated from field: string project_id = 5;
+     */
+    projectId: string;
+    /**
+     * @generated from field: string device_id = 6;
+     */
+    deviceId: string;
+    /**
+     * @generated from field: common.v1.TimeRange window = 7;
+     */
+    window?: TimeRange | undefined;
+    /**
+     * @generated from field: string instruction = 8;
+     */
+    instruction: string;
+    /**
+     * @generated from field: string agent_id = 9;
+     */
+    agentId: string;
+    /**
+     * @generated from field: string model = 10;
+     */
+    model: string;
+    /**
+     * @generated from field: string provider = 11;
+     */
+    provider: string;
+    /**
+     * @generated from field: string policy_ref = 12;
+     */
+    policyRef: string;
+    /**
+     * @generated from field: string summary_id = 13;
+     */
+    summaryId: string;
+    /**
+     * @generated from field: repeated string source_memory_ids = 14;
+     */
+    sourceMemoryIds: string[];
+    /**
+     * @generated from field: repeated string source_batch_ids = 15;
+     */
+    sourceBatchIds: string[];
+    /**
+     * @generated from field: repeated string source_frame_hashes = 16;
+     */
+    sourceFrameHashes: string[];
+    /**
+     * @generated from field: repeated string source_artifact_ids = 17;
+     */
+    sourceArtifactIds: string[];
+    /**
+     * @generated from field: repeated string active_artifacts = 18;
+     */
+    activeArtifacts: string[];
+    /**
+     * @generated from field: chronicle.v1.VisualContextRedactionReport redaction = 19;
+     */
+    redaction?: VisualContextRedactionReport | undefined;
+    /**
+     * @generated from field: repeated chronicle.v1.VisualAgentStep steps = 20;
+     */
+    steps: VisualAgentStep[];
+    /**
+     * @generated from field: chronicle.v1.VisualAgentOutcome outcome = 21;
+     */
+    outcome?: VisualAgentOutcome | undefined;
+    /**
+     * @generated from field: repeated chronicle.v1.VisualActionLedgerEntry action_ledger = 22;
+     */
+    actionLedger: VisualActionLedgerEntry[];
+    /**
+     * @generated from field: string audit_event_id = 23;
+     */
+    auditEventId: string;
+    /**
+     * @generated from field: string meter_event_id = 24;
+     */
+    meterEventId: string;
+    /**
+     * @generated from field: string fermata_eval_run_id = 25;
+     */
+    fermataEvalRunId: string;
+    /**
+     * @generated from field: google.protobuf.Timestamp started_at = 26;
+     */
+    startedAt?: Timestamp | undefined;
+    /**
+     * @generated from field: google.protobuf.Timestamp completed_at = 27;
+     */
+    completedAt?: Timestamp | undefined;
+    /**
+     * @generated from field: double confidence = 28;
+     */
+    confidence: number;
+    /**
+     * @generated from field: google.protobuf.Struct metadata = 29;
+     */
+    metadata?: JsonObject | undefined;
 };
 /**
- * Describes the message chronicle.v1.CapturedFrame.
- * Use `create(CapturedFrameSchema)` to create a new message.
+ * Describes the message chronicle.v1.VisualAgentEpisode.
+ * Use `create(VisualAgentEpisodeSchema)` to create a new message.
  */
-export declare const CapturedFrameSchema: GenMessage<CapturedFrame>;
+export declare const VisualAgentEpisodeSchema: GenMessage<VisualAgentEpisode>;
 /**
- * @generated from message chronicle.v1.DropCounts
+ * @generated from message chronicle.v1.VisualAgentStep
  */
-export type DropCounts = Message<"chronicle.v1.DropCounts"> & {
+export type VisualAgentStep = Message<"chronicle.v1.VisualAgentStep"> & {
     /**
-     * @generated from field: int32 secret = 1;
+     * @generated from field: string step_id = 1;
      */
-    secret: number;
+    stepId: string;
     /**
-     * @generated from field: int32 duplicate = 2;
+     * @generated from field: int32 index = 2;
      */
-    duplicate: number;
+    index: number;
     /**
-     * @generated from field: int32 denied_app = 3;
+     * @generated from field: chronicle.v1.VisualAgentStep.Kind kind = 3;
      */
-    deniedApp: number;
+    kind: VisualAgentStep_Kind;
     /**
-     * @generated from field: int32 denied_path = 4;
+     * @generated from field: string summary_id = 4;
      */
-    deniedPath: number;
+    summaryId: string;
+    /**
+     * @generated from field: string stable_element_id = 5;
+     */
+    stableElementId: string;
+    /**
+     * @generated from field: string affordance_id = 6;
+     */
+    affordanceId: string;
+    /**
+     * @generated from field: string verification_id = 7;
+     */
+    verificationId: string;
+    /**
+     * @generated from field: chronicle.v1.VisualContextActionGrounding.ActionKind action_kind = 8;
+     */
+    actionKind: VisualContextActionGrounding_ActionKind;
+    /**
+     * @generated from field: string target_action = 9;
+     */
+    targetAction: string;
+    /**
+     * @generated from field: bool requires_confirmation = 10;
+     */
+    requiresConfirmation: boolean;
+    /**
+     * @generated from field: bool user_confirmed = 11;
+     */
+    userConfirmed: boolean;
+    /**
+     * @generated from field: bool current_frame_checked = 12;
+     */
+    currentFrameChecked: boolean;
+    /**
+     * @generated from field: bool safe_to_act = 13;
+     */
+    safeToAct: boolean;
+    /**
+     * @generated from field: chronicle.v1.VisualContextActionGrounding action_grounding = 14;
+     */
+    actionGrounding?: VisualContextActionGrounding | undefined;
+    /**
+     * @generated from field: chronicle.v1.VisualContextVerification verification = 15;
+     */
+    verification?: VisualContextVerification | undefined;
+    /**
+     * @generated from field: repeated string evidence_ids = 16;
+     */
+    evidenceIds: string[];
+    /**
+     * @generated from field: google.protobuf.Timestamp observed_at = 17;
+     */
+    observedAt?: Timestamp | undefined;
+    /**
+     * @generated from field: string reason = 18;
+     */
+    reason: string;
+    /**
+     * @generated from field: chronicle.v1.VisualContextRedactionReport redaction = 19;
+     */
+    redaction?: VisualContextRedactionReport | undefined;
+    /**
+     * @generated from field: google.protobuf.Struct metadata = 20;
+     */
+    metadata?: JsonObject | undefined;
 };
 /**
- * Describes the message chronicle.v1.DropCounts.
- * Use `create(DropCountsSchema)` to create a new message.
+ * Describes the message chronicle.v1.VisualAgentStep.
+ * Use `create(VisualAgentStepSchema)` to create a new message.
  */
-export declare const DropCountsSchema: GenMessage<DropCounts>;
+export declare const VisualAgentStepSchema: GenMessage<VisualAgentStep>;
 /**
- * @generated from message chronicle.v1.EmittedCounts
+ * @generated from enum chronicle.v1.VisualAgentStep.Kind
  */
-export type EmittedCounts = Message<"chronicle.v1.EmittedCounts"> & {
+export declare enum VisualAgentStep_Kind {
     /**
-     * @generated from field: int32 distinct_bundles = 1;
+     * @generated from enum value: KIND_UNSPECIFIED = 0;
      */
-    distinctBundles: number;
+    UNSPECIFIED = 0,
     /**
-     * @generated from field: int32 distinct_domains = 2;
+     * @generated from enum value: KIND_OBSERVE = 1;
      */
-    distinctDomains: number;
+    OBSERVE = 1,
     /**
-     * @generated from field: int32 distinct_document_paths = 3;
+     * @generated from enum value: KIND_GROUND = 2;
      */
-    distinctDocumentPaths: number;
+    GROUND = 2,
     /**
-     * @generated from field: int32 distinct_github_prs = 4;
+     * @generated from enum value: KIND_VERIFY = 3;
      */
-    distinctGithubPrs: number;
+    VERIFY = 3,
     /**
-     * @generated from field: int32 foreground_changes = 5;
+     * @generated from enum value: KIND_PROPOSE = 4;
      */
-    foregroundChanges: number;
+    PROPOSE = 4,
     /**
-     * @generated from field: int32 document_changes = 6;
+     * @generated from enum value: KIND_ACT = 5;
      */
-    documentChanges: number;
+    ACT = 5,
     /**
-     * @generated from field: int32 work_leisure_flips = 7;
+     * @generated from enum value: KIND_OUTCOME = 6;
      */
-    workLeisureFlips: number;
+    OUTCOME = 6,
     /**
-     * @generated from field: int64 longest_uninterrupted_seconds = 8;
+     * @generated from enum value: KIND_ABSTAIN = 7;
      */
-    longestUninterruptedSeconds: bigint;
+    ABSTAIN = 7
+}
+/**
+ * Describes the enum chronicle.v1.VisualAgentStep.Kind.
+ */
+export declare const VisualAgentStep_KindSchema: GenEnum<VisualAgentStep_Kind>;
+/**
+ * @generated from message chronicle.v1.VisualAgentOutcome
+ */
+export type VisualAgentOutcome = Message<"chronicle.v1.VisualAgentOutcome"> & {
     /**
-     * @generated from field: int32 thrash_event_count = 9;
+     * @generated from field: chronicle.v1.VisualAgentOutcome.Result result = 1;
      */
-    thrashEventCount: number;
+    result: VisualAgentOutcome_Result;
+    /**
+     * @generated from field: string stable_element_id = 2;
+     */
+    stableElementId: string;
+    /**
+     * @generated from field: string affordance_id = 3;
+     */
+    affordanceId: string;
+    /**
+     * @generated from field: string verification_id = 4;
+     */
+    verificationId: string;
+    /**
+     * @generated from field: chronicle.v1.VisualContextActionGrounding.ActionKind action_kind = 5;
+     */
+    actionKind: VisualContextActionGrounding_ActionKind;
+    /**
+     * @generated from field: string target_action = 6;
+     */
+    targetAction: string;
+    /**
+     * @generated from field: bool requires_user_confirmation = 7;
+     */
+    requiresUserConfirmation: boolean;
+    /**
+     * @generated from field: bool user_confirmed = 8;
+     */
+    userConfirmed: boolean;
+    /**
+     * @generated from field: repeated string outcome_event_ids = 9;
+     */
+    outcomeEventIds: string[];
+    /**
+     * @generated from field: repeated string outcome_fact_ids = 10;
+     */
+    outcomeFactIds: string[];
+    /**
+     * @generated from field: string guardrail_reason = 11;
+     */
+    guardrailReason: string;
+    /**
+     * @generated from field: google.protobuf.Timestamp checked_at = 12;
+     */
+    checkedAt?: Timestamp | undefined;
+    /**
+     * @generated from field: google.protobuf.Struct metadata = 13;
+     */
+    metadata?: JsonObject | undefined;
 };
 /**
- * Describes the message chronicle.v1.EmittedCounts.
- * Use `create(EmittedCountsSchema)` to create a new message.
+ * Describes the message chronicle.v1.VisualAgentOutcome.
+ * Use `create(VisualAgentOutcomeSchema)` to create a new message.
  */
-export declare const EmittedCountsSchema: GenMessage<EmittedCounts>;
+export declare const VisualAgentOutcomeSchema: GenMessage<VisualAgentOutcome>;
 /**
- * @generated from message chronicle.v1.FrameReceipt
+ * @generated from enum chronicle.v1.VisualAgentOutcome.Result
  */
-export type FrameReceipt = Message<"chronicle.v1.FrameReceipt"> & {
+export declare enum VisualAgentOutcome_Result {
     /**
-     * @generated from field: string frame_hash = 1;
+     * @generated from enum value: RESULT_UNSPECIFIED = 0;
      */
-    frameHash: string;
+    UNSPECIFIED = 0,
     /**
-     * @generated from field: chronicle.v1.CaptureDecision decision = 2;
+     * @generated from enum value: RESULT_NO_ACTION = 1;
      */
-    decision: CaptureDecision;
+    NO_ACTION = 1,
     /**
-     * @generated from field: string reason = 3;
+     * @generated from enum value: RESULT_PROPOSED_ACTION = 2;
      */
-    reason: string;
+    PROPOSED_ACTION = 2,
     /**
-     * @generated from field: string memory_id = 4;
+     * @generated from enum value: RESULT_ACTED = 3;
      */
-    memoryId: string;
+    ACTED = 3,
     /**
-     * @generated from field: common.v1.EvidenceRef evidence = 5;
+     * @generated from enum value: RESULT_BLOCKED = 4;
      */
-    evidence?: EvidenceRef | undefined;
+    BLOCKED = 4,
     /**
-     * @generated from field: chronicle.v1.CaptureTier accepted_tier = 6;
+     * @generated from enum value: RESULT_FAILED = 5;
      */
-    acceptedTier: CaptureTier;
+    FAILED = 5
+}
+/**
+ * Describes the enum chronicle.v1.VisualAgentOutcome.Result.
+ */
+export declare const VisualAgentOutcome_ResultSchema: GenEnum<VisualAgentOutcome_Result>;
+/**
+ * VisualActionLedgerEntry is the explicit human-confirmation/action audit row
+ * for screen-derived actions. Consumers should treat it as an evidence pointer
+ * and policy record, not proof that an external side effect succeeded.
+ *
+ * @generated from message chronicle.v1.VisualActionLedgerEntry
+ */
+export type VisualActionLedgerEntry = Message<"chronicle.v1.VisualActionLedgerEntry"> & {
+    /**
+     * @generated from field: string ledger_entry_id = 1;
+     */
+    ledgerEntryId: string;
+    /**
+     * @generated from field: string episode_id = 2;
+     */
+    episodeId: string;
+    /**
+     * @generated from field: string action_id = 3;
+     */
+    actionId: string;
+    /**
+     * @generated from field: string stable_element_id = 4;
+     */
+    stableElementId: string;
+    /**
+     * @generated from field: string affordance_id = 5;
+     */
+    affordanceId: string;
+    /**
+     * @generated from field: chronicle.v1.VisualContextActionGrounding.ActionKind action_kind = 6;
+     */
+    actionKind: VisualContextActionGrounding_ActionKind;
+    /**
+     * @generated from field: string target_action = 7;
+     */
+    targetAction: string;
+    /**
+     * @generated from field: string verification_id = 8;
+     */
+    verificationId: string;
+    /**
+     * @generated from field: bool current_frame_checked = 9;
+     */
+    currentFrameChecked: boolean;
+    /**
+     * @generated from field: bool safe_to_act = 10;
+     */
+    safeToAct: boolean;
+    /**
+     * @generated from field: bool requires_user_confirmation = 11;
+     */
+    requiresUserConfirmation: boolean;
+    /**
+     * @generated from field: bool user_confirmed = 12;
+     */
+    userConfirmed: boolean;
+    /**
+     * @generated from field: string confirmation_id = 13;
+     */
+    confirmationId: string;
+    /**
+     * @generated from field: string authorization_id = 14;
+     */
+    authorizationId: string;
+    /**
+     * @generated from field: google.protobuf.Timestamp proposed_at = 15;
+     */
+    proposedAt?: Timestamp | undefined;
+    /**
+     * @generated from field: google.protobuf.Timestamp verified_at = 16;
+     */
+    verifiedAt?: Timestamp | undefined;
+    /**
+     * @generated from field: google.protobuf.Timestamp confirmed_at = 17;
+     */
+    confirmedAt?: Timestamp | undefined;
+    /**
+     * @generated from field: google.protobuf.Timestamp acted_at = 18;
+     */
+    actedAt?: Timestamp | undefined;
+    /**
+     * @generated from field: chronicle.v1.VisualAgentOutcome outcome = 19;
+     */
+    outcome?: VisualAgentOutcome | undefined;
+    /**
+     * @generated from field: repeated string evidence_ids = 20;
+     */
+    evidenceIds: string[];
+    /**
+     * @generated from field: string audit_event_id = 21;
+     */
+    auditEventId: string;
+    /**
+     * @generated from field: string meter_event_id = 22;
+     */
+    meterEventId: string;
+    /**
+     * @generated from field: string guardrail_reason = 23;
+     */
+    guardrailReason: string;
+    /**
+     * @generated from field: google.protobuf.Struct metadata = 24;
+     */
+    metadata?: JsonObject | undefined;
 };
 /**
- * Describes the message chronicle.v1.FrameReceipt.
- * Use `create(FrameReceiptSchema)` to create a new message.
+ * Describes the message chronicle.v1.VisualActionLedgerEntry.
+ * Use `create(VisualActionLedgerEntrySchema)` to create a new message.
  */
-export declare const FrameReceiptSchema: GenMessage<FrameReceipt>;
+export declare const VisualActionLedgerEntrySchema: GenMessage<VisualActionLedgerEntry>;
+/**
+ * @generated from message chronicle.v1.VerifyVisualActionRequest
+ */
+export type VerifyVisualActionRequest = Message<"chronicle.v1.VerifyVisualActionRequest"> & {
+    /**
+     * @generated from field: string organization_id = 1;
+     */
+    organizationId: string;
+    /**
+     * @generated from field: string workspace_id = 2;
+     */
+    workspaceId: string;
+    /**
+     * @generated from field: string user_id = 3;
+     */
+    userId: string;
+    /**
+     * @generated from field: string project_id = 4;
+     */
+    projectId: string;
+    /**
+     * @generated from field: string device_id = 5;
+     */
+    deviceId: string;
+    /**
+     * @generated from field: string episode_id = 6;
+     */
+    episodeId: string;
+    /**
+     * @generated from field: string summary_id = 7;
+     */
+    summaryId: string;
+    /**
+     * @generated from field: string stable_element_id = 8;
+     */
+    stableElementId: string;
+    /**
+     * @generated from field: string affordance_id = 9;
+     */
+    affordanceId: string;
+    /**
+     * @generated from field: chronicle.v1.VisualContextActionGrounding intended_action = 10;
+     */
+    intendedAction?: VisualContextActionGrounding | undefined;
+    /**
+     * @generated from field: chronicle.v1.VisualContextVerification verification = 11;
+     */
+    verification?: VisualContextVerification | undefined;
+    /**
+     * @generated from field: bool user_confirmed = 12;
+     */
+    userConfirmed: boolean;
+    /**
+     * @generated from field: string confirmation_id = 13;
+     */
+    confirmationId: string;
+    /**
+     * @generated from field: string policy_ref = 14;
+     */
+    policyRef: string;
+    /**
+     * @generated from field: repeated string evidence_ids = 15;
+     */
+    evidenceIds: string[];
+    /**
+     * @generated from field: google.protobuf.Struct metadata = 16;
+     */
+    metadata?: JsonObject | undefined;
+};
+/**
+ * Describes the message chronicle.v1.VerifyVisualActionRequest.
+ * Use `create(VerifyVisualActionRequestSchema)` to create a new message.
+ */
+export declare const VerifyVisualActionRequestSchema: GenMessage<VerifyVisualActionRequest>;
+/**
+ * @generated from message chronicle.v1.VerifyVisualActionResponse
+ */
+export type VerifyVisualActionResponse = Message<"chronicle.v1.VerifyVisualActionResponse"> & {
+    /**
+     * @generated from field: chronicle.v1.VisualContextVerification verification = 1;
+     */
+    verification?: VisualContextVerification | undefined;
+    /**
+     * @generated from field: bool safe_to_act = 2;
+     */
+    safeToAct: boolean;
+    /**
+     * @generated from field: bool requires_user_confirmation = 3;
+     */
+    requiresUserConfirmation: boolean;
+    /**
+     * @generated from field: bool user_confirmed = 4;
+     */
+    userConfirmed: boolean;
+    /**
+     * @generated from field: string guardrail_reason = 5;
+     */
+    guardrailReason: string;
+    /**
+     * @generated from field: chronicle.v1.VisualActionLedgerEntry ledger_entry = 6;
+     */
+    ledgerEntry?: VisualActionLedgerEntry | undefined;
+    /**
+     * @generated from field: string audit_event_id = 7;
+     */
+    auditEventId: string;
+    /**
+     * @generated from field: string meter_event_id = 8;
+     */
+    meterEventId: string;
+    /**
+     * @generated from field: google.protobuf.Timestamp checked_at = 9;
+     */
+    checkedAt?: Timestamp | undefined;
+};
+/**
+ * Describes the message chronicle.v1.VerifyVisualActionResponse.
+ * Use `create(VerifyVisualActionResponseSchema)` to create a new message.
+ */
+export declare const VerifyVisualActionResponseSchema: GenMessage<VerifyVisualActionResponse>;
 /**
  * @generated from message chronicle.v1.AcknowledgeMemoryRequest
  */
@@ -1372,4 +2828,16 @@ export declare const ChronicleService: GenService<{
         input: typeof SetCapturePolicyRequestSchema;
         output: typeof SetCapturePolicyResponseSchema;
     };
+    /**
+     * VerifyVisualAction checks bounded current-frame visual evidence before an
+     * agent executes a UI action. It validates verifier evidence and confirmation
+     * gates; it does not inspect or persist raw screenshots.
+     *
+     * @generated from rpc chronicle.v1.ChronicleService.VerifyVisualAction
+     */
+    verifyVisualAction: {
+        methodKind: "unary";
+        input: typeof VerifyVisualActionRequestSchema;
+        output: typeof VerifyVisualActionResponseSchema;
+    };
 }>;