Skip to content

🙌 OpenHands: AI-Driven Development

feat: Make automation run UI task-outcome aware (#16937)

Rohit Malhotra744e8652f254
diff --git a/__tests__/components/automations/detail/activity-log-item.test.tsx b/__tests__/components/automations/detail/activity-log-item.test.tsx
index 250bfc9459..780bf0a6a7 100644
--- a/__tests__/components/automations/detail/activity-log-item.test.tsx
+++ b/__tests__/components/automations/detail/activity-log-item.test.tsx
@@ -180,6 +180,64 @@ describe("ActivityLogItem — Conversation not created label", () => {
});
});
+describe("ActivityLogItem — task outcome display", () => {
+ beforeEach(() => {
+ __resetActiveStoreForTests();
+ setRegisteredBackends([localBackend]);
+ setActiveSelection({ backendId: localBackend.id });
+ });
+
+ afterEach(() => {
+ __resetActiveStoreForTests();
+ });
+
+ it("shows a blocked task badge and task summary for a completed run", () => {
+ const run = makeRun({
+ status: AutomationRunStatus.COMPLETED,
+ error_detail: "HUBSPOT_API_KEY was unavailable.",
+ run_metadata: {
+ finish_tool_response: {
+ status: "blocked",
+ outcome_summary:
+ "Attempted HubSpot CRM contact search but HUBSPOT_API_KEY was unavailable.",
+ },
+ },
+ });
+
+ renderItem(run);
+
+ expect(
+ screen.getByText(I18nKey.AUTOMATIONS$DETAIL$BLOCKED),
+ ).toBeInTheDocument();
+ expect(
+ screen.getByText(
+ "Attempted HubSpot CRM contact search but HUBSPOT_API_KEY was unavailable.",
+ ),
+ ).toBeInTheDocument();
+ expect(
+ screen.queryByText(I18nKey.AUTOMATIONS$DETAIL$SUCCESSFUL),
+ ).not.toBeInTheDocument();
+ expect(
+ screen.queryByText("HUBSPOT_API_KEY was unavailable."),
+ ).not.toBeInTheDocument();
+ });
+
+ it("shows failed lifecycle errors as neutral row summaries", () => {
+ const run = makeRun({
+ status: AutomationRunStatus.FAILED,
+ error_detail: "The run stopped before the task finished.",
+ });
+
+ renderItem(run);
+
+ const summary = screen.getByText(
+ "The run stopped before the task finished.",
+ );
+ expect(summary).toBeInTheDocument();
+ expect(summary.className).not.toContain("oh-status-error");
+ });
+});
+
describe("ActivityLogItem — timestamp fallback", () => {
beforeEach(() => {
__resetActiveStoreForTests();
diff --git a/__tests__/components/automations/detail/run-logs-modal.test.tsx b/__tests__/components/automations/detail/run-logs-modal.test.tsx
index 20a500b0de..761bbc49cc 100644
--- a/__tests__/components/automations/detail/run-logs-modal.test.tsx
+++ b/__tests__/components/automations/detail/run-logs-modal.test.tsx
@@ -287,6 +287,131 @@ describe("RunLogsModal", () => {
});
});
+describe("RunLogsModal — run inspection summary", () => {
+ const makeRun = (overrides: Partial<AutomationRun> = {}): AutomationRun => ({
+ id: "run-1",
+ status: AutomationRunStatus.COMPLETED,
+ conversation_id: "conv-1",
+ bash_command_id: "cmd-1",
+ error_detail: null,
+ started_at: "2026-01-01T10:00:00Z",
+ completed_at: "2026-01-01T10:02:00Z",
+ ...overrides,
+ });
+
+ it("labels run, task, and system details for a completed blocked task", () => {
+ useBashCommandLogsMock.mockReturnValue(makeHookResult());
+
+ render(
+ <RunLogsModal
+ isOpen
+ conversationId="conv-1"
+ bashCommandId="cmd-1"
+ onClose={() => {}}
+ run={makeRun({
+ error_detail: "Environment variable HUBSPOT_API_KEY is missing.",
+ status_detail: {
+ phase: "callback",
+ kind: "execution_error",
+ detail: "Environment variable HUBSPOT_API_KEY is missing.",
+ source: "environment",
+ },
+ run_metadata: {
+ finish_tool_response: {
+ status: "blocked",
+ outcome_summary:
+ "Attempted HubSpot CRM contact search but HUBSPOT_API_KEY was unavailable.",
+ },
+ },
+ })}
+ />,
+ );
+
+ expect(
+ screen.getByText(I18nKey.AUTOMATIONS$DETAIL$RUN_LABEL),
+ ).toBeInTheDocument();
+ expect(screen.getByText("COMPLETED")).toBeInTheDocument();
+ expect(
+ screen.getByText(I18nKey.AUTOMATIONS$DETAIL$TASK_LABEL),
+ ).toBeInTheDocument();
+ expect(
+ screen.getByText(I18nKey.AUTOMATIONS$DETAIL$BLOCKED),
+ ).toBeInTheDocument();
+ expect(
+ screen.getByText(
+ "Attempted HubSpot CRM contact search but HUBSPOT_API_KEY was unavailable.",
+ ),
+ ).toBeInTheDocument();
+ expect(
+ screen.getByText(I18nKey.AUTOMATIONS$DETAIL$SYSTEM_LABEL),
+ ).toBeInTheDocument();
+ expect(
+ screen.getAllByText(/Environment variable HUBSPOT_API_KEY is missing/),
+ ).toHaveLength(2);
+ expect(screen.getByText(/callback · execution_error/)).toBeInTheDocument();
+ });
+
+ it("keeps infrastructure failures in the system section when no task outcome exists", () => {
+ useBashCommandLogsMock.mockReturnValue(makeHookResult());
+
+ render(
+ <RunLogsModal
+ isOpen
+ conversationId="conv-1"
+ bashCommandId="cmd-1"
+ onClose={() => {}}
+ run={makeRun({
+ status: AutomationRunStatus.FAILED,
+ error_detail: "Sandbox timed out.",
+ })}
+ />,
+ );
+
+ expect(screen.getByText("FAILED")).toBeInTheDocument();
+ expect(
+ screen.getByText(I18nKey.AUTOMATIONS$DETAIL$NO_TASK_OUTCOME),
+ ).toBeInTheDocument();
+ expect(screen.getByText(/Sandbox timed out/)).toBeInTheDocument();
+ });
+
+ it("falls back to a readable JSON block for custom task metadata", () => {
+ useBashCommandLogsMock.mockReturnValue(makeHookResult());
+
+ render(
+ <RunLogsModal
+ isOpen
+ conversationId="conv-1"
+ bashCommandId="cmd-1"
+ onClose={() => {}}
+ run={makeRun({
+ run_metadata: {
+ finish_tool_response: {
+ crm_contacts_checked: 12,
+ matches: ["Acme", "Globex"],
+ next_action: "Ask user to pick a contact.",
+ },
+ },
+ })}
+ />,
+ );
+
+ expect(
+ screen.getByText(I18nKey.AUTOMATIONS$DETAIL$NEEDS_REVIEW),
+ ).toBeInTheDocument();
+ expect(
+ screen.getByText(I18nKey.AUTOMATIONS$DETAIL$CUSTOM_TASK_METADATA),
+ ).toBeInTheDocument();
+ expect(
+ screen.getByText(I18nKey.AUTOMATIONS$DETAIL$TASK_METADATA),
+ ).toBeInTheDocument();
+ const metadata = screen.getByTestId("automation-task-metadata");
+ expect(metadata).toHaveTextContent('"crm_contacts_checked": 12');
+ expect(metadata).toHaveTextContent(
+ '"next_action": "Ask user to pick a contact."',
+ );
+ });
+});
+
describe("RunLogsModal — Debug with OpenHands button", () => {
const makeRun = (status: AutomationRunStatus): AutomationRun => ({
id: "run-1",
diff --git a/__tests__/components/automations/detail/run-status-badge.test.tsx b/__tests__/components/automations/detail/run-status-badge.test.tsx
index 0181de0b2e..14db3cd7ff 100644
--- a/__tests__/components/automations/detail/run-status-badge.test.tsx
+++ b/__tests__/components/automations/detail/run-status-badge.test.tsx
@@ -12,11 +12,19 @@ describe("RunStatusBadge", () => {
[AutomationRunStatus.RUNNING, I18nKey.AUTOMATIONS$DETAIL$RUNNING],
[AutomationRunStatus.CANCELLED, I18nKey.AUTOMATIONS$DETAIL$CANCELLED],
[AutomationRunStatus.SKIPPED, I18nKey.AUTOMATIONS$DETAIL$SKIPPED],
- ])("renders the %s label for the matching status", (status, labelKey) => {
- render(<RunStatusBadge status={status} />);
+ ["success", I18nKey.AUTOMATIONS$DETAIL$SUCCESSFUL],
+ ["blocked", I18nKey.AUTOMATIONS$DETAIL$BLOCKED],
+ ["failed", I18nKey.AUTOMATIONS$DETAIL$FAILED],
+ ["partial_success", I18nKey.AUTOMATIONS$DETAIL$PARTIAL],
+ ["unknown", I18nKey.AUTOMATIONS$DETAIL$NEEDS_REVIEW],
+ ] as const)(
+ "renders the %s label for the matching status",
+ (status, labelKey) => {
+ render(<RunStatusBadge status={status} />);
- expect(screen.getByText(labelKey)).toBeInTheDocument();
- });
+ expect(screen.getByText(labelKey)).toBeInTheDocument();
+ },
+ );
it.each([
[AutomationRunStatus.COMPLETED, "run-status-icon-completed"],
@@ -25,7 +33,12 @@ describe("RunStatusBadge", () => {
[AutomationRunStatus.RUNNING, "run-status-icon-running"],
[AutomationRunStatus.CANCELLED, "run-status-icon-pending"],
[AutomationRunStatus.SKIPPED, "run-status-icon-pending"],
- ])(
+ ["success", "run-status-icon-completed"],
+ ["blocked", "run-status-icon-warning"],
+ ["failed", "run-status-icon-failed"],
+ ["partial_success", "run-status-icon-warning"],
+ ["unknown", "run-status-icon-needs-review"],
+ ] as const)(
"renders the %s icon variant for the matching status",
(status, testId) => {
render(<RunStatusBadge status={status} />);
@@ -43,11 +56,11 @@ describe("RunStatusBadge", () => {
});
it("renders an icon-only mark with the status label as aria-label", () => {
- render(
- <RunStatusBadge status={AutomationRunStatus.COMPLETED} iconOnly />,
- );
+ render(<RunStatusBadge status={AutomationRunStatus.COMPLETED} iconOnly />);
- expect(screen.queryByText(I18nKey.AUTOMATIONS$DETAIL$SUCCESSFUL)).toBeNull();
+ expect(
+ screen.queryByText(I18nKey.AUTOMATIONS$DETAIL$SUCCESSFUL),
+ ).toBeNull();
expect(screen.getByTestId("run-status-badge-icon")).toHaveAttribute(
"aria-label",
I18nKey.AUTOMATIONS$DETAIL$SUCCESSFUL,
diff --git a/__tests__/components/features/home/automation-run-activity-sparkline.test.ts b/__tests__/components/features/home/automation-run-activity-sparkline.test.ts
index d9855188f3..0d30b15d1e 100644
--- a/__tests__/components/features/home/automation-run-activity-sparkline.test.ts
+++ b/__tests__/components/features/home/automation-run-activity-sparkline.test.ts
@@ -102,4 +102,19 @@ describe("barColorClassForStatus", () => {
expect(classes).toContain("var(--oh-muted)");
expect(classes).toContain("var(--oh-border)");
});
+
+ it("uses warning color for blocked task outcomes", () => {
+ expect(barColorClassForStatus("blocked")).toContain(
+ "bg-[var(--oh-warning)]",
+ );
+ });
+
+ it("uses warning color for partial and unknown task outcomes", () => {
+ expect(barColorClassForStatus("partial_success")).toContain(
+ "bg-[var(--oh-warning)]",
+ );
+ expect(barColorClassForStatus("unknown")).toContain(
+ "bg-[var(--oh-warning)]",
+ );
+ });
});
diff --git a/__tests__/components/features/home/featured-automations-section.test.tsx b/__tests__/components/features/home/featured-automations-section.test.tsx
index b516d3aa11..c14d8011e7 100644
--- a/__tests__/components/features/home/featured-automations-section.test.tsx
+++ b/__tests__/components/features/home/featured-automations-section.test.tsx
@@ -191,12 +191,12 @@ describe("home automations composer layout", () => {
expect(
await screen.findByRole("link", {
- name: /Daily digest\s*FEATURED_AUTOMATIONS\$LAST_RUN_SUCCEEDED/,
+ name: /Daily digest\s*AUTOMATIONS\$DETAIL\$SUCCESSFUL/,
}),
).toBeInTheDocument();
expect(
await screen.findByRole("link", {
- name: /PR review\s*FEATURED_AUTOMATIONS\$LAST_RUN_FAILED/,
+ name: /PR review\s*AUTOMATIONS\$DETAIL\$FAILED/,
}),
).toBeInTheDocument();
expect(screen.queryByText("Disabled sweep")).not.toBeInTheDocument();
diff --git a/__tests__/components/features/home/home-automation-run-tooltip.test.tsx b/__tests__/components/features/home/home-automation-run-tooltip.test.tsx
index 0a5aa085de..b6305ab714 100644
--- a/__tests__/components/features/home/home-automation-run-tooltip.test.tsx
+++ b/__tests__/components/features/home/home-automation-run-tooltip.test.tsx
@@ -148,3 +148,40 @@ describe("HomeAutomationRunTooltip — phase", () => {
expect(screen.queryByTestId("run-phase-row")).not.toBeInTheDocument();
});
});
+
+describe("HomeAutomationRunTooltip — task outcome", () => {
+ it("shows completed run task outcome and summary instead of infra error copy", () => {
+ render(
+ <HomeAutomationRunTooltip
+ automation={automation}
+ runState={makeState(
+ makeRun({
+ status: AutomationRunStatus.COMPLETED,
+ completed_at: "2026-08-01T10:05:00Z",
+ error_detail: "HUBSPOT_API_KEY was unavailable.",
+ run_metadata: {
+ finish_tool_response: {
+ status: "blocked",
+ outcome_summary:
+ "Attempted HubSpot CRM contact search but HUBSPOT_API_KEY was unavailable.",
+ },
+ },
+ }),
+ )}
+ />,
+ );
+
+ expect(screen.getByText("AUTOMATIONS$DETAIL$BLOCKED")).toBeInTheDocument();
+ expect(
+ screen.getByText("AUTOMATIONS$DETAIL$TASK_LABEL"),
+ ).toBeInTheDocument();
+ expect(
+ screen.getByText(
+ "Attempted HubSpot CRM contact search but HUBSPOT_API_KEY was unavailable.",
+ ),
+ ).toBeInTheDocument();
+ expect(
+ screen.queryByText("HUBSPOT_API_KEY was unavailable."),
+ ).not.toBeInTheDocument();
+ });
+});
diff --git a/__tests__/manifests/automation-insights.test.ts b/__tests__/manifests/automation-insights.test.ts
index 26bf208ed4..9ae25dce59 100644
--- a/__tests__/manifests/automation-insights.test.ts
+++ b/__tests__/manifests/automation-insights.test.ts
@@ -106,6 +106,33 @@ describe("deriveAutomationHealth", () => {
settled({ latestRun: createRun() }),
"healthy",
],
+ [
+ "a completed but blocked latest task means failing",
+ createAutomation(),
+ settled({
+ latestRun: createRun({
+ run_metadata: {
+ finish_tool_response: {
+ status: "blocked",
+ outcome_summary: "Missing HubSpot credentials.",
+ },
+ },
+ }),
+ }),
+ "failing",
+ ],
+ [
+ "a completed latest task with custom metadata is unknown",
+ createAutomation(),
+ settled({
+ latestRun: createRun({
+ run_metadata: {
+ finish_tool_response: { crm_contacts_checked: 12 },
+ },
+ }),
+ }),
+ "unknown",
+ ],
[
// Statuses the backend added after the dashboard's reference design:
// neither a success nor a failure, so not "failing".
@@ -114,7 +141,7 @@ describe("deriveAutomationHealth", () => {
settled({
latestRun: createRun({ status: AutomationRunStatus.CANCELLED }),
}),
- "healthy",
+ "unknown",
],
])("%s", (_case, automation, state, expected) => {
expect(deriveAutomationHealth(automation, state)).toBe(expected);
@@ -145,6 +172,17 @@ describe("summarizeAutomationRuns", () => {
createRun({ status: AutomationRunStatus.CANCELLED, completed_at: null }),
createRun({ status: AutomationRunStatus.SKIPPED, completed_at: null }),
createRun({ status: AutomationRunStatus.RUNNING, completed_at: null }),
+ createRun({
+ id: "blocked-task",
+ started_at: "2026-01-02T00:00:00Z",
+ completed_at: "2026-01-02T00:01:00Z",
+ run_metadata: {
+ finish_tool_response: {
+ status: "blocked",
+ outcome_summary: "Missing HubSpot credentials.",
+ },
+ },
+ }),
createRun({
started_at: "2026-01-01T00:00:00Z",
completed_at: "2026-01-01T00:01:30Z",
@@ -154,7 +192,7 @@ describe("summarizeAutomationRuns", () => {
// Act
const summary = summarizeAutomationRuns({ runs, total: 40 });
- // Assert — success rate and durations consider COMPLETED and FAILED only;
+ // Assert — success rate counts task-successful terminal runs only;
// total is the response's lifetime count, not the sample's length. With
// no status_counts and more history than the sample, the completed count
// is unknowable rather than guessed.
@@ -163,8 +201,8 @@ describe("summarizeAutomationRuns", () => {
completedTotal: null,
latestRun: runs[0],
recentRuns: runs,
- recentSuccessRate: 0.5,
- averageDurationMs: (30_000 + 90_000) / 2,
+ recentSuccessRate: 1 / 3,
+ averageDurationMs: (30_000 + 60_000 + 90_000) / 3,
});
});
diff --git a/__tests__/utils/automation-run-display.test.ts b/__tests__/utils/automation-run-display.test.ts
new file mode 100644
index 0000000000..5b1ea48535
--- /dev/null
+++ b/__tests__/utils/automation-run-display.test.ts
@@ -0,0 +1,140 @@
+import { describe, expect, it } from "vitest";
+import {
+ getAutomationRunBadgeLabelKey,
+ getAutomationRunDisplay,
+ getAutomationRunTaskOutcome,
+} from "#/utils/automation-run-display";
+import { AutomationRunStatus, type AutomationRun } from "#/types/automation";
+import { I18nKey } from "#/i18n/declaration";
+
+function makeRun(overrides: Partial<AutomationRun> = {}): AutomationRun {
+ return {
+ id: "run-1",
+ status: AutomationRunStatus.COMPLETED,
+ conversation_id: "conv-1",
+ bash_command_id: "cmd-1",
+ error_detail: null,
+ started_at: "2026-01-01T10:00:00Z",
+ completed_at: "2026-01-01T10:02:00Z",
+ ...overrides,
+ };
+}
+
+describe("automation run display", () => {
+ it.each([
+ ["success", "success", I18nKey.AUTOMATIONS$DETAIL$SUCCESSFUL],
+ ["blocked", "blocked", I18nKey.AUTOMATIONS$DETAIL$BLOCKED],
+ ["failed", "failed", I18nKey.AUTOMATIONS$DETAIL$FAILED],
+ ["partial_success", "partial_success", I18nKey.AUTOMATIONS$DETAIL$PARTIAL],
+ ["unknown", "unknown", I18nKey.AUTOMATIONS$DETAIL$NEEDS_REVIEW],
+ ] as const)(
+ "uses completed run task outcome %s as the display badge",
+ (outcomeStatus, expectedBadge, expectedLabel) => {
+ const run = makeRun({
+ status: AutomationRunStatus.COMPLETED,
+ error_detail: "HUBSPOT_API_KEY was unavailable.",
+ run_metadata: {
+ finish_tool_response: {
+ status: outcomeStatus,
+ outcome_summary:
+ "Attempted the contact search but the key was missing.",
+ },
+ },
+ });
+
+ const display = getAutomationRunDisplay(run);
+
+ expect(display.badgeStatus).toBe(expectedBadge);
+ expect(display.summary).toBe(
+ "Attempted the contact search but the key was missing.",
+ );
+ expect(display.customTaskMetadataText).toBeNull();
+ expect(getAutomationRunBadgeLabelKey(display.badgeStatus)).toBe(
+ expectedLabel,
+ );
+ },
+ );
+
+ it("defaults a completed run with no task outcome to successful", () => {
+ const display = getAutomationRunDisplay(makeRun());
+
+ expect(display.badgeStatus).toBe("success");
+ expect(display.summary).toBeNull();
+ expect(display.taskOutcome).toBeNull();
+ });
+
+ it("keeps lifecycle status for failed infrastructure runs and shows error as row summary", () => {
+ const display = getAutomationRunDisplay(
+ makeRun({
+ status: AutomationRunStatus.FAILED,
+ error_detail: "Sandbox timed out.",
+ }),
+ );
+
+ expect(display.badgeStatus).toBe(AutomationRunStatus.FAILED);
+ expect(display.summary).toBe("Sandbox timed out.");
+ });
+
+ it("treats an invalid finish tool status as needs review", () => {
+ const run = makeRun({
+ run_metadata: {
+ finish_tool_response: {
+ status: "unexpected_status",
+ outcome_summary: "Finished but could not classify the task.",
+ },
+ },
+ });
+
+ expect(getAutomationRunTaskOutcome(run)).toEqual({
+ status: "unknown",
+ outcomeSummary: "Finished but could not classify the task.",
+ });
+ expect(getAutomationRunDisplay(run).customTaskMetadataText).toContain(
+ '"status": "unexpected_status"',
+ );
+ });
+
+ it("marks completed runs with arbitrary finish metadata as needs review", () => {
+ const display = getAutomationRunDisplay(
+ makeRun({
+ run_metadata: {
+ finish_tool_response: {
+ crm_contacts_checked: 12,
+ matches: ["Acme", "Globex"],
+ next_action: "Ask user to pick a contact.",
+ },
+ },
+ }),
+ );
+
+ expect(display.badgeStatus).toBe("unknown");
+ expect(display.summary).toBeNull();
+ expect(display.taskOutcome).toBeNull();
+ expect(display.customTaskMetadataText).toContain(
+ '"crm_contacts_checked": 12',
+ );
+ expect(display.customTaskMetadataText).toContain(
+ '"next_action": "Ask user to pick a contact."',
+ );
+ });
+
+ it("keeps default task summary while exposing additional custom metadata", () => {
+ const display = getAutomationRunDisplay(
+ makeRun({
+ run_metadata: {
+ finish_tool_response: {
+ status: "partial_success",
+ outcome_summary: "Posted 4 of 6 items.",
+ posted_count: 4,
+ skipped_sources: ["feed-a", "feed-b"],
+ },
+ },
+ }),
+ );
+
+ expect(display.badgeStatus).toBe("partial_success");
+ expect(display.summary).toBe("Posted 4 of 6 items.");
+ expect(display.customTaskMetadataText).toContain('"posted_count": 4');
+ expect(display.customTaskMetadataText).toContain('"feed-a"');
+ });
+});
diff --git a/src/components/features/automations/automation-card.tsx b/src/components/features/automations/automation-card.tsx
index 6195f8740d..3a1ff2ee75 100644
--- a/src/components/features/automations/automation-card.tsx
+++ b/src/components/features/automations/automation-card.tsx
@@ -3,7 +3,7 @@ import { useMemo } from "react";
import { useTranslation } from "react-i18next";
import { I18nKey } from "#/i18n/declaration";
import type { Automation } from "#/types/automation";
-import { AutomationRunStatus } from "#/types/automation";
+import { getAutomationRunDisplay } from "#/utils/automation-run-display";
import { KebabMenu } from "./kebab-menu";
import { useHasPermission } from "#/hooks/use-has-permission";
import { useNavigation } from "#/context/navigation-context";
@@ -30,8 +30,8 @@ import type { RunSummaryState } from "#/manifests/automation-insights";
import type { InterfaceListInsights } from "#/manifests/types";
import {
getLastRunTimestamp,
- shortenAutomationErrorDetail,
- shouldShowAutomationErrorHovercard,
+ shortenAutomationRunSummary,
+ shouldShowAutomationRunSummaryHovercard,
} from "#/components/features/home/featured-automations/automation-run-health";
/** Run insights shown when the manifest declares the dashboard surface. */
@@ -96,17 +96,13 @@ export function AutomationCard({
);
const { latestRun, recentRuns, isLoading, isError } = runState;
const timestamp = latestRun ? getLastRunTimestamp(latestRun) : null;
- const errorDetail =
- latestRun?.status === AutomationRunStatus.FAILED
- ? latestRun.error_detail?.trim() || null
- : null;
- const shortErrorDetail = errorDetail
- ? shortenAutomationErrorDetail(errorDetail)
- : null;
- const showErrorHovercard =
- errorDetail != null &&
- shortErrorDetail != null &&
- shouldShowAutomationErrorHovercard(errorDetail, shortErrorDetail);
+ const display = latestRun ? getAutomationRunDisplay(latestRun) : null;
+ const summary = display?.summary ?? null;
+ const shortSummary = summary ? shortenAutomationRunSummary(summary) : null;
+ const showSummaryHovercard =
+ summary != null &&
+ shortSummary != null &&
+ shouldShowAutomationRunSummaryHovercard(summary, shortSummary);
const showPhase = shouldShowRunPhase(latestRun?.status);
const disableAnimation = import.meta.env.MODE === "test";
@@ -214,7 +210,11 @@ export function AutomationCard({
{latestRun ? (
<>
- <RunStatusBadge status={latestRun.status} iconOnly showLabel />
+ <RunStatusBadge
+ status={display?.badgeStatus ?? latestRun.status}
+ iconOnly
+ showLabel
+ />
{showPhase ? (
<RunPhase
@@ -225,12 +225,12 @@ export function AutomationCard({
/>
) : null}
- {shortErrorDetail ? (
- showErrorHovercard && errorDetail ? (
+ {shortSummary ? (
+ showSummaryHovercard && summary ? (
<Tooltip
content={
<p className="max-w-xs whitespace-pre-wrap break-words p-2 text-xs">
- {errorDetail}
+ {summary}
</p>
}
placement="top"
@@ -238,13 +238,13 @@ export function AutomationCard({
disableAnimation={disableAnimation}
className="rounded-xl border border-[var(--oh-border)] bg-base-secondary p-0 text-white shadow-xl"
>
- <span className="min-w-0 flex-1 cursor-default truncate text-[var(--oh-status-error)]">
- {shortErrorDetail}
+ <span className="min-w-0 flex-1 cursor-default truncate text-[var(--oh-text-secondary)]">
+ {shortSummary}
</span>
</Tooltip>
) : (
- <p className="min-w-0 flex-1 truncate text-[var(--oh-status-error)]">
- {shortErrorDetail}
+ <p className="min-w-0 flex-1 truncate text-[var(--oh-text-secondary)]">
+ {shortSummary}
</p>
)
) : null}
diff --git a/src/components/features/automations/automation-list-row.tsx b/src/components/features/automations/automation-list-row.tsx
index 134086391f..a0fb8f6397 100644
--- a/src/components/features/automations/automation-list-row.tsx
+++ b/src/components/features/automations/automation-list-row.tsx
@@ -3,6 +3,7 @@ import { useTranslation } from "react-i18next";
import { Zap } from "lucide-react";
import { I18nKey } from "#/i18n/declaration";
import type { Automation } from "#/types/automation";
+import { getAutomationRunDisplay } from "#/utils/automation-run-display";
import { KebabMenu } from "./kebab-menu";
import { useHasPermission } from "#/hooks/use-has-permission";
import { useNavigation } from "#/context/navigation-context";
@@ -93,6 +94,7 @@ export function AutomationListRow({
insights?.state?.summary?.completedTotal ?? null,
);
const latestRun = runState.latestRun;
+ const display = latestRun ? getAutomationRunDisplay(latestRun) : null;
const lastRunAt = latestRun
? getLastRunTimestamp(latestRun)
: automation.last_triggered_at;
@@ -178,7 +180,10 @@ export function AutomationListRow({
·
</span>
) : null}
- <RunStatusBadge status={latestRun.status} compact />
+ <RunStatusBadge
+ status={display?.badgeStatus ?? latestRun.status}
+ compact
+ />
</>
) : null}
{impactStatement ? (
diff --git a/src/components/features/automations/detail/activity-log-item.tsx b/src/components/features/automations/detail/activity-log-item.tsx
index abc41a0911..1463b65f87 100644
--- a/src/components/features/automations/detail/activity-log-item.tsx
+++ b/src/components/features/automations/detail/activity-log-item.tsx
@@ -8,6 +8,7 @@ import {
type AutomationRun,
} from "#/types/automation";
import { isInvalidTimestamp } from "#/utils/format-relative-time";
+import { getAutomationRunDisplay } from "#/utils/automation-run-display";
import { RunStatusBadge } from "./run-status-badge";
import { RunPhase, shouldShowRunPhase } from "./run-phase";
import { RunLogsModal } from "./run-logs-modal";
@@ -59,7 +60,9 @@ export function ActivityLogItem({ run, automation }: ActivityLogItemProps) {
// state.
const isTerminal =
run.status === AutomationRunStatus.COMPLETED ||
- run.status === AutomationRunStatus.FAILED;
+ run.status === AutomationRunStatus.FAILED ||
+ run.status === AutomationRunStatus.CANCELLED ||
+ run.status === AutomationRunStatus.SKIPPED;
const showNoConversationLabel = !hasConversation && isTerminal;
const showPhase = shouldShowRunPhase(run.status);
const [logsOpen, setLogsOpen] = useState(false);
@@ -76,6 +79,7 @@ export function ActivityLogItem({ run, automation }: ActivityLogItemProps) {
i18n.language,
);
const formattedCost = formatRunCost(run.cost);
+ const display = getAutomationRunDisplay(run);
const handleLogsClick = (
e:
@@ -105,13 +109,18 @@ export function ActivityLogItem({ run, automation }: ActivityLogItemProps) {
const content = (
<>
- <div className="flex items-center gap-3">
- <span className="text-sm text-content">{formattedTimestamp}</span>
- {showNoConversationLabel && (
- <span className="text-xs text-muted">
- {t(I18nKey.AUTOMATIONS$DETAIL$NO_CONVERSATION)}
- </span>
- )}
+ <div className="min-w-0 flex-1">
+ <div className="flex items-center gap-3">
+ <span className="text-sm text-content">{formattedTimestamp}</span>
+ {showNoConversationLabel && (
+ <span className="text-xs text-muted">
+ {t(I18nKey.AUTOMATIONS$DETAIL$NO_CONVERSATION)}
+ </span>
+ )}
+ </div>
+ {display.summary ? (
+ <p className="mt-1 truncate text-xs text-muted">{display.summary}</p>
+ ) : null}
</div>
<div className="flex min-w-0 items-center gap-2">
{formattedCost && (
@@ -133,7 +142,7 @@ export function ActivityLogItem({ run, automation }: ActivityLogItemProps) {
wide
/>
)}
- <RunStatusBadge status={run.status} />
+ <RunStatusBadge status={display.badgeStatus} />
</div>
</>
);
@@ -144,7 +153,9 @@ export function ActivityLogItem({ run, automation }: ActivityLogItemProps) {
<a
href={getConversationUrl(run.conversation_id)}
className="flex items-center justify-between px-5 py-3 transition-colors cursor-pointer hover:bg-surface-raised focus:bg-surface-raised focus:outline-none"
- aria-label={`View conversation for run at ${formattedTimestamp}`}
+ aria-label={t(I18nKey.AUTOMATIONS$DETAIL$VIEW_CONVERSATION_FOR_RUN, {
+ timestamp: formattedTimestamp,
+ })}
>
{content}
</a>
diff --git a/src/components/features/automations/detail/run-logs-modal.tsx b/src/components/features/automations/detail/run-logs-modal.tsx
index edda217f9e..6cb3ca5cca 100644
--- a/src/components/features/automations/detail/run-logs-modal.tsx
+++ b/src/components/features/automations/detail/run-logs-modal.tsx
@@ -13,8 +13,11 @@ import {
AutomationRunStatus,
type Automation,
type AutomationRun,
+ type AutomationRunStatusDetail,
} from "#/types/automation";
+import { getAutomationRunDisplay } from "#/utils/automation-run-display";
import { DebugAutomationButton } from "./debug-automation-button";
+import { RunStatusBadge } from "./run-status-badge";
/**
* Localized empty-state message key for each `SandboxIssue` reason.
@@ -57,6 +60,132 @@ function concatStream(outputs: BashOutput[], key: "stdout" | "stderr"): string {
.join("");
}
+function stringifyDetailValue(value: unknown): string | null {
+ if (typeof value === "string") return value.trim() || null;
+ if (typeof value === "number" || typeof value === "boolean") {
+ return String(value);
+ }
+ return null;
+}
+
+function formatStatusDetail(
+ statusDetail: AutomationRunStatusDetail | null | undefined,
+): string | null {
+ if (!statusDetail) return null;
+ const primary =
+ stringifyDetailValue(statusDetail.formatted_detail) ??
+ stringifyDetailValue(statusDetail.detail);
+ const context = [
+ stringifyDetailValue(statusDetail.phase),
+ stringifyDetailValue(statusDetail.kind),
+ stringifyDetailValue(statusDetail.source),
+ stringifyDetailValue(statusDetail.operation),
+ stringifyDetailValue(statusDetail.code),
+ stringifyDetailValue(statusDetail.status_code),
+ ].filter(Boolean);
+
+ if (primary && context.length > 0) {
+ return `${primary} (${context.join(" · ")})`;
+ }
+ if (primary) return primary;
+ if (context.length > 0) return context.join(" · ");
+ return JSON.stringify(statusDetail);
+}
+
+function RunInspectionSummary({ run }: { run: AutomationRun | undefined }) {
+ const { t } = useTranslation("openhands");
+ if (!run) return null;
+
+ const display = getAutomationRunDisplay(run);
+ const taskSummary = display.taskOutcome?.outcomeSummary ?? null;
+ const taskMetadataText = display.customTaskMetadataText;
+ const taskStatus =
+ run.status === AutomationRunStatus.COMPLETED || display.taskOutcome
+ ? display.badgeStatus
+ : null;
+ const systemError = run.error_detail?.trim() || null;
+ const statusDetail = formatStatusDetail(run.status_detail);
+ const hasSystemDetails = systemError || statusDetail;
+
+ return (
+ <dl className="mt-4 grid gap-3 rounded-lg border border-[var(--oh-border)] bg-black/20 p-3 text-xs">
+ <div className="grid gap-1 sm:grid-cols-[5rem_minmax(0,1fr)] sm:items-center">
+ <dt className="text-muted">
+ {t(I18nKey.AUTOMATIONS$DETAIL$RUN_LABEL)}
+ </dt>
+ <dd>
+ <span className="inline-flex rounded-md bg-surface-raised px-2 py-0.5 font-mono text-[10px] font-medium text-muted">
+ {run.status}
+ </span>
+ </dd>
+ </div>
+ <div className="grid gap-1 sm:grid-cols-[5rem_minmax(0,1fr)] sm:items-start">
+ <dt className="pt-0.5 text-muted">
+ {t(I18nKey.AUTOMATIONS$DETAIL$TASK_LABEL)}
+ </dt>
+ <dd className="min-w-0 space-y-2">
+ {taskStatus ? <RunStatusBadge status={taskStatus} compact /> : null}
+ {taskSummary ? (
+ <p className="break-words text-content">{taskSummary}</p>
+ ) : taskMetadataText ? (
+ <p className="text-muted">
+ {t(I18nKey.AUTOMATIONS$DETAIL$CUSTOM_TASK_METADATA)}
+ </p>
+ ) : (
+ <p className="text-muted">
+ {t(I18nKey.AUTOMATIONS$DETAIL$NO_TASK_OUTCOME)}
+ </p>
+ )}
+ {taskMetadataText ? (
+ <div className="min-w-0 space-y-1">
+ <p className="text-muted">
+ {t(I18nKey.AUTOMATIONS$DETAIL$TASK_METADATA)}
+ </p>
+ <pre
+ data-testid="automation-task-metadata"
+ className="max-h-48 overflow-auto whitespace-pre-wrap break-words rounded-md border border-[var(--oh-border)] bg-black/30 p-2 font-mono text-[11px] leading-4 text-content"
+ >
+ {taskMetadataText}
+ </pre>
+ </div>
+ ) : null}
+ </dd>
+ </div>
+ <div className="grid gap-1 sm:grid-cols-[5rem_minmax(0,1fr)] sm:items-start">
+ <dt className="pt-0.5 text-muted">
+ {t(I18nKey.AUTOMATIONS$DETAIL$SYSTEM_LABEL)}
+ </dt>
+ <dd className="min-w-0 space-y-1 break-words text-content">
+ {hasSystemDetails ? (
+ <>
+ {systemError ? (
+ <p>
+ <span className="text-muted">
+ {t(I18nKey.COMMON$ERROR)}:{" "}
+ </span>
+ {systemError}
+ </p>
+ ) : null}
+ {statusDetail ? (
+ <p>
+ <span className="text-muted">
+ {t(I18nKey.AUTOMATIONS$DETAIL$STATUS_DETAIL)}:{" "}
+ </span>
+ {statusDetail}
+ </p>
+ ) : null}
+ </>
+ ) : (
+ <p className="text-muted">
+ {t(I18nKey.AUTOMATIONS$DETAIL$NO_SYSTEM_ISSUES)}
+ </p>
+ )}
+ </dd>
+ </div>
+ </dl>
+ );
+}
+
export function RunLogsModal({
conversationId,
bashCommandId,
@@ -144,6 +273,8 @@ export function RunLogsModal({
{t(I18nKey.AUTOMATIONS$DETAIL$LOGS_TITLE)}
</h2>
+ <RunInspectionSummary run={run} />
+
<div
role="tablist"
aria-label={t(I18nKey.AUTOMATIONS$DETAIL$LOGS_TITLE)}
diff --git a/src/components/features/automations/detail/run-status-badge.tsx b/src/components/features/automations/detail/run-status-badge.tsx
index 3a5326e6dc..688f25e2e8 100644
--- a/src/components/features/automations/detail/run-status-badge.tsx
+++ b/src/components/features/automations/detail/run-status-badge.tsx
@@ -1,15 +1,18 @@
-import { Loader2 } from "lucide-react";
+import { CircleAlert, CircleHelp, Loader2 } from "lucide-react";
import { useTranslation } from "react-i18next";
import { StyledTooltip } from "#/components/shared/buttons/styled-tooltip";
-import { I18nKey } from "#/i18n/declaration";
import CheckCircleIcon from "#/icons/check-circle.svg?react";
import XCircleIcon from "#/icons/x-circle.svg?react";
import ClockIcon from "#/icons/clock.svg?react";
import { AutomationRunStatus } from "#/types/automation";
+import {
+ getAutomationRunBadgeLabelKey,
+ type AutomationRunBadgeStatus,
+} from "#/utils/automation-run-display";
import { cn } from "#/utils/utils";
interface RunStatusBadgeProps {
- status: AutomationRunStatus;
+ status: AutomationRunBadgeStatus;
/**
* Icon-only mark (no pill). Status text is available via hover tooltip and
* `aria-label`, unless {@link showLabel} is also set.
@@ -21,37 +24,48 @@ interface RunStatusBadgeProps {
compact?: boolean;
}
-const statusConfig: Record<
- AutomationRunStatus,
- { label: I18nKey; style: string; iconTone: string }
-> = {
+const statusConfig: Record<string, { style: string; iconTone: string }> = {
[AutomationRunStatus.COMPLETED]: {
- label: I18nKey.AUTOMATIONS$DETAIL$SUCCESSFUL,
+ style: "bg-[var(--oh-success)]/10 text-[var(--oh-success)]",
+ iconTone: "text-[var(--oh-success)]",
+ },
+ success: {
style: "bg-[var(--oh-success)]/10 text-[var(--oh-success)]",
iconTone: "text-[var(--oh-success)]",
},
[AutomationRunStatus.FAILED]: {
- label: I18nKey.AUTOMATIONS$DETAIL$FAILED,
style: "bg-[var(--oh-danger)]/10 text-danger",
iconTone: "text-danger",
},
+ failed: {
+ style: "bg-[var(--oh-danger)]/10 text-danger",
+ iconTone: "text-danger",
+ },
+ blocked: {
+ style: "bg-[var(--oh-warning)]/10 text-[var(--oh-warning)]",
+ iconTone: "text-[var(--oh-warning)]",
+ },
+ partial_success: {
+ style: "bg-[var(--oh-warning)]/10 text-[var(--oh-warning)]",
+ iconTone: "text-[var(--oh-warning)]",
+ },
+ unknown: {
+ style: "bg-[var(--oh-warning)]/10 text-[var(--oh-warning)]",
+ iconTone: "text-[var(--oh-warning)]",
+ },
[AutomationRunStatus.PENDING]: {
- label: I18nKey.AUTOMATIONS$DETAIL$PENDING,
style: "bg-surface-raised text-muted",
iconTone: "text-muted",
},
[AutomationRunStatus.RUNNING]: {
- label: I18nKey.AUTOMATIONS$DETAIL$RUNNING,
style: "bg-surface-raised text-muted",
iconTone: "text-muted",
},
[AutomationRunStatus.CANCELLED]: {
- label: I18nKey.AUTOMATIONS$DETAIL$CANCELLED,
style: "bg-surface-raised text-muted",
iconTone: "text-muted",
},
[AutomationRunStatus.SKIPPED]: {
- label: I18nKey.AUTOMATIONS$DETAIL$SKIPPED,
style: "bg-surface-raised text-muted",
iconTone: "text-muted",
},
@@ -61,12 +75,13 @@ function StatusIcon({
status,
compact = false,
}: {
- status: AutomationRunStatus;
+ status: AutomationRunBadgeStatus;
compact?: boolean;
}) {
const iconClass = compact ? "size-3" : "size-3.5";
switch (status) {
case AutomationRunStatus.COMPLETED:
+ case "success":
return (
<CheckCircleIcon
data-testid="run-status-icon-completed"
@@ -74,6 +89,7 @@ function StatusIcon({
/>
);
case AutomationRunStatus.FAILED:
+ case "failed":
return (
<XCircleIcon
data-testid="run-status-icon-failed"
@@ -88,6 +104,23 @@ function StatusIcon({
aria-hidden="true"
/>
);
+ case "blocked":
+ case "partial_success":
+ return (
+ <CircleAlert
+ data-testid="run-status-icon-warning"
+ className={iconClass}
+ aria-hidden="true"
+ />
+ );
+ case "unknown":
+ return (
+ <CircleHelp
+ data-testid="run-status-icon-needs-review"
+ className={iconClass}
+ aria-hidden="true"
+ />
+ );
default:
return (
<ClockIcon
@@ -108,7 +141,7 @@ export function RunStatusBadge({
// Degrade instead of crashing on a status the backend added after this enum.
const config =
statusConfig[status] ?? statusConfig[AutomationRunStatus.PENDING];
- const label = t(config.label);
+ const label = t(getAutomationRunBadgeLabelKey(status));
if (iconOnly) {
if (showLabel) {
diff --git a/src/components/features/home/featured-automations/automation-health-indicator.tsx b/src/components/features/home/featured-automations/automation-health-indicator.tsx
index 07781b3953..24411b040a 100644
--- a/src/components/features/home/featured-automations/automation-health-indicator.tsx
+++ b/src/components/features/home/featured-automations/automation-health-indicator.tsx
@@ -35,6 +35,7 @@ export function AutomationHealthIndicator({
className={cn(
"h-1.5 w-1.5 shrink-0 rounded-full",
health === "failed" && "bg-[var(--oh-status-error)]",
+ health === "warning" && "bg-[var(--oh-warning)]",
health === "in_progress" &&
"animate-pulse bg-[var(--oh-status-success)] motion-reduce:animate-none",
(health === "none" || health === "unknown") && "bg-[var(--oh-border)]",
diff --git a/src/components/features/home/featured-automations/automation-run-activity-metrics.ts b/src/components/features/home/featured-automations/automation-run-activity-metrics.ts
index 996ff005f2..bf4d9673dd 100644
--- a/src/components/features/home/featured-automations/automation-run-activity-metrics.ts
+++ b/src/components/features/home/featured-automations/automation-run-activity-metrics.ts
@@ -1,5 +1,9 @@
import { I18nKey } from "#/i18n/declaration";
import { AutomationRunStatus, type AutomationRun } from "#/types/automation";
+import {
+ getAutomationRunBadgeLabelKey,
+ type AutomationRunBadgeStatus,
+} from "#/utils/automation-run-display";
/** Sparkline track height; bars sit on the baseline inside this. */
export const AUTOMATION_RUN_ACTIVITY_TRACK_PX = 18;
@@ -64,13 +68,19 @@ export function durationMsToSparklineBarHeightPx(
}
export function barColorClassForStatus(
- status: AutomationRunStatus | string,
+ status: AutomationRunBadgeStatus | string,
): string {
switch (status) {
case AutomationRunStatus.COMPLETED:
+ case "success":
return "bg-[var(--oh-status-success)]";
case AutomationRunStatus.FAILED:
+ case "failed":
return "bg-[var(--oh-status-error)]";
+ case "blocked":
+ case "partial_success":
+ case "unknown":
+ return "bg-[var(--oh-warning)]";
case AutomationRunStatus.RUNNING:
return "bg-[var(--oh-status-success)] animate-pulse motion-reduce:animate-none";
case AutomationRunStatus.PENDING:
@@ -84,24 +94,9 @@ export function barColorClassForStatus(
}
export function getAutomationRunStatusLabelKey(
- status: AutomationRunStatus | string,
+ status: AutomationRunBadgeStatus | string,
): I18nKey {
- switch (status) {
- case AutomationRunStatus.COMPLETED:
- return I18nKey.AUTOMATIONS$DETAIL$SUCCESSFUL;
- case AutomationRunStatus.FAILED:
- return I18nKey.AUTOMATIONS$DETAIL$FAILED;
- case AutomationRunStatus.PENDING:
- return I18nKey.AUTOMATIONS$DETAIL$PENDING;
- case AutomationRunStatus.RUNNING:
- return I18nKey.AUTOMATIONS$DETAIL$RUNNING;
- case AutomationRunStatus.CANCELLED:
- return I18nKey.AUTOMATIONS$DETAIL$CANCELLED;
- case AutomationRunStatus.SKIPPED:
- return I18nKey.AUTOMATIONS$DETAIL$SKIPPED;
- default:
- return I18nKey.FEATURED_AUTOMATIONS$STATUS_UNKNOWN;
- }
+ return getAutomationRunBadgeLabelKey(status);
}
export function formatDurationForTitle(
diff --git a/src/components/features/home/featured-automations/automation-run-activity-sparkline.tsx b/src/components/features/home/featured-automations/automation-run-activity-sparkline.tsx
index 2b3aadbbd4..0a554549ae 100644
--- a/src/components/features/home/featured-automations/automation-run-activity-sparkline.tsx
+++ b/src/components/features/home/featured-automations/automation-run-activity-sparkline.tsx
@@ -5,7 +5,8 @@ import { NavigationLink } from "#/components/shared/navigation-link";
import { AUTOMATION_RUN_ACTIVITY_LIMIT } from "#/hooks/query/use-latest-automation-runs";
import { isInFlightAutomationRun } from "#/hooks/use-home-automation-actions";
import { I18nKey } from "#/i18n/declaration";
-import { AutomationRunStatus, type AutomationRun } from "#/types/automation";
+import type { AutomationRun } from "#/types/automation";
+import { getAutomationRunDisplay } from "#/utils/automation-run-display";
import { formatRelativeTime } from "#/utils/format-relative-time";
import { cn } from "#/utils/utils";
import { getLastRunTimestamp } from "./automation-run-health";
@@ -54,11 +55,8 @@ function RunActivityBarTooltip({
: null;
const durationMs = getAutomationRunDurationMs(run, nowMs);
const durationLabel = formatDurationForTitle(durationMs);
- const statusLabel = t(getAutomationRunStatusLabelKey(run.status));
- const errorDetail =
- run.status === AutomationRunStatus.FAILED
- ? run.error_detail?.trim() || null
- : null;
+ const display = getAutomationRunDisplay(run);
+ const statusLabel = t(getAutomationRunStatusLabelKey(display.badgeStatus));
return (
<div className="flex w-[220px] flex-col gap-2 p-3">
@@ -67,7 +65,7 @@ function RunActivityBarTooltip({
aria-hidden="true"
className={cn(
"h-3 w-1.5 shrink-0 rounded-[1px]",
- barColorClassForStatus(run.status),
+ barColorClassForStatus(display.badgeStatus),
)}
/>
<span className="text-sm font-medium text-white">{statusLabel}</span>
@@ -86,9 +84,9 @@ function RunActivityBarTooltip({
) : null}
</div>
- {errorDetail ? (
- <p className="line-clamp-3 text-xs text-[var(--oh-status-error)]">
- {errorDetail}
+ {display.summary ? (
+ <p className="line-clamp-3 text-xs text-[var(--oh-text-secondary)]">
+ {display.summary}
</p>
) : null}
</div>
@@ -106,7 +104,8 @@ function RunActivityBar({
}) {
const { t } = useTranslation("openhands");
const durationMs = getAutomationRunDurationMs(run, nowMs);
- const statusLabel = t(getAutomationRunStatusLabelKey(run.status));
+ const display = getAutomationRunDisplay(run);
+ const statusLabel = t(getAutomationRunStatusLabelKey(display.badgeStatus));
const disableAnimation = import.meta.env.MODE === "test";
const href = `/automations/${encodeURIComponent(automationId)}?run=${encodeURIComponent(run.id)}`;
@@ -134,7 +133,7 @@ function RunActivityBar({
// Grow the hovered/focused bar so it reads clearly among neighbors.
"group-hover/spark-bar:scale-x-[1.4] group-hover/spark-bar:scale-y-[1.15]",
"group-focus-visible/spark-bar:scale-x-[1.4] group-focus-visible/spark-bar:scale-y-[1.15]",
- barColorClassForStatus(run.status),
+ barColorClassForStatus(display.badgeStatus),
)}
style={{ height: durationMsToSparklineBarHeightPx(durationMs) }}
/>
diff --git a/src/components/features/home/featured-automations/automation-run-health.ts b/src/components/features/home/featured-automations/automation-run-health.ts
index 01751a63af..15b6abbd0b 100644
--- a/src/components/features/home/featured-automations/automation-run-health.ts
+++ b/src/components/features/home/featured-automations/automation-run-health.ts
@@ -5,11 +5,13 @@ import {
type Automation,
type AutomationRun,
} from "#/types/automation";
+import { getAutomationRunDisplay } from "#/utils/automation-run-display";
import { formatEventOn } from "#/utils/automation-schedule";
export type AutomationRunHealth =
| "success"
| "failed"
+ | "warning"
| "in_progress"
| "none"
| "unknown";
@@ -19,15 +21,21 @@ export function deriveRunHealth(
): AutomationRunHealth {
if (state.isLoading || state.isError) return "unknown";
if (!state.latestRun) return "none";
- switch (state.latestRun.status) {
+ const display = getAutomationRunDisplay(state.latestRun);
+ switch (display.badgeStatus) {
case AutomationRunStatus.COMPLETED:
+ case "success":
return "success";
case AutomationRunStatus.FAILED:
+ case "failed":
return "failed";
+ case "blocked":
+ case "partial_success":
+ case "unknown":
+ return "warning";
case AutomationRunStatus.PENDING:
case AutomationRunStatus.RUNNING:
return "in_progress";
- // CANCELLED, SKIPPED, and any status the backend adds after this enum.
default:
return "unknown";
}
@@ -39,6 +47,8 @@ export function getRunHealthLabelKey(health: AutomationRunHealth): I18nKey {
return I18nKey.FEATURED_AUTOMATIONS$LAST_RUN_SUCCEEDED;
case "failed":
return I18nKey.FEATURED_AUTOMATIONS$LAST_RUN_FAILED;
+ case "warning":
+ return I18nKey.AUTOMATIONS$DETAIL$NEEDS_REVIEW;
case "in_progress":
return I18nKey.FEATURED_AUTOMATIONS$RUN_IN_PROGRESS;
case "none":
@@ -105,8 +115,8 @@ const ERROR_DETAIL_INLINE_MAX = 48;
* Short preview for the pinned-card status row. Prefer the first sentence,
* then hard-truncate so the row stays single-line.
*/
-export function shortenAutomationErrorDetail(detail: string): string {
- const trimmed = detail.trim().replace(/\s+/g, " ");
+export function shortenAutomationRunSummary(summary: string): string {
+ const trimmed = summary.trim().replace(/\s+/g, " ");
if (!trimmed) return trimmed;
const firstSentence = trimmed.match(/^.*?[.!?](?=\s|$)/)?.[0] ?? trimmed;
if (firstSentence.length <= ERROR_DETAIL_INLINE_MAX) return firstSentence;
@@ -114,13 +124,17 @@ export function shortenAutomationErrorDetail(detail: string): string {
}
/** True when the inline preview is shortened and the full message belongs in a hovercard. */
-export function shouldShowAutomationErrorHovercard(
- detail: string,
- shortDetail: string = shortenAutomationErrorDetail(detail),
+export function shouldShowAutomationRunSummaryHovercard(
+ summary: string,
+ shortSummary: string = shortenAutomationRunSummary(summary),
): boolean {
- return detail.trim().replace(/\s+/g, " ") !== shortDetail;
+ return summary.trim().replace(/\s+/g, " ") !== shortSummary;
}
+export const shortenAutomationErrorDetail = shortenAutomationRunSummary;
+export const shouldShowAutomationErrorHovercard =
+ shouldShowAutomationRunSummaryHovercard;
+
/**
* Timestamp to show as the run's "last run" moment, or null when the run
* has no usable timestamp yet. The backend leaves started_at unset
diff --git a/src/components/features/home/featured-automations/home-automation-activity.ts b/src/components/features/home/featured-automations/home-automation-activity.ts
index 26f1cf41b7..f2ac91ee00 100644
--- a/src/components/features/home/featured-automations/home-automation-activity.ts
+++ b/src/components/features/home/featured-automations/home-automation-activity.ts
@@ -1,6 +1,10 @@
import type { LatestAutomationRunState } from "#/hooks/query/use-latest-automation-runs";
import { I18nKey } from "#/i18n/declaration";
import { AutomationRunStatus, type Automation } from "#/types/automation";
+import {
+ getAutomationRunDisplay,
+ type AutomationRunBadgeStatus,
+} from "#/utils/automation-run-display";
import { formatRelativeTime } from "#/utils/format-relative-time";
import {
getLastRunTimestamp,
@@ -13,7 +17,7 @@ export interface HomeAutomationActivityItem {
name: string;
triggerSummary: string;
/** Null when the automation has never run (or the run fetch failed). */
- status: AutomationRunStatus | null;
+ status: AutomationRunBadgeStatus | null;
/** Relative time label, or null when there is no usable timestamp. */
whenLabel: string | null;
conversationId: string | null;
@@ -29,12 +33,13 @@ export function buildHomeAutomationActivityItem(
): HomeAutomationActivityItem {
const { latestRun } = runState;
const timestamp = latestRun ? getLastRunTimestamp(latestRun) : null;
+ const display = latestRun ? getAutomationRunDisplay(latestRun) : null;
return {
id: automation.id,
name: automation.name,
triggerSummary: getTriggerSummary(automation),
- status: latestRun?.status ?? null,
+ status: display?.badgeStatus ?? null,
whenLabel: timestamp ? formatRelativeTime(timestamp, locale, t) : null,
conversationId: latestRun?.conversation_id ?? null,
};
diff --git a/src/components/features/home/featured-automations/home-automation-run-tooltip.tsx b/src/components/features/home/featured-automations/home-automation-run-tooltip.tsx
index d66ef45553..0a6e8c2dd2 100644
--- a/src/components/features/home/featured-automations/home-automation-run-tooltip.tsx
+++ b/src/components/features/home/featured-automations/home-automation-run-tooltip.tsx
@@ -8,11 +8,11 @@ import {
shouldShowRunPhase,
useRunPhase,
} from "#/components/features/automations/detail/run-phase";
+import type { Automation, AutomationRun } from "#/types/automation";
import {
- AutomationRunStatus,
- type Automation,
- type AutomationRun,
-} from "#/types/automation";
+ getAutomationRunBadgeLabelKey,
+ getAutomationRunDisplay,
+} from "#/utils/automation-run-display";
import { formatRelativeTime } from "#/utils/format-relative-time";
import { AutomationHealthIndicator } from "./automation-health-indicator";
import {
@@ -26,6 +26,11 @@ export function getRunStatusLabelKey(
runState: LatestAutomationRunState,
): I18nKey {
if (runState.isError) return I18nKey.FEATURED_AUTOMATIONS$STATUS_UNAVAILABLE;
+ if (runState.latestRun) {
+ return getAutomationRunBadgeLabelKey(
+ getAutomationRunDisplay(runState.latestRun).badgeStatus,
+ );
+ }
return getRunHealthLabelKey(deriveRunHealth(runState));
}
@@ -93,6 +98,7 @@ export function HomeAutomationRunTooltip({
const timestamp = latestRun ? getLastRunTimestamp(latestRun) : null;
const TriggerIcon = automation.trigger.type === "event" ? Zap : ClockIcon;
const health = deriveRunHealth(runState);
+ const display = latestRun ? getAutomationRunDisplay(latestRun) : null;
return (
<div className="flex w-[280px] flex-col gap-3 p-3">
@@ -126,11 +132,10 @@ export function HomeAutomationRunTooltip({
</PreviewRow>
) : null}
- {latestRun?.status === AutomationRunStatus.FAILED &&
- latestRun.error_detail ? (
- <PreviewRow label={t(I18nKey.STATUS$ERROR)}>
- <span className="line-clamp-3 text-[var(--oh-status-error)]">
- {latestRun.error_detail}
+ {display?.summary ? (
+ <PreviewRow label={t(I18nKey.AUTOMATIONS$DETAIL$TASK_LABEL)}>
+ <span className="line-clamp-3 text-[var(--oh-text-secondary)]">
+ {display.summary}
</span>
</PreviewRow>
) : null}
diff --git a/src/components/features/home/featured-automations/pinned-automation-card.tsx b/src/components/features/home/featured-automations/pinned-automation-card.tsx
index 992068e840..fc6f14a06c 100644
--- a/src/components/features/home/featured-automations/pinned-automation-card.tsx
+++ b/src/components/features/home/featured-automations/pinned-automation-card.tsx
@@ -21,6 +21,7 @@ import { getDemoConversationTitle } from "#/fixtures/home-automations-demo";
import { useUserConversation } from "#/hooks/query/use-user-conversation";
import { I18nKey } from "#/i18n/declaration";
import { AutomationRunStatus, type Automation } from "#/types/automation";
+import { getAutomationRunDisplay } from "#/utils/automation-run-display";
import { formatRelativeTime } from "#/utils/format-relative-time";
import { cn } from "#/utils/utils";
import { automationCardStatusStripClassName } from "#/components/features/automations/automation-view-mode";
@@ -33,8 +34,8 @@ import { buildPinnedAutomationMenuItems } from "./build-pinned-automation-menu-i
import { HomeAutomationMenu } from "./home-automation-menu";
import {
getLastRunTimestamp,
- shortenAutomationErrorDetail,
- shouldShowAutomationErrorHovercard,
+ shortenAutomationRunSummary,
+ shouldShowAutomationRunSummaryHovercard,
} from "./automation-run-health";
interface PinnedAutomationCardProps {
@@ -93,17 +94,13 @@ export function PinnedAutomationCard({
[automation, scheduleLabel],
);
const showPhase = shouldShowRunPhase(latestRun?.status);
- const errorDetail =
- latestRun?.status === AutomationRunStatus.FAILED
- ? latestRun.error_detail?.trim() || null
- : null;
- const shortErrorDetail = errorDetail
- ? shortenAutomationErrorDetail(errorDetail)
- : null;
- const showErrorHovercard =
- errorDetail != null &&
- shortErrorDetail != null &&
- shouldShowAutomationErrorHovercard(errorDetail, shortErrorDetail);
+ const display = latestRun ? getAutomationRunDisplay(latestRun) : null;
+ const summary = display?.summary ?? null;
+ const shortSummary = summary ? shortenAutomationRunSummary(summary) : null;
+ const showSummaryHovercard =
+ summary != null &&
+ shortSummary != null &&
+ shouldShowAutomationRunSummaryHovercard(summary, shortSummary);
const disableAnimation = import.meta.env.MODE === "test";
const cardRef = useRef<HTMLElement>(null);
const insights = getDashboardSpec()?.insights;
@@ -279,7 +276,7 @@ export function PinnedAutomationCard({
{latestRun ? (
<>
<RunStatusBadge
- status={latestRun.status}
+ status={display?.badgeStatus ?? latestRun.status}
iconOnly
showLabel={
latestRun.status === AutomationRunStatus.PENDING ||
@@ -298,12 +295,12 @@ export function PinnedAutomationCard({
/>
) : null}
- {shortErrorDetail ? (
- showErrorHovercard && errorDetail ? (
+ {shortSummary ? (
+ showSummaryHovercard && summary ? (
<Tooltip
content={
<p className="max-w-xs whitespace-pre-wrap break-words p-2 text-xs">
- {errorDetail}
+ {summary}
</p>
}
placement="top"
@@ -311,13 +308,13 @@ export function PinnedAutomationCard({
disableAnimation={disableAnimation}
className="rounded-xl border border-[var(--oh-border)] bg-base-secondary p-0 text-white shadow-xl"
>
- <span className="min-w-0 flex-1 cursor-default truncate text-[var(--oh-status-error)]">
- {shortErrorDetail}
+ <span className="min-w-0 flex-1 cursor-default truncate text-[var(--oh-text-secondary)]">
+ {shortSummary}
</span>
</Tooltip>
) : (
- <p className="min-w-0 flex-1 truncate text-[var(--oh-status-error)]">
- {shortErrorDetail}
+ <p className="min-w-0 flex-1 truncate text-[var(--oh-text-secondary)]">
+ {shortSummary}
</p>
)
) : null}
diff --git a/src/i18n/translation.json b/src/i18n/translation.json
index 789bc1dedf..d1676d504c 100644
--- a/src/i18n/translation.json
+++ b/src/i18n/translation.json
@@ -13905,6 +13905,212 @@
"uk": "Пропущено",
"ca": "Omès"
},
+ "AUTOMATIONS$DETAIL$BLOCKED": {
+ "en": "Blocked",
+ "ja": "ブロック中",
+ "zh-CN": "受阻",
+ "zh-TW": "受阻",
+ "ko-KR": "차단됨",
+ "no": "Blokkert",
+ "it": "Bloccato",
+ "pt": "Bloqueado",
+ "es": "Bloqueado",
+ "ar": "محظور",
+ "fr": "Bloqué",
+ "tr": "Engellendi",
+ "de": "Blockiert",
+ "uk": "Заблоковано",
+ "ca": "Bloquejat"
+ },
+ "AUTOMATIONS$DETAIL$PARTIAL": {
+ "en": "Partial",
+ "ja": "部分的",
+ "zh-CN": "部分完成",
+ "zh-TW": "部分完成",
+ "ko-KR": "부분 완료",
+ "no": "Delvis",
+ "it": "Parziale",
+ "pt": "Parcial",
+ "es": "Parcial",
+ "ar": "جزئي",
+ "fr": "Partiel",
+ "tr": "Kısmi",
+ "de": "Teilweise",
+ "uk": "Частково",
+ "ca": "Parcial"
+ },
+ "AUTOMATIONS$DETAIL$NEEDS_REVIEW": {
+ "en": "Needs review",
+ "ja": "レビューが必要",
+ "zh-CN": "需要审核",
+ "zh-TW": "需要審查",
+ "ko-KR": "검토 필요",
+ "no": "Trenger gjennomgang",
+ "it": "Richiede revisione",
+ "pt": "Precisa de revisão",
+ "es": "Necesita revisión",
+ "ar": "يحتاج إلى مراجعة",
+ "fr": "À vérifier",
+ "tr": "İnceleme gerekiyor",
+ "de": "Prüfung erforderlich",
+ "uk": "Потребує перевірки",
+ "ca": "Cal revisar"
+ },
+ "AUTOMATIONS$DETAIL$RUN_LABEL": {
+ "en": "Run",
+ "ja": "実行",
+ "zh-CN": "运行",
+ "zh-TW": "執行",
+ "ko-KR": "실행",
+ "no": "Kjøring",
+ "it": "Esecuzione",
+ "pt": "Execução",
+ "es": "Ejecución",
+ "ar": "التشغيل",
+ "fr": "Exécution",
+ "tr": "Çalıştırma",
+ "de": "Ausführung",
+ "uk": "Запуск",
+ "ca": "Execució"
+ },
+ "AUTOMATIONS$DETAIL$TASK_LABEL": {
+ "en": "Task",
+ "ja": "タスク",
+ "zh-CN": "任务",
+ "zh-TW": "任務",
+ "ko-KR": "작업",
+ "no": "Oppgave",
+ "it": "Attività",
+ "pt": "Tarefa",
+ "es": "Tarea",
+ "ar": "المهمة",
+ "fr": "Tâche",
+ "tr": "Görev",
+ "de": "Aufgabe",
+ "uk": "Завдання",
+ "ca": "Tasca"
+ },
+ "AUTOMATIONS$DETAIL$SYSTEM_LABEL": {
+ "en": "System",
+ "ja": "システム",
+ "zh-CN": "系统",
+ "zh-TW": "系統",
+ "ko-KR": "시스템",
+ "no": "System",
+ "it": "Sistema",
+ "pt": "Sistema",
+ "es": "Sistema",
+ "ar": "النظام",
+ "fr": "Système",
+ "tr": "Sistem",
+ "de": "System",
+ "uk": "Система",
+ "ca": "Sistema"
+ },
+ "AUTOMATIONS$DETAIL$NO_TASK_OUTCOME": {
+ "en": "No task outcome reported.",
+ "ja": "タスク結果は報告されていません。",
+ "zh-CN": "未报告任务结果。",
+ "zh-TW": "未回報任務結果。",
+ "ko-KR": "보고된 작업 결과가 없습니다.",
+ "no": "Ingen oppgaveutfall rapportert.",
+ "it": "Nessun risultato dell'attività segnalato.",
+ "pt": "Nenhum resultado da tarefa relatado.",
+ "es": "No se informó ningún resultado de la tarea.",
+ "ar": "لم يتم الإبلاغ عن نتيجة المهمة.",
+ "fr": "Aucun résultat de tâche signalé.",
+ "tr": "Görev sonucu bildirilmedi.",
+ "de": "Kein Aufgabenergebnis gemeldet.",
+ "uk": "Результат завдання не повідомлено.",
+ "ca": "No s'ha informat de cap resultat de la tasca."
+ },
+ "AUTOMATIONS$DETAIL$NO_SYSTEM_ISSUES": {
+ "en": "No system issues reported.",
+ "ja": "システムの問題は報告されていません。",
+ "zh-CN": "未报告系统问题。",
+ "zh-TW": "未回報系統問題。",
+ "ko-KR": "보고된 시스템 문제가 없습니다.",
+ "no": "Ingen systemproblemer rapportert.",
+ "it": "Nessun problema di sistema segnalato.",
+ "pt": "Nenhum problema do sistema relatado.",
+ "es": "No se informó ningún problema del sistema.",
+ "ar": "لم يتم الإبلاغ عن مشكلات في النظام.",
+ "fr": "Aucun problème système signalé.",
+ "tr": "Sistem sorunu bildirilmedi.",
+ "de": "Keine Systemprobleme gemeldet.",
+ "uk": "Системних проблем не повідомлено.",
+ "ca": "No s'ha informat de cap problema del sistema."
+ },
+ "AUTOMATIONS$DETAIL$STATUS_DETAIL": {
+ "en": "Status detail",
+ "ja": "ステータス詳細",
+ "zh-CN": "状态详情",
+ "zh-TW": "狀態詳細資訊",
+ "ko-KR": "상태 세부 정보",
+ "no": "Statusdetalj",
+ "it": "Dettaglio stato",
+ "pt": "Detalhe do status",
+ "es": "Detalle del estado",
+ "ar": "تفاصيل الحالة",
+ "fr": "Détail du statut",
+ "tr": "Durum ayrıntısı",
+ "de": "Statusdetail",
+ "uk": "Деталі статусу",
+ "ca": "Detall de l'estat"
+ },
+ "AUTOMATIONS$DETAIL$TASK_METADATA": {
+ "en": "Task metadata",
+ "ja": "タスクメタデータ",
+ "zh-CN": "任务元数据",
+ "zh-TW": "任務中繼資料",
+ "ko-KR": "작업 메타데이터",
+ "no": "Oppgavemetadata",
+ "it": "Metadati attività",
+ "pt": "Metadados da tarefa",
+ "es": "Metadatos de la tarea",
+ "ar": "بيانات تعريف المهمة",
+ "fr": "Métadonnées de la tâche",
+ "tr": "Görev meta verileri",
+ "de": "Aufgabenmetadaten",
+ "uk": "Метадані завдання",
+ "ca": "Metadades de la tasca"
+ },
+ "AUTOMATIONS$DETAIL$CUSTOM_TASK_METADATA": {
+ "en": "Custom task metadata was reported.",
+ "ja": "カスタムタスクメタデータが報告されました。",
+ "zh-CN": "已报告自定义任务元数据。",
+ "zh-TW": "已回報自訂任務中繼資料。",
+ "ko-KR": "사용자 지정 작업 메타데이터가 보고되었습니다.",
+ "no": "Egendefinert oppgavemetadata ble rapportert.",
+ "it": "Sono stati segnalati metadati attività personalizzati.",
+ "pt": "Metadados personalizados da tarefa foram relatados.",
+ "es": "Se informaron metadatos personalizados de la tarea.",
+ "ar": "تم الإبلاغ عن بيانات تعريف مخصصة للمهمة.",
+ "fr": "Des métadonnées de tâche personnalisées ont été signalées.",
+ "tr": "Özel görev meta verileri bildirildi.",
+ "de": "Benutzerdefinierte Aufgabenmetadaten wurden gemeldet.",
+ "uk": "Повідомлено користувацькі метадані завдання.",
+ "ca": "S'han informat metadades personalitzades de la tasca."
+ },
+
+ "AUTOMATIONS$DETAIL$VIEW_CONVERSATION_FOR_RUN": {
+ "en": "View conversation for run at {{timestamp}}",
+ "ja": "{{timestamp}} の実行の会話を表示",
+ "zh-CN": "查看 {{timestamp}} 运行的对话",
+ "zh-TW": "查看 {{timestamp}} 執行的對話",
+ "ko-KR": "{{timestamp}} 실행의 대화 보기",
+ "no": "Vis samtale for kjøring {{timestamp}}",
+ "it": "Visualizza la conversazione per l'esecuzione alle {{timestamp}}",
+ "pt": "Ver conversa da execução em {{timestamp}}",
+ "es": "Ver conversación de la ejecución en {{timestamp}}",
+ "ar": "عرض محادثة التشغيل في {{timestamp}}",
+ "fr": "Afficher la conversation de l'exécution à {{timestamp}}",
+ "tr": "{{timestamp}} çalıştırmasının konuşmasını görüntüle",
+ "de": "Konversation für Ausführung um {{timestamp}} anzeigen",
+ "uk": "Переглянути розмову для запуску о {{timestamp}}",
+ "ca": "Mostra la conversa de l'execució a {{timestamp}}"
+ },
+
"AUTOMATIONS$DETAIL$PHASE": {
"ar": "المرحلة",
"ca": "Fase",
diff --git a/src/manifests/automation-insights.ts b/src/manifests/automation-insights.ts
index 866b9e235e..cc61aff7ad 100644
--- a/src/manifests/automation-insights.ts
+++ b/src/manifests/automation-insights.ts
@@ -9,8 +9,9 @@
*
* Summaries are derived from the newest page of runs (the sample the runs
* hook fetches); `total` alone is the response's lifetime count. Success rate
- * and durations consider only COMPLETED and FAILED runs — a cancelled or
- * skipped run says nothing about either.
+ * and durations consider only terminal lifecycle runs; the success numerator
+ * uses task-aware display status so completed-but-blocked work is not counted
+ * as successful.
*/
import {
@@ -19,6 +20,7 @@ import {
type AutomationRun,
type AutomationRunsResponse,
} from "#/types/automation";
+import { getAutomationRunDisplay } from "#/utils/automation-run-display";
import type {
DashboardSortValue,
DashboardStatusValue,
@@ -81,15 +83,29 @@ const TERMINAL_STATUSES = new Set<AutomationRunStatus>([
AutomationRunStatus.FAILED,
]);
+function isTaskSuccessful(run: AutomationRun): boolean {
+ const { badgeStatus } = getAutomationRunDisplay(run);
+ return (
+ badgeStatus === AutomationRunStatus.COMPLETED || badgeStatus === "success"
+ );
+}
+
+function isTaskFailing(run: AutomationRun): boolean {
+ const { badgeStatus } = getAutomationRunDisplay(run);
+ return (
+ badgeStatus === AutomationRunStatus.FAILED ||
+ badgeStatus === "failed" ||
+ badgeStatus === "blocked"
+ );
+}
+
export function summarizeAutomationRuns(
response: AutomationRunsResponse,
): AutomationRunSummary {
const terminal = response.runs.filter((run) =>
TERMINAL_STATUSES.has(run.status),
);
- const completed = terminal.filter(
- (run) => run.status === AutomationRunStatus.COMPLETED,
- ).length;
+ const completed = terminal.filter(isTaskSuccessful).length;
let completedTotal: number | null;
if (response.status_counts) {
@@ -135,14 +151,14 @@ export function deriveAutomationHealth(
}
const latest = state.summary.latestRun;
if (!latest) return "never-run";
- if (latest.status === AutomationRunStatus.FAILED) return "failing";
+ if (isTaskFailing(latest)) return "failing";
if (
latest.status === AutomationRunStatus.PENDING ||
latest.status === AutomationRunStatus.RUNNING
) {
return "running";
}
- return "healthy";
+ return isTaskSuccessful(latest) ? "healthy" : "unknown";
}
/** "—" unknown, seconds under a minute, minutes under an hour, else "1.5h". */
diff --git a/src/types/automation.ts b/src/types/automation.ts
index 04efe9e669..374ad4ae08 100644
--- a/src/types/automation.ts
+++ b/src/types/automation.ts
@@ -79,6 +79,37 @@ export enum AutomationRunStatus {
SKIPPED = "SKIPPED",
}
+export type AutomationTaskOutcomeStatus =
+ | "success"
+ | "partial_success"
+ | "blocked"
+ | "failed"
+ | "unknown";
+
+export interface AutomationFinishToolResponse {
+ status?: AutomationTaskOutcomeStatus | string;
+ outcome_summary?: string;
+ [key: string]: unknown;
+}
+
+export interface AutomationRunMetadata {
+ finish_tool_response?: AutomationFinishToolResponse | string | null;
+ [key: string]: unknown;
+}
+
+export interface AutomationRunStatusDetail {
+ phase?: string;
+ kind?: string;
+ detail?: string;
+ formatted_detail?: string;
+ transient?: boolean;
+ source?: string;
+ operation?: string;
+ code?: string;
+ status_code?: number;
+ [key: string]: unknown;
+}
+
export interface AutomationRun {
id: string;
status: AutomationRunStatus;
@@ -92,6 +123,8 @@ export interface AutomationRun {
*/
bash_command_id: string | null;
error_detail: string | null;
+ status_detail?: AutomationRunStatusDetail | null;
+ run_metadata?: AutomationRunMetadata | null;
/**
* Accumulated LLM cost of the run in USD, reported by the SDK in the
* completion callback. `null` means unknown — the run predates cost
diff --git a/src/utils/automation-run-display.ts b/src/utils/automation-run-display.ts
new file mode 100644
index 0000000000..6c757e43cc
--- /dev/null
+++ b/src/utils/automation-run-display.ts
@@ -0,0 +1,170 @@
+import { I18nKey } from "#/i18n/declaration";
+import {
+ AutomationRunStatus,
+ type AutomationRun,
+ type AutomationTaskOutcomeStatus,
+} from "#/types/automation";
+
+export type AutomationRunBadgeStatus =
+ | AutomationRunStatus
+ | AutomationTaskOutcomeStatus;
+
+export interface AutomationRunTaskOutcome {
+ status: AutomationTaskOutcomeStatus;
+ outcomeSummary: string | null;
+}
+
+export interface AutomationRunDisplay {
+ badgeStatus: AutomationRunBadgeStatus;
+ summary: string | null;
+ taskOutcome: AutomationRunTaskOutcome | null;
+ customTaskMetadata: unknown | null;
+ customTaskMetadataText: string | null;
+}
+
+const TASK_OUTCOME_STATUSES: readonly AutomationTaskOutcomeStatus[] = [
+ "success",
+ "partial_success",
+ "blocked",
+ "failed",
+ "unknown",
+];
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+ return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+export function isTaskOutcomeStatus(
+ value: unknown,
+): value is AutomationTaskOutcomeStatus {
+ return (
+ typeof value === "string" &&
+ TASK_OUTCOME_STATUSES.includes(value as AutomationTaskOutcomeStatus)
+ );
+}
+
+function trimString(value: unknown): string | null {
+ if (typeof value !== "string") return null;
+ return value.trim() || null;
+}
+
+const DEFAULT_FINISH_TOOL_RESPONSE_KEYS = new Set([
+ "status",
+ "outcome_summary",
+]);
+
+export function getAutomationRunFinishToolResponse(
+ run: AutomationRun,
+): unknown | null {
+ const response = run.run_metadata?.finish_tool_response;
+ return response === undefined || response === null ? null : response;
+}
+
+export function formatAutomationRunTaskMetadata(
+ metadata: unknown,
+): string | null {
+ const trimmed = trimString(metadata);
+ if (trimmed) return trimmed;
+ if (typeof metadata === "number" || typeof metadata === "boolean") {
+ return String(metadata);
+ }
+ if (metadata === null || metadata === undefined) return null;
+
+ try {
+ return JSON.stringify(metadata, null, 2);
+ } catch {
+ return String(metadata);
+ }
+}
+
+function getCustomFinishToolMetadata(response: unknown): unknown | null {
+ if (response === null || response === undefined) return null;
+ if (!isRecord(response)) return response;
+
+ const customEntries = Object.entries(response).filter(
+ ([key]) => !DEFAULT_FINISH_TOOL_RESPONSE_KEYS.has(key),
+ );
+ if (customEntries.length > 0) return Object.fromEntries(customEntries);
+
+ if ("status" in response && !isTaskOutcomeStatus(response.status)) {
+ return { status: response.status };
+ }
+
+ return null;
+}
+
+export function getAutomationRunTaskOutcome(
+ run: AutomationRun,
+): AutomationRunTaskOutcome | null {
+ const response = getAutomationRunFinishToolResponse(run);
+ if (!isRecord(response)) return null;
+
+ const outcomeSummary = trimString(response.outcome_summary);
+ const hasStatus = typeof response.status === "string";
+ if (!hasStatus && !outcomeSummary) return null;
+
+ return {
+ status: isTaskOutcomeStatus(response.status) ? response.status : "unknown",
+ outcomeSummary,
+ };
+}
+
+export function getAutomationRunDisplay(
+ run: AutomationRun,
+): AutomationRunDisplay {
+ const finishToolResponse = getAutomationRunFinishToolResponse(run);
+ const customTaskMetadata = getCustomFinishToolMetadata(finishToolResponse);
+ const customTaskMetadataText =
+ formatAutomationRunTaskMetadata(customTaskMetadata);
+ const taskOutcome = getAutomationRunTaskOutcome(run);
+ const systemSummary = trimString(run.error_detail);
+
+ if (run.status === AutomationRunStatus.COMPLETED) {
+ return {
+ badgeStatus:
+ taskOutcome?.status ??
+ (finishToolResponse !== null ? "unknown" : "success"),
+ summary: taskOutcome?.outcomeSummary ?? null,
+ taskOutcome,
+ customTaskMetadata,
+ customTaskMetadataText,
+ };
+ }
+
+ return {
+ badgeStatus: run.status,
+ summary: systemSummary,
+ taskOutcome,
+ customTaskMetadata,
+ customTaskMetadataText,
+ };
+}
+
+export function getAutomationRunBadgeLabelKey(
+ status: AutomationRunBadgeStatus | string,
+): I18nKey {
+ switch (status) {
+ case AutomationRunStatus.COMPLETED:
+ case "success":
+ return I18nKey.AUTOMATIONS$DETAIL$SUCCESSFUL;
+ case AutomationRunStatus.FAILED:
+ case "failed":
+ return I18nKey.AUTOMATIONS$DETAIL$FAILED;
+ case AutomationRunStatus.PENDING:
+ return I18nKey.AUTOMATIONS$DETAIL$PENDING;
+ case AutomationRunStatus.RUNNING:
+ return I18nKey.AUTOMATIONS$DETAIL$RUNNING;
+ case AutomationRunStatus.CANCELLED:
+ return I18nKey.AUTOMATIONS$DETAIL$CANCELLED;
+ case AutomationRunStatus.SKIPPED:
+ return I18nKey.AUTOMATIONS$DETAIL$SKIPPED;
+ case "blocked":
+ return I18nKey.AUTOMATIONS$DETAIL$BLOCKED;
+ case "partial_success":
+ return I18nKey.AUTOMATIONS$DETAIL$PARTIAL;
+ case "unknown":
+ return I18nKey.AUTOMATIONS$DETAIL$NEEDS_REVIEW;
+ default:
+ return I18nKey.FEATURED_AUTOMATIONS$STATUS_UNKNOWN;
+ }
+}