@absolutejs/voice 0.0.22-beta.380 → 0.0.22-beta.382

package/dist/client/index.js

@@ -4668,7 +4668,7 @@ var buildRealCallProfileReadinessIssues = (report, options) => {
 var uniqueRealCallProfileActions = (actions) => {
   const seen = new Set;
   return actions.filter((action) => {
-    const key = `${action.method ?? "GET"}:${action.href}:${action.label}`;
+    const key = `${action.method ?? "GET"}:${action.href}:${action.label}:${action.profileId ?? ""}`;
     if (seen.has(key)) {
       return false;
     }
@@ -4676,6 +4676,16 @@ var uniqueRealCallProfileActions = (actions) => {
     return true;
   });
 };
+var appendRealCallRecoveryActionQuery = (href, query) => {
+  const entries = Object.entries(query).filter((entry) => entry[1] !== undefined);
+  if (entries.length === 0) {
+    return href;
+  }
+  const [base = href, hash = ""] = href.split("#");
+  const separator = base.includes("?") ? "&" : "?";
+  const search = new URLSearchParams(entries).toString();
+  return `${base}${separator}${search}${hash ? `#${hash}` : ""}`;
+};
 var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
   const actions = [
     {
@@ -4696,20 +4706,41 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
   const missingProfiles = [...requiredProfiles].filter((profileId) => !profilesById.has(profileId));
   const warningProfiles = report.defaults.profiles.filter((profile) => (requiredProfiles.size === 0 || requiredProfiles.has(profile.profileId)) && profile.status !== "pass");
   const missingRoleProfiles = report.defaults.profiles.filter((profile) => (options.requiredProviderRoles ?? []).some((role) => !profile.providerRoutes[role]));
+  const summariesByProfile = new Map((report.summary.profiles ?? []).map((profile) => [profile.id, profile]));
+  const missingDepthProfiles = [...requiredProfiles].filter((profileId) => {
+    const summaryProfile = summariesByProfile.get(profileId);
+    if (options.minProfileCycles !== undefined && (summaryProfile?.cycles ?? 0) < options.minProfileCycles) {
+      return true;
+    }
+    if (options.minProfileSessions !== undefined && (summaryProfile?.sessionCount ?? 0) < options.minProfileSessions) {
+      return true;
+    }
+    const requiredProfileSurfaces = options.requiredProfileSurfaces;
+    const requiredSurfaces = requiredProfileSurfaces === undefined ? [] : Array.isArray(requiredProfileSurfaces) ? requiredProfileSurfaces : requiredProfileSurfaces[profileId] ?? [];
+    const observedSurfaces = new Set(summaryProfile?.surfaces ?? []);
+    return requiredSurfaces.some((surface) => !observedSurfaces.has(surface));
+  });
   const ageMs = report.trend.ageMs ?? (report.generatedAt ? Date.now() - new Date(report.generatedAt).getTime() : undefined);
-  if (missingProfiles.length > 0 || warningProfiles.length > 0 || missingRoleProfiles.length > 0 || options.minCycles !== undefined && (report.summary.cycles ?? 0) < options.minCycles || options.minActionableProfiles !== undefined && report.defaults.summary.actionableProfiles < options.minActionableProfiles) {
-    actions.push({
-      description: "Run browser profile proof to collect microphone, WebSocket, live-latency, and provider traces for missing profiles.",
-      href: options.browserProofHref ?? "/voice/browser-call-profiles",
-      id: "collect-browser-proof",
-      label: "Run browser profile proof"
-    });
-    actions.push({
-      description: "Run phone profile proof when required profiles depend on carrier, telephony media, or noisy-call evidence.",
-      href: options.phoneProofHref ?? "/api/voice/phone/smoke",
-      id: "collect-phone-proof",
-      label: "Run phone profile proof"
-    });
+  const needsProfileProof = missingProfiles.length > 0 || warningProfiles.length > 0 || missingRoleProfiles.length > 0 || missingDepthProfiles.length > 0 || options.minCycles !== undefined && (report.summary.cycles ?? 0) < options.minCycles || options.minActionableProfiles !== undefined && report.defaults.summary.actionableProfiles < options.minActionableProfiles;
+  if (needsProfileProof) {
+    const targetProfileIds = missingProfiles.length > 0 || missingDepthProfiles.length > 0 ? [...new Set([...missingProfiles, ...missingDepthProfiles])] : [...requiredProfiles];
+    const targets = targetProfileIds.length > 0 ? targetProfileIds : [undefined];
+    for (const profileId of targets) {
+      actions.push({
+        description: profileId ? `Run browser profile proof for ${profileId} to collect microphone, WebSocket, live-latency, and provider traces.` : "Run browser profile proof to collect microphone, WebSocket, live-latency, and provider traces for missing profiles.",
+        href: appendRealCallRecoveryActionQuery(options.browserProofHref ?? "/voice/browser-call-profiles", { profileId }),
+        id: "collect-browser-proof",
+        label: profileId ? `Run browser profile proof for ${profileId}` : "Run browser profile proof",
+        profileId
+      });
+      actions.push({
+        description: profileId ? `Run phone profile proof for ${profileId} when the profile depends on carrier, telephony media, or noisy-call evidence.` : "Run phone profile proof when required profiles depend on carrier, telephony media, or noisy-call evidence.",
+        href: appendRealCallRecoveryActionQuery(options.phoneProofHref ?? "/api/voice/phone/smoke", { profileId }),
+        id: "collect-phone-proof",
+        label: profileId ? `Run phone profile proof for ${profileId}` : "Run phone profile proof",
+        profileId
+      });
+    }
   }
   if (options.maxAgeMs !== undefined && (ageMs === undefined || ageMs > options.maxAgeMs)) {
     actions.push({
@@ -5559,22 +5590,22 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
       productionReadinessHref: options.productionReadinessHref ?? actionPath("refresh")
     }).map((action) => ({
       ...action,
-      href: action.id === "collect-browser-proof" ? actionPath("collect-browser-proof") : action.id === "collect-phone-proof" ? actionPath("collect-phone-proof") : action.id === "collect-provider-role-evidence" ? actionPath("collect-provider-role-evidence") : action.href,
+      href: action.id === "collect-browser-proof" ? appendRealCallRecoveryActionQuery(actionPath("collect-browser-proof"), { profileId: action.profileId }) : action.id === "collect-phone-proof" ? appendRealCallRecoveryActionQuery(actionPath("collect-phone-proof"), { profileId: action.profileId }) : action.id === "collect-provider-role-evidence" ? actionPath("collect-provider-role-evidence") : action.href,
       method: action.id === "refresh" && (action.label === "Open real-call profile history" || action.label === "Open operations records") ? "GET" : "POST"
     }));
     return { actions, generatedAt: new Date().toISOString(), report };
   };
-  const runActionHandler = async (actionId, report) => {
+  const runActionHandler = async (actionId, report, profileId) => {
     const handler = options.handlers?.[actionId];
     if (!handler) {
       return;
     }
-    return await handler({ actionId, report });
+    return await handler({ actionId, profileId, report });
   };
-  const runActionAsJob = async (actionId, report) => {
+  const runActionAsJob = async (actionId, report, profileId) => {
     const job = await options.jobStore?.create({
       actionId,
-      message: `Queued real-call profile recovery action: ${actionId}.`,
+      message: `Queued real-call profile recovery action: ${actionId}${profileId ? ` for ${profileId}` : ""}.`,
       status: "queued"
     });
     if (!job) {
@@ -5590,7 +5621,7 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
           updatedAt: startedAt
         });
         try {
-          const result = await runActionHandler(actionId, report);
+          const result = await runActionHandler(actionId, report, profileId);
           const completedAt = new Date().toISOString();
           const ok = result?.ok ?? true;
           const status = result?.jobStatus ?? (result?.status === "fail" || ok === false ? "fail" : "pass");
@@ -5625,7 +5656,7 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
       status: "pass"
     };
   };
-  const runAction = async (actionId) => {
+  const runAction = async (actionId, profileId) => {
     const report = await loadReport();
     const handler = options.handlers?.[actionId];
     if (!handler) {
@@ -5638,12 +5669,12 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
       };
     }
     if (options.jobStore && asyncActionIds.has(actionId)) {
-      const queued = await runActionAsJob(actionId, report);
+      const queued = await runActionAsJob(actionId, report, profileId);
       if (queued) {
         return queued;
       }
     }
-    const result = await runActionHandler(actionId, report);
+    const result = await runActionHandler(actionId, report, profileId);
     return {
       actionId,
       generatedAt: new Date().toISOString(),
@@ -5702,8 +5733,12 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
     });
   });
   for (const actionId of Object.keys(realCallProfileActionPaths)) {
-    routes.post(actionPath(actionId), async ({ set }) => {
-      const result = await runAction(actionId);
+    routes.post(actionPath(actionId), async ({
+      query,
+      set
+    }) => {
+      const profileId = query.profileId?.trim() || undefined;
+      const result = await runAction(actionId, profileId);
       if (!result.ok) {
         set.status = 501;
       }

package/dist/index.js

@@ -16137,7 +16137,7 @@ var buildRealCallProfileReadinessIssues = (report, options) => {
 var uniqueRealCallProfileActions = (actions) => {
   const seen = new Set;
   return actions.filter((action) => {
-    const key = `${action.method ?? "GET"}:${action.href}:${action.label}`;
+    const key = `${action.method ?? "GET"}:${action.href}:${action.label}:${action.profileId ?? ""}`;
     if (seen.has(key)) {
       return false;
     }
@@ -16145,6 +16145,16 @@ var uniqueRealCallProfileActions = (actions) => {
     return true;
   });
 };
+var appendRealCallRecoveryActionQuery = (href, query) => {
+  const entries = Object.entries(query).filter((entry) => entry[1] !== undefined);
+  if (entries.length === 0) {
+    return href;
+  }
+  const [base = href, hash = ""] = href.split("#");
+  const separator = base.includes("?") ? "&" : "?";
+  const search = new URLSearchParams(entries).toString();
+  return `${base}${separator}${search}${hash ? `#${hash}` : ""}`;
+};
 var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
   const actions = [
     {
@@ -16165,20 +16175,41 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
   const missingProfiles = [...requiredProfiles].filter((profileId) => !profilesById.has(profileId));
   const warningProfiles = report.defaults.profiles.filter((profile) => (requiredProfiles.size === 0 || requiredProfiles.has(profile.profileId)) && profile.status !== "pass");
   const missingRoleProfiles = report.defaults.profiles.filter((profile) => (options.requiredProviderRoles ?? []).some((role) => !profile.providerRoutes[role]));
+  const summariesByProfile = new Map((report.summary.profiles ?? []).map((profile) => [profile.id, profile]));
+  const missingDepthProfiles = [...requiredProfiles].filter((profileId) => {
+    const summaryProfile = summariesByProfile.get(profileId);
+    if (options.minProfileCycles !== undefined && (summaryProfile?.cycles ?? 0) < options.minProfileCycles) {
+      return true;
+    }
+    if (options.minProfileSessions !== undefined && (summaryProfile?.sessionCount ?? 0) < options.minProfileSessions) {
+      return true;
+    }
+    const requiredProfileSurfaces = options.requiredProfileSurfaces;
+    const requiredSurfaces = requiredProfileSurfaces === undefined ? [] : Array.isArray(requiredProfileSurfaces) ? requiredProfileSurfaces : requiredProfileSurfaces[profileId] ?? [];
+    const observedSurfaces = new Set(summaryProfile?.surfaces ?? []);
+    return requiredSurfaces.some((surface) => !observedSurfaces.has(surface));
+  });
   const ageMs = report.trend.ageMs ?? (report.generatedAt ? Date.now() - new Date(report.generatedAt).getTime() : undefined);
-  if (missingProfiles.length > 0 || warningProfiles.length > 0 || missingRoleProfiles.length > 0 || options.minCycles !== undefined && (report.summary.cycles ?? 0) < options.minCycles || options.minActionableProfiles !== undefined && report.defaults.summary.actionableProfiles < options.minActionableProfiles) {
-    actions.push({
-      description: "Run browser profile proof to collect microphone, WebSocket, live-latency, and provider traces for missing profiles.",
-      href: options.browserProofHref ?? "/voice/browser-call-profiles",
-      id: "collect-browser-proof",
-      label: "Run browser profile proof"
-    });
-    actions.push({
-      description: "Run phone profile proof when required profiles depend on carrier, telephony media, or noisy-call evidence.",
-      href: options.phoneProofHref ?? "/api/voice/phone/smoke",
-      id: "collect-phone-proof",
-      label: "Run phone profile proof"
-    });
+  const needsProfileProof = missingProfiles.length > 0 || warningProfiles.length > 0 || missingRoleProfiles.length > 0 || missingDepthProfiles.length > 0 || options.minCycles !== undefined && (report.summary.cycles ?? 0) < options.minCycles || options.minActionableProfiles !== undefined && report.defaults.summary.actionableProfiles < options.minActionableProfiles;
+  if (needsProfileProof) {
+    const targetProfileIds = missingProfiles.length > 0 || missingDepthProfiles.length > 0 ? [...new Set([...missingProfiles, ...missingDepthProfiles])] : [...requiredProfiles];
+    const targets = targetProfileIds.length > 0 ? targetProfileIds : [undefined];
+    for (const profileId of targets) {
+      actions.push({
+        description: profileId ? `Run browser profile proof for ${profileId} to collect microphone, WebSocket, live-latency, and provider traces.` : "Run browser profile proof to collect microphone, WebSocket, live-latency, and provider traces for missing profiles.",
+        href: appendRealCallRecoveryActionQuery(options.browserProofHref ?? "/voice/browser-call-profiles", { profileId }),
+        id: "collect-browser-proof",
+        label: profileId ? `Run browser profile proof for ${profileId}` : "Run browser profile proof",
+        profileId
+      });
+      actions.push({
+        description: profileId ? `Run phone profile proof for ${profileId} when the profile depends on carrier, telephony media, or noisy-call evidence.` : "Run phone profile proof when required profiles depend on carrier, telephony media, or noisy-call evidence.",
+        href: appendRealCallRecoveryActionQuery(options.phoneProofHref ?? "/api/voice/phone/smoke", { profileId }),
+        id: "collect-phone-proof",
+        label: profileId ? `Run phone profile proof for ${profileId}` : "Run phone profile proof",
+        profileId
+      });
+    }
   }
   if (options.maxAgeMs !== undefined && (ageMs === undefined || ageMs > options.maxAgeMs)) {
     actions.push({
@@ -17028,22 +17059,22 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
       productionReadinessHref: options.productionReadinessHref ?? actionPath("refresh")
     }).map((action) => ({
       ...action,
-      href: action.id === "collect-browser-proof" ? actionPath("collect-browser-proof") : action.id === "collect-phone-proof" ? actionPath("collect-phone-proof") : action.id === "collect-provider-role-evidence" ? actionPath("collect-provider-role-evidence") : action.href,
+      href: action.id === "collect-browser-proof" ? appendRealCallRecoveryActionQuery(actionPath("collect-browser-proof"), { profileId: action.profileId }) : action.id === "collect-phone-proof" ? appendRealCallRecoveryActionQuery(actionPath("collect-phone-proof"), { profileId: action.profileId }) : action.id === "collect-provider-role-evidence" ? actionPath("collect-provider-role-evidence") : action.href,
       method: action.id === "refresh" && (action.label === "Open real-call profile history" || action.label === "Open operations records") ? "GET" : "POST"
     }));
     return { actions, generatedAt: new Date().toISOString(), report };
   };
-  const runActionHandler = async (actionId, report) => {
+  const runActionHandler = async (actionId, report, profileId) => {
     const handler = options.handlers?.[actionId];
     if (!handler) {
       return;
     }
-    return await handler({ actionId, report });
+    return await handler({ actionId, profileId, report });
   };
-  const runActionAsJob = async (actionId, report) => {
+  const runActionAsJob = async (actionId, report, profileId) => {
     const job = await options.jobStore?.create({
       actionId,
-      message: `Queued real-call profile recovery action: ${actionId}.`,
+      message: `Queued real-call profile recovery action: ${actionId}${profileId ? ` for ${profileId}` : ""}.`,
       status: "queued"
     });
     if (!job) {
@@ -17059,7 +17090,7 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
           updatedAt: startedAt
         });
         try {
-          const result = await runActionHandler(actionId, report);
+          const result = await runActionHandler(actionId, report, profileId);
           const completedAt = new Date().toISOString();
           const ok = result?.ok ?? true;
           const status = result?.jobStatus ?? (result?.status === "fail" || ok === false ? "fail" : "pass");
@@ -17094,7 +17125,7 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
       status: "pass"
     };
   };
-  const runAction = async (actionId) => {
+  const runAction = async (actionId, profileId) => {
     const report = await loadReport();
     const handler = options.handlers?.[actionId];
     if (!handler) {
@@ -17107,12 +17138,12 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
       };
     }
     if (options.jobStore && asyncActionIds.has(actionId)) {
-      const queued = await runActionAsJob(actionId, report);
+      const queued = await runActionAsJob(actionId, report, profileId);
       if (queued) {
         return queued;
       }
     }
-    const result = await runActionHandler(actionId, report);
+    const result = await runActionHandler(actionId, report, profileId);
     return {
       actionId,
       generatedAt: new Date().toISOString(),
@@ -17171,8 +17202,12 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
     });
   });
   for (const actionId of Object.keys(realCallProfileActionPaths)) {
-    routes.post(actionPath(actionId), async ({ set }) => {
-      const result = await runAction(actionId);
+    routes.post(actionPath(actionId), async ({
+      query,
+      set
+    }) => {
+      const profileId = query.profileId?.trim() || undefined;
+      const result = await runAction(actionId, profileId);
       if (!result.ok) {
         set.status = 501;
       }

package/dist/proofTrends.d.ts

@@ -377,6 +377,7 @@ export type VoiceRealCallProfileHistoryRoutesOptions = Omit<VoiceRealCallProfile
 export type VoiceRealCallProfileRecoveryActionId = 'collect-browser-proof' | 'collect-phone-proof' | 'collect-provider-role-evidence' | 'refresh';
 export type VoiceRealCallProfileRecoveryAction = VoiceProductionReadinessAction & {
     id: VoiceRealCallProfileRecoveryActionId;
+    profileId?: string;
 };
 export type VoiceRealCallProfileReadinessCheckOptions = {
     browserProofHref?: string;
@@ -409,6 +410,7 @@ export type VoiceRealCallProfileRecoveryJobHistoryCheckOptions = {
 };
 export type VoiceRealCallProfileRecoveryActionHandlerInput = {
     actionId: VoiceRealCallProfileRecoveryActionId;
+    profileId?: string;
     report: VoiceRealCallProfileHistoryReport;
 };
 export type VoiceRealCallProfileRecoveryActionResult = {

package/dist/react/index.js

@@ -2255,7 +2255,7 @@ var buildRealCallProfileReadinessIssues = (report, options) => {
 var uniqueRealCallProfileActions = (actions) => {
   const seen = new Set;
   return actions.filter((action) => {
-    const key = `${action.method ?? "GET"}:${action.href}:${action.label}`;
+    const key = `${action.method ?? "GET"}:${action.href}:${action.label}:${action.profileId ?? ""}`;
     if (seen.has(key)) {
       return false;
     }
@@ -2263,6 +2263,16 @@ var uniqueRealCallProfileActions = (actions) => {
     return true;
   });
 };
+var appendRealCallRecoveryActionQuery = (href, query) => {
+  const entries = Object.entries(query).filter((entry) => entry[1] !== undefined);
+  if (entries.length === 0) {
+    return href;
+  }
+  const [base = href, hash = ""] = href.split("#");
+  const separator = base.includes("?") ? "&" : "?";
+  const search = new URLSearchParams(entries).toString();
+  return `${base}${separator}${search}${hash ? `#${hash}` : ""}`;
+};
 var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
   const actions = [
     {
@@ -2283,20 +2293,41 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
   const missingProfiles = [...requiredProfiles].filter((profileId) => !profilesById.has(profileId));
   const warningProfiles = report.defaults.profiles.filter((profile) => (requiredProfiles.size === 0 || requiredProfiles.has(profile.profileId)) && profile.status !== "pass");
   const missingRoleProfiles = report.defaults.profiles.filter((profile) => (options.requiredProviderRoles ?? []).some((role) => !profile.providerRoutes[role]));
+  const summariesByProfile = new Map((report.summary.profiles ?? []).map((profile) => [profile.id, profile]));
+  const missingDepthProfiles = [...requiredProfiles].filter((profileId) => {
+    const summaryProfile = summariesByProfile.get(profileId);
+    if (options.minProfileCycles !== undefined && (summaryProfile?.cycles ?? 0) < options.minProfileCycles) {
+      return true;
+    }
+    if (options.minProfileSessions !== undefined && (summaryProfile?.sessionCount ?? 0) < options.minProfileSessions) {
+      return true;
+    }
+    const requiredProfileSurfaces = options.requiredProfileSurfaces;
+    const requiredSurfaces = requiredProfileSurfaces === undefined ? [] : Array.isArray(requiredProfileSurfaces) ? requiredProfileSurfaces : requiredProfileSurfaces[profileId] ?? [];
+    const observedSurfaces = new Set(summaryProfile?.surfaces ?? []);
+    return requiredSurfaces.some((surface) => !observedSurfaces.has(surface));
+  });
   const ageMs = report.trend.ageMs ?? (report.generatedAt ? Date.now() - new Date(report.generatedAt).getTime() : undefined);
-  if (missingProfiles.length > 0 || warningProfiles.length > 0 || missingRoleProfiles.length > 0 || options.minCycles !== undefined && (report.summary.cycles ?? 0) < options.minCycles || options.minActionableProfiles !== undefined && report.defaults.summary.actionableProfiles < options.minActionableProfiles) {
-    actions.push({
-      description: "Run browser profile proof to collect microphone, WebSocket, live-latency, and provider traces for missing profiles.",
-      href: options.browserProofHref ?? "/voice/browser-call-profiles",
-      id: "collect-browser-proof",
-      label: "Run browser profile proof"
-    });
-    actions.push({
-      description: "Run phone profile proof when required profiles depend on carrier, telephony media, or noisy-call evidence.",
-      href: options.phoneProofHref ?? "/api/voice/phone/smoke",
-      id: "collect-phone-proof",
-      label: "Run phone profile proof"
-    });
+  const needsProfileProof = missingProfiles.length > 0 || warningProfiles.length > 0 || missingRoleProfiles.length > 0 || missingDepthProfiles.length > 0 || options.minCycles !== undefined && (report.summary.cycles ?? 0) < options.minCycles || options.minActionableProfiles !== undefined && report.defaults.summary.actionableProfiles < options.minActionableProfiles;
+  if (needsProfileProof) {
+    const targetProfileIds = missingProfiles.length > 0 || missingDepthProfiles.length > 0 ? [...new Set([...missingProfiles, ...missingDepthProfiles])] : [...requiredProfiles];
+    const targets = targetProfileIds.length > 0 ? targetProfileIds : [undefined];
+    for (const profileId of targets) {
+      actions.push({
+        description: profileId ? `Run browser profile proof for ${profileId} to collect microphone, WebSocket, live-latency, and provider traces.` : "Run browser profile proof to collect microphone, WebSocket, live-latency, and provider traces for missing profiles.",
+        href: appendRealCallRecoveryActionQuery(options.browserProofHref ?? "/voice/browser-call-profiles", { profileId }),
+        id: "collect-browser-proof",
+        label: profileId ? `Run browser profile proof for ${profileId}` : "Run browser profile proof",
+        profileId
+      });
+      actions.push({
+        description: profileId ? `Run phone profile proof for ${profileId} when the profile depends on carrier, telephony media, or noisy-call evidence.` : "Run phone profile proof when required profiles depend on carrier, telephony media, or noisy-call evidence.",
+        href: appendRealCallRecoveryActionQuery(options.phoneProofHref ?? "/api/voice/phone/smoke", { profileId }),
+        id: "collect-phone-proof",
+        label: profileId ? `Run phone profile proof for ${profileId}` : "Run phone profile proof",
+        profileId
+      });
+    }
   }
   if (options.maxAgeMs !== undefined && (ageMs === undefined || ageMs > options.maxAgeMs)) {
     actions.push({
@@ -3146,22 +3177,22 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
       productionReadinessHref: options.productionReadinessHref ?? actionPath("refresh")
     }).map((action) => ({
       ...action,
-      href: action.id === "collect-browser-proof" ? actionPath("collect-browser-proof") : action.id === "collect-phone-proof" ? actionPath("collect-phone-proof") : action.id === "collect-provider-role-evidence" ? actionPath("collect-provider-role-evidence") : action.href,
+      href: action.id === "collect-browser-proof" ? appendRealCallRecoveryActionQuery(actionPath("collect-browser-proof"), { profileId: action.profileId }) : action.id === "collect-phone-proof" ? appendRealCallRecoveryActionQuery(actionPath("collect-phone-proof"), { profileId: action.profileId }) : action.id === "collect-provider-role-evidence" ? actionPath("collect-provider-role-evidence") : action.href,
       method: action.id === "refresh" && (action.label === "Open real-call profile history" || action.label === "Open operations records") ? "GET" : "POST"
     }));
     return { actions, generatedAt: new Date().toISOString(), report };
   };
-  const runActionHandler = async (actionId, report) => {
+  const runActionHandler = async (actionId, report, profileId) => {
     const handler = options.handlers?.[actionId];
     if (!handler) {
       return;
     }
-    return await handler({ actionId, report });
+    return await handler({ actionId, profileId, report });
   };
-  const runActionAsJob = async (actionId, report) => {
+  const runActionAsJob = async (actionId, report, profileId) => {
     const job = await options.jobStore?.create({
       actionId,
-      message: `Queued real-call profile recovery action: ${actionId}.`,
+      message: `Queued real-call profile recovery action: ${actionId}${profileId ? ` for ${profileId}` : ""}.`,
       status: "queued"
     });
     if (!job) {
@@ -3177,7 +3208,7 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
           updatedAt: startedAt
         });
         try {
-          const result = await runActionHandler(actionId, report);
+          const result = await runActionHandler(actionId, report, profileId);
           const completedAt = new Date().toISOString();
           const ok = result?.ok ?? true;
           const status = result?.jobStatus ?? (result?.status === "fail" || ok === false ? "fail" : "pass");
@@ -3212,7 +3243,7 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
       status: "pass"
     };
   };
-  const runAction = async (actionId) => {
+  const runAction = async (actionId, profileId) => {
     const report = await loadReport();
     const handler = options.handlers?.[actionId];
     if (!handler) {
@@ -3225,12 +3256,12 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
       };
     }
     if (options.jobStore && asyncActionIds.has(actionId)) {
-      const queued = await runActionAsJob(actionId, report);
+      const queued = await runActionAsJob(actionId, report, profileId);
       if (queued) {
         return queued;
       }
     }
-    const result = await runActionHandler(actionId, report);
+    const result = await runActionHandler(actionId, report, profileId);
     return {
       actionId,
       generatedAt: new Date().toISOString(),
@@ -3289,8 +3320,12 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
     });
   });
   for (const actionId of Object.keys(realCallProfileActionPaths)) {
-    routes.post(actionPath(actionId), async ({ set }) => {
-      const result = await runAction(actionId);
+    routes.post(actionPath(actionId), async ({
+      query,
+      set
+    }) => {
+      const profileId = query.profileId?.trim() || undefined;
+      const result = await runAction(actionId, profileId);
       if (!result.ok) {
         set.status = 501;
       }

package/dist/vue/index.js

@@ -2176,7 +2176,7 @@ var buildRealCallProfileReadinessIssues = (report, options) => {
 var uniqueRealCallProfileActions = (actions) => {
   const seen = new Set;
   return actions.filter((action) => {
-    const key = `${action.method ?? "GET"}:${action.href}:${action.label}`;
+    const key = `${action.method ?? "GET"}:${action.href}:${action.label}:${action.profileId ?? ""}`;
     if (seen.has(key)) {
       return false;
     }
@@ -2184,6 +2184,16 @@ var uniqueRealCallProfileActions = (actions) => {
     return true;
   });
 };
+var appendRealCallRecoveryActionQuery = (href, query) => {
+  const entries = Object.entries(query).filter((entry) => entry[1] !== undefined);
+  if (entries.length === 0) {
+    return href;
+  }
+  const [base = href, hash = ""] = href.split("#");
+  const separator = base.includes("?") ? "&" : "?";
+  const search = new URLSearchParams(entries).toString();
+  return `${base}${separator}${search}${hash ? `#${hash}` : ""}`;
+};
 var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
   const actions = [
     {
@@ -2204,20 +2214,41 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
   const missingProfiles = [...requiredProfiles].filter((profileId) => !profilesById.has(profileId));
   const warningProfiles = report.defaults.profiles.filter((profile) => (requiredProfiles.size === 0 || requiredProfiles.has(profile.profileId)) && profile.status !== "pass");
   const missingRoleProfiles = report.defaults.profiles.filter((profile) => (options.requiredProviderRoles ?? []).some((role) => !profile.providerRoutes[role]));
+  const summariesByProfile = new Map((report.summary.profiles ?? []).map((profile) => [profile.id, profile]));
+  const missingDepthProfiles = [...requiredProfiles].filter((profileId) => {
+    const summaryProfile = summariesByProfile.get(profileId);
+    if (options.minProfileCycles !== undefined && (summaryProfile?.cycles ?? 0) < options.minProfileCycles) {
+      return true;
+    }
+    if (options.minProfileSessions !== undefined && (summaryProfile?.sessionCount ?? 0) < options.minProfileSessions) {
+      return true;
+    }
+    const requiredProfileSurfaces = options.requiredProfileSurfaces;
+    const requiredSurfaces = requiredProfileSurfaces === undefined ? [] : Array.isArray(requiredProfileSurfaces) ? requiredProfileSurfaces : requiredProfileSurfaces[profileId] ?? [];
+    const observedSurfaces = new Set(summaryProfile?.surfaces ?? []);
+    return requiredSurfaces.some((surface) => !observedSurfaces.has(surface));
+  });
   const ageMs = report.trend.ageMs ?? (report.generatedAt ? Date.now() - new Date(report.generatedAt).getTime() : undefined);
-  if (missingProfiles.length > 0 || warningProfiles.length > 0 || missingRoleProfiles.length > 0 || options.minCycles !== undefined && (report.summary.cycles ?? 0) < options.minCycles || options.minActionableProfiles !== undefined && report.defaults.summary.actionableProfiles < options.minActionableProfiles) {
-    actions.push({
-      description: "Run browser profile proof to collect microphone, WebSocket, live-latency, and provider traces for missing profiles.",
-      href: options.browserProofHref ?? "/voice/browser-call-profiles",
-      id: "collect-browser-proof",
-      label: "Run browser profile proof"
-    });
-    actions.push({
-      description: "Run phone profile proof when required profiles depend on carrier, telephony media, or noisy-call evidence.",
-      href: options.phoneProofHref ?? "/api/voice/phone/smoke",
-      id: "collect-phone-proof",
-      label: "Run phone profile proof"
-    });
+  const needsProfileProof = missingProfiles.length > 0 || warningProfiles.length > 0 || missingRoleProfiles.length > 0 || missingDepthProfiles.length > 0 || options.minCycles !== undefined && (report.summary.cycles ?? 0) < options.minCycles || options.minActionableProfiles !== undefined && report.defaults.summary.actionableProfiles < options.minActionableProfiles;
+  if (needsProfileProof) {
+    const targetProfileIds = missingProfiles.length > 0 || missingDepthProfiles.length > 0 ? [...new Set([...missingProfiles, ...missingDepthProfiles])] : [...requiredProfiles];
+    const targets = targetProfileIds.length > 0 ? targetProfileIds : [undefined];
+    for (const profileId of targets) {
+      actions.push({
+        description: profileId ? `Run browser profile proof for ${profileId} to collect microphone, WebSocket, live-latency, and provider traces.` : "Run browser profile proof to collect microphone, WebSocket, live-latency, and provider traces for missing profiles.",
+        href: appendRealCallRecoveryActionQuery(options.browserProofHref ?? "/voice/browser-call-profiles", { profileId }),
+        id: "collect-browser-proof",
+        label: profileId ? `Run browser profile proof for ${profileId}` : "Run browser profile proof",
+        profileId
+      });
+      actions.push({
+        description: profileId ? `Run phone profile proof for ${profileId} when the profile depends on carrier, telephony media, or noisy-call evidence.` : "Run phone profile proof when required profiles depend on carrier, telephony media, or noisy-call evidence.",
+        href: appendRealCallRecoveryActionQuery(options.phoneProofHref ?? "/api/voice/phone/smoke", { profileId }),
+        id: "collect-phone-proof",
+        label: profileId ? `Run phone profile proof for ${profileId}` : "Run phone profile proof",
+        profileId
+      });
+    }
   }
   if (options.maxAgeMs !== undefined && (ageMs === undefined || ageMs > options.maxAgeMs)) {
     actions.push({
@@ -3067,22 +3098,22 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
       productionReadinessHref: options.productionReadinessHref ?? actionPath("refresh")
     }).map((action) => ({
       ...action,
-      href: action.id === "collect-browser-proof" ? actionPath("collect-browser-proof") : action.id === "collect-phone-proof" ? actionPath("collect-phone-proof") : action.id === "collect-provider-role-evidence" ? actionPath("collect-provider-role-evidence") : action.href,
+      href: action.id === "collect-browser-proof" ? appendRealCallRecoveryActionQuery(actionPath("collect-browser-proof"), { profileId: action.profileId }) : action.id === "collect-phone-proof" ? appendRealCallRecoveryActionQuery(actionPath("collect-phone-proof"), { profileId: action.profileId }) : action.id === "collect-provider-role-evidence" ? actionPath("collect-provider-role-evidence") : action.href,
       method: action.id === "refresh" && (action.label === "Open real-call profile history" || action.label === "Open operations records") ? "GET" : "POST"
     }));
     return { actions, generatedAt: new Date().toISOString(), report };
   };
-  const runActionHandler = async (actionId, report) => {
+  const runActionHandler = async (actionId, report, profileId) => {
     const handler = options.handlers?.[actionId];
     if (!handler) {
       return;
     }
-    return await handler({ actionId, report });
+    return await handler({ actionId, profileId, report });
   };
-  const runActionAsJob = async (actionId, report) => {
+  const runActionAsJob = async (actionId, report, profileId) => {
     const job = await options.jobStore?.create({
       actionId,
-      message: `Queued real-call profile recovery action: ${actionId}.`,
+      message: `Queued real-call profile recovery action: ${actionId}${profileId ? ` for ${profileId}` : ""}.`,
       status: "queued"
     });
     if (!job) {
@@ -3098,7 +3129,7 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
           updatedAt: startedAt
         });
         try {
-          const result = await runActionHandler(actionId, report);
+          const result = await runActionHandler(actionId, report, profileId);
           const completedAt = new Date().toISOString();
           const ok = result?.ok ?? true;
           const status = result?.jobStatus ?? (result?.status === "fail" || ok === false ? "fail" : "pass");
@@ -3133,7 +3164,7 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
       status: "pass"
     };
   };
-  const runAction = async (actionId) => {
+  const runAction = async (actionId, profileId) => {
     const report = await loadReport();
     const handler = options.handlers?.[actionId];
     if (!handler) {
@@ -3146,12 +3177,12 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
       };
     }
     if (options.jobStore && asyncActionIds.has(actionId)) {
-      const queued = await runActionAsJob(actionId, report);
+      const queued = await runActionAsJob(actionId, report, profileId);
       if (queued) {
         return queued;
       }
     }
-    const result = await runActionHandler(actionId, report);
+    const result = await runActionHandler(actionId, report, profileId);
     return {
       actionId,
       generatedAt: new Date().toISOString(),
@@ -3210,8 +3241,12 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
     });
   });
   for (const actionId of Object.keys(realCallProfileActionPaths)) {
-    routes.post(actionPath(actionId), async ({ set }) => {
-      const result = await runAction(actionId);
+    routes.post(actionPath(actionId), async ({
+      query,
+      set
+    }) => {
+      const profileId = query.profileId?.trim() || undefined;
+      const result = await runAction(actionId, profileId);
       if (!result.ok) {
         set.status = 501;
       }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@absolutejs/voice",
-	"version": "0.0.22-beta.380",
+	"version": "0.0.22-beta.382",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",