feat: deep link digital sync failures

qimingclaw/crates/agent-electron-client/src/main/services/digitalEmployee/syncService.ts

@@ -4,6 +4,8 @@ import { getDomainTokenKey } from "@shared/utils/domain";
 import { getDb, readSetting } from "../../db";
 
 const DEFAULT_SYNC_PATH = "/api/digital-employee/sync/outbox";
+const MANAGEMENT_SYNC_RECORD_PATH =
+  "/system/content/content-digital-employee-sync";
 const DEFAULT_INTERVAL_MS = 30_000;
 const DEFAULT_BATCH_SIZE = 50;
 const REQUEST_TIMEOUT_MS = 15_000;
@@ -42,6 +44,7 @@ export interface DigitalEmployeeSyncFailure {
   lastAttemptAt: string | null;
   nextRetryAt: string | null;
   dueForRetry: boolean;
+  managementRecordUrl: string | null;
   error: string | null;
   createdAt: string;
   updatedAt: string;
@@ -109,7 +112,7 @@ export function getDigitalEmployeeSyncStatus(): DigitalEmployeeSyncStatus {
     failed: countOutbox("failed"),
     lastSyncAt,
     lastSyncError,
-    recentFailures: readRecentFailures(),
+    recentFailures: readRecentFailures(config),
   };
 }
 
@@ -385,7 +388,10 @@ function countOutbox(status: string): number {
   return row?.count ?? 0;
 }
 
-function readRecentFailures(limit = 3): DigitalEmployeeSyncFailure[] {
+function readRecentFailures(
+  config: DigitalEmployeeSyncConfig,
+  limit = 3,
+): DigitalEmployeeSyncFailure[] {
   const db = getDb();
   if (!db) return [];
   const rows = db
@@ -422,6 +428,7 @@ function readRecentFailures(limit = 3): DigitalEmployeeSyncFailure[] {
       lastAttemptAt: row.last_attempt_at,
       nextRetryAt,
       dueForRetry: !nextRetryAt || Date.now() >= Date.parse(nextRetryAt),
+      managementRecordUrl: buildManagementRecordUrl(config, row),
       error: row.error,
       createdAt: row.created_at,
       updatedAt: row.updated_at,
@@ -429,6 +436,28 @@ function readRecentFailures(limit = 3): DigitalEmployeeSyncFailure[] {
   });
 }
 
+function buildManagementRecordUrl(
+  config: DigitalEmployeeSyncConfig,
+  row: {
+    id: string;
+    entity_type: string;
+    entity_id: string;
+  },
+): string | null {
+  if (!config.endpoint) return null;
+  try {
+    const endpoint = new URL(config.endpoint);
+    const url = new URL(MANAGEMENT_SYNC_RECORD_PATH, endpoint.origin);
+    if (config.clientKey) url.searchParams.set("client_key", config.clientKey);
+    url.searchParams.set("entity_type", row.entity_type);
+    url.searchParams.set("entity_id", row.entity_id);
+    url.searchParams.set("outbox_id", row.id);
+    return url.toString();
+  } catch {
+    return null;
+  }
+}
+
 function nextRetryAtForFailure(
   lastAttemptAt: string | null,
   attempts: number,