feat(governance): 新增 Telegram receipt approval package

apps/web/src/lib/api-client.ts

@@ -292,6 +292,11 @@ export const apiClient = {
     return handleResponse<AiAgentLearningWritebackApprovalPackageSnapshot>(res)
   },
 
+  async getAiAgentTelegramReceiptApprovalPackage() {
+    const res = await fetch(`${API_BASE_URL}/agents/agent-telegram-receipt-approval-package`)
+    return handleResponse<AiAgentTelegramReceiptApprovalPackageSnapshot>(res)
+  },
+
   async getAiAgentHostStatefulVersionInventory() {
     const res = await fetch(`${API_BASE_URL}/agents/agent-host-stateful-version-inventory`)
     return handleResponse<AiAgentHostStatefulVersionInventorySnapshot>(res)
@@ -1429,6 +1434,82 @@ export interface AiAgentLearningWritebackApprovalPackageSnapshot {
   }
 }
 
+export interface AiAgentTelegramReceiptApprovalPackageSnapshot {
+  schema_version: 'ai_agent_telegram_receipt_approval_package_v1'
+  generated_at: string
+  program_status: {
+    overall_completion_percent: number
+    current_priority: 'P0' | 'P1' | 'P2' | 'P3'
+    current_task_id: string
+    next_task_id: string
+    read_only_mode: true
+    runtime_authority: 'approval_package_only_no_telegram_send'
+    status_note: string
+  }
+  source_refs: string[]
+  telegram_truth: {
+    telegram_send_allowed: false
+    gateway_queue_write_allowed: false
+    direct_bot_api_allowed: false
+    receiver_route_change_allowed: false
+    runtime_worker_allowed: false
+    live_queued_receipt_count: number
+    live_delivered_receipt_count: number
+    live_acknowledged_receipt_count: number
+    live_failed_receipt_count: number
+    live_retry_count: number
+    truth_note: string
+  }
+  receipt_package: {
+    required_fields: string[]
+    forbidden_fields: string[]
+    owner_review_required: true
+    retry_policy_required: true
+    delivery_receipt_required: true
+    operator_meaning: string
+  }
+  receipt_gates: Array<{
+    gate_id: string
+    display_name: string
+    owner_agent: 'openclaw' | 'hermes' | 'nemotron'
+    status: string
+    required_evidence: string
+    blocked_runtime_action: string
+  }>
+  receipt_lanes: Array<{
+    lane_id: string
+    display_name: string
+    target_surface: string
+    status: string
+    owner_agent: 'openclaw' | 'hermes' | 'nemotron'
+    review_owner: string
+    required_review: string
+  }>
+  retry_contract: {
+    retry_required: true
+    retry_steps: string[]
+  }
+  approval_boundaries: Record<string, false>
+  display_redaction_contract: {
+    redaction_required: true
+    raw_payload_display_allowed: false
+    private_reasoning_display_allowed: false
+    secret_value_display_allowed: false
+    allowed_frontend_content: string[]
+    forbidden_frontend_content: string[]
+    frontend_display_policy: string
+  }
+  rollups: {
+    receipt_gate_count: number
+    receipt_lane_count: number
+    approval_required_gate_ids: string[]
+    blocked_runtime_action_count: number
+    required_field_count: number
+    forbidden_field_count: number
+    live_receipt_count_total: number
+  }
+}
+
 export interface AiAgentHostStatefulVersionInventorySnapshot {
   schema_version: 'ai_agent_host_stateful_version_inventory_v1'
   generated_at: string