feat: add orchestrator shadow observability

ops/src/api/admin.ts

@@ -257,6 +257,85 @@ export type OrchestratorRuntimeState = OrchestratorConfigState & {
   serviceHealth: OrchestratorServiceHealth;
 };
 
+export type OrchestratorShadowMetrics = {
+  observations: number;
+  successes: number;
+  failures: number;
+  successRate: number | null;
+  failureRate: number | null;
+  latencyP50Ms: number | null;
+  latencyP95Ms: number | null;
+  nativeSucceeded: number;
+  nativeFailed: number;
+  lastObservedAt: number | null;
+  sampled: boolean;
+};
+
+export type OrchestratorShadowRun = {
+  eventId: string;
+  runId: string;
+  requestId: string;
+  userId: string;
+  sessionId: string | null;
+  nativeStatus: string;
+  nativeAttempts: number;
+  shadowStatus: 'succeeded' | 'failed';
+  engine: string;
+  configVersion: number | null;
+  phase: string | null;
+  taskType: string | null;
+  executorAdapter: string | null;
+  latencyMs: number | null;
+  error: { code: string; message: string } | null;
+  observedAt: number;
+  nativeCompletedAt: number | null;
+};
+
+export type OrchestratorShadowRunList = {
+  generatedAt: number;
+  window: { hours: number; from: number };
+  metrics: OrchestratorShadowMetrics;
+  runs: OrchestratorShadowRun[];
+};
+
+export type OrchestratorShadowRunDetail = {
+  native: {
+    runId: string;
+    requestId: string;
+    userId: string;
+    sessionId: string | null;
+    status: string;
+    attempts: number;
+    error: string | null;
+    createdAt: number;
+    updatedAt: number;
+    startedAt: number | null;
+    completedAt: number | null;
+  };
+  localEvents: Array<{
+    eventId: string;
+    type: string;
+    data: Record<string, unknown> | null;
+    createdAt: number;
+  }>;
+  remote: {
+    available: boolean;
+    state: {
+      status?: string;
+      phase?: string;
+      plan?: Record<string, unknown>;
+      result?: Record<string, unknown>;
+    } | null;
+    events: Array<{
+      sequence?: number;
+      type?: string;
+      timestamp?: number;
+      data?: Record<string, unknown> | null;
+    }>;
+    error: { code: string; message: string } | null;
+  };
+};
+
 // ─── Summary ──────────────────────────────────────────────────────────────────
 
 export async function fetchAdminSummary() {
@@ -293,6 +372,26 @@ export async function fetchOrchestratorRuntime() {
   return adminFetch<OrchestratorRuntimeState>('/admin-api/orchestrator/runtime');
 }
 
+export async function fetchOrchestratorShadowRuns(params: {
+  hours?: number;
+  limit?: number;
+  status?: 'all' | 'succeeded' | 'failed';
+} = {}) {
+  const query = new URLSearchParams();
+  if (params.hours) query.set('hours', String(params.hours));
+  if (params.limit) query.set('limit', String(params.limit));
+  if (params.status) query.set('status', params.status);
+  return adminFetch<OrchestratorShadowRunList>(
+    `/admin-api/orchestrator/shadow-runs?${query}`,
+  );
+}
+
+export async function fetchOrchestratorShadowRun(runId: string) {
+  return adminFetch<OrchestratorShadowRunDetail>(
+    `/admin-api/orchestrator/shadow-runs/${encodeURIComponent(runId)}`,
+  );
+}
+
 // ─── Users ────────────────────────────────────────────────────────────────────
 
 export async function fetchAdminUsers(params: {