OpsOrch · yusufaytas · Jan 8, 2026 · Jan 8, 2026
diff --git a/README.md b/README.md
@@ -10,7 +10,7 @@ OpsOrch Console is the operator-focused web UI for OpsOrch. It provides a unifie
 
 OpsOrch Console is available in two editions built from a single codebase:
 
-- **OSS Edition** - Open source features including incidents, logs, metrics, tickets, services, and settings
+- **OSS Edition** - Open source features including incidents, logs, metrics, tickets, services, orchestration, and settings
 - **Enterprise Edition** - All OSS features plus AI-powered Copilot assistance and chat history
 
 The edition is controlled at build time via the `OPSORCH_EDITION` environment variable.
@@ -23,6 +23,7 @@ The edition is controlled at build time via the `OPSORCH_EDITION` environment va
 - **Metrics**: Visualize and query metrics data with customizable expressions and aggregations
 - **Services**: Explore service catalog and dependencies
 - **Tickets**: View and manage tickets from integrated ticketing systems
+- **Orchestration**: Browse workflow plans, launch runs, monitor run status, and complete manual steps with progress tracking
 - **Chat**: AI-powered assistance via OpsOrch Copilot for incident investigation, log analysis, and operational queries. Copilot can generate smart references to filtered views with query parameters
 - **Settings**: Configure OpsOrch Core and Copilot endpoints
 
@@ -35,6 +36,14 @@ All primary data views (Incidents, Alerts, Logs, Metrics) support:
 - **Scope filtering**: Filter by service, environment, and team
 - **Copilot integration**: AI can generate filtered views and include them as clickable references
 
+### Copilot Answer Actions
+
+Copilot responses can include recommended actions to trigger orchestration workflows:
+
+- `actions` entries use the `orchestration` type and may include `id`, `name`, and `reason`
+- When an `id` is present, the UI links directly to `/orchestration/plans/{id}`
+- When no `id` is provided, the UI routes operators to the orchestration plan browser
+
 
 ## Architecture
 
@@ -202,7 +211,7 @@ The Docker images run as a non-root user and expose port 3000. Both editions sup
 ## Project Structure
 
 - `app/` - Next.js app router pages and layouts
-  - `(oss)/` - OSS Edition routes (incidents, logs, metrics, tickets, services, settings)
+  - `(oss)/` - OSS Edition routes (incidents, logs, metrics, tickets, services, orchestration, settings)
   - `(enterprise)/` - Enterprise Edition routes (Copilot home, chat history)
   - `components/` - Reusable React components
     - `(enterprise)/` - Enterprise-only components (CopilotPanel, etc.)
@@ -312,4 +321,3 @@ Download release artifacts from the [Releases page](https://github.com/OpsOrch/o
 - [OpsOrch Core Documentation](../opsorch-core/README.md)
 - [OpsOrch Copilot Documentation](../opsorch-copilot/README.md)
 - [Next.js Documentation](https://nextjs.org/docs)
-
diff --git a/app/(oss)/deployments/[id]/page.tsx b/app/(oss)/deployments/[id]/page.tsx
@@ -58,7 +58,7 @@ export default function DeploymentDetailPage() {
       .catch((err) => {
         deploymentState.fail(err);
       });
-  }, [deploymentId]); // eslint-disable-line react-hooks/exhaustive-deps
+  }, [deploymentId, deploymentState]);
 
 
 

diff --git a/app/components/(enterprise)/CopilotPanel.tsx b/app/components/(enterprise)/CopilotPanel.tsx
@@ -48,14 +48,19 @@ function normalizeAnswer(payload: CopilotApiResponse): CopilotAnswer {
   // Extract executionTrace from the answer
   const derivedExecutionTrace = answer.executionTrace;
 
+  // Extract actions from the answer
+  const derivedActions = answer.actions;
+
   console.log('[normalizeAnswer] answer.references:', answer.references);
   console.log('[normalizeAnswer] derivedReferences:', derivedReferences);
   console.log('[normalizeAnswer] executionTrace:', derivedExecutionTrace);
+  console.log('[normalizeAnswer] actions:', derivedActions);
 
   return {
     conclusion: derivedConclusion,
     missing: answer.missing,
     references: derivedReferences,
+    actions: derivedActions,
     confidence: answer.confidence,
     chatId: derivedChatId,
     executionTrace: derivedExecutionTrace,

diff --git a/app/components/(enterprise)/copilot/ActionLinks.tsx b/app/components/(enterprise)/copilot/ActionLinks.tsx
@@ -0,0 +1,55 @@
+import React from "react";
+import { CopilotAction } from "@/app/lib/types";
+
+export function ActionLinks({
+    actions,
+}: {
+    actions?: CopilotAction[];
+}) {
+    if (!actions?.length) {
+        return null;
+    }
+
+    return (
+        <div className="space-y-2">
+            <p className="text-[11px] font-semibold uppercase tracking-wide text-slate-500">
+                Recommended Actions ({actions.length})
+            </p>
+            <div className="flex flex-col gap-2">
+                {actions.map((action, idx) => {
+                    const href = action.id
+                        ? `/orchestration/plans/${action.id}`
+                        : `/orchestration/plans`;
+                    const label = action.name || action.id || "Run Orchestration";
+
+                    return (
+                        <a
+                            key={`action-${idx}`}
+                            href={href}
+                            className="group flex items-start gap-3 rounded-lg border border-emerald-200 bg-gradient-to-r from-emerald-50 to-teal-50 px-4 py-3 transition-all hover:border-emerald-300 hover:from-emerald-100 hover:to-teal-100 hover:shadow-md"
+                        >
+                            <div className="flex h-8 w-8 flex-shrink-0 items-center justify-center rounded-full bg-emerald-100 text-emerald-600">
+                                <svg className="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                                    <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M13 10V3L4 14h7v7l9-11h-7z" />
+                                </svg>
+                            </div>
+                            <div className="flex-1 min-w-0">
+                                <div className="flex items-center gap-2">
+                                    <span className="text-sm font-semibold text-emerald-800">{label}</span>
+                                    <svg className="h-3.5 w-3.5 text-emerald-400 transition-transform group-hover:translate-x-0.5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                                        <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 5l7 7-7 7" />
+                                    </svg>
+                                </div>
+                                {action.reason && (
+                                    <p className="mt-1 text-xs text-emerald-600 leading-relaxed">
+                                        {action.reason}
+                                    </p>
+                                )}
+                            </div>
+                        </a>
+                    );
+                })}
+            </div>
+        </div>
+    );
+}
diff --git a/app/components/(enterprise)/copilot/ReferenceLinks.tsx b/app/components/(enterprise)/copilot/ReferenceLinks.tsx
@@ -13,9 +13,9 @@ export function ReferenceLinks({
         console.log('[ReferenceLinks] No references provided');
         return null;
     }
-    const { incidents, alerts, services, metrics, logs, tickets, deployments, teams } = references;
-    console.log('[ReferenceLinks] Extracted:', { incidents, alerts, services, metrics, logs, tickets, deployments, teams });
-    if (!incidents?.length && !alerts?.length && !services?.length && !metrics?.length && !logs?.length && !tickets?.length && !deployments?.length && !teams?.length) {
+    const { incidents, alerts, services, metrics, logs, tickets, deployments, teams, orchestrationPlans } = references;
+    console.log('[ReferenceLinks] Extracted:', { incidents, alerts, services, metrics, logs, tickets, deployments, teams, orchestrationPlans });
+    if (!incidents?.length && !alerts?.length && !services?.length && !metrics?.length && !logs?.length && !tickets?.length && !deployments?.length && !teams?.length && !orchestrationPlans?.length) {
         console.log('[ReferenceLinks] All reference arrays are empty');
         return null;
     }
@@ -36,7 +36,8 @@ export function ReferenceLinks({
         (logs?.length || 0) +
         (tickets?.length || 0) +
         (deployments?.length || 0) +
-        (teams?.length || 0);
+        (teams?.length || 0) +
+        (orchestrationPlans?.length || 0);
 
     return (
         <div className="space-y-2 text-xs text-slate-700">
@@ -70,11 +71,11 @@ export function ReferenceLinks({
                         const href = isString ? `/incidents/${inc}` : buildIncidentHref(inc);
                         const label = isString ? `Incident ${inc}` : inc.query || 'Incident Query';
                         return (
-                                    <a
-                                        key={`inc-${idx}`}
-                                        href={href}
-                                        className="group inline-flex items-center gap-1.5 rounded-lg border border-slate-200 bg-white px-3 py-1.5 font-medium text-slate-700 shadow-sm transition-all hover:border-slate-300 hover:bg-slate-50"
-                                    >
+                            <a
+                                key={`inc-${idx}`}
+                                href={href}
+                                className="group inline-flex items-center gap-1.5 rounded-lg border border-slate-200 bg-white px-3 py-1.5 font-medium text-slate-700 shadow-sm transition-all hover:border-slate-300 hover:bg-slate-50"
+                            >
                                 <svg className="h-3.5 w-3.5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
                                     <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z" />
                                 </svg>
@@ -92,11 +93,11 @@ export function ReferenceLinks({
                         const href = isString ? `/alerts/${alert}` : buildAlertHref(alert);
                         const label = isString ? alert : alert.query || 'Alert Query';
                         return (
-                                    <a
-                                        key={`alert-${idx}`}
-                                        href={href}
-                                        className="inline-flex items-center gap-1.5 rounded-lg border border-slate-200 bg-white px-3 py-1.5 font-medium text-slate-700 shadow-sm transition-all hover:border-slate-300 hover:bg-slate-50"
-                                    >
+                            <a
+                                key={`alert-${idx}`}
+                                href={href}
+                                className="inline-flex items-center gap-1.5 rounded-lg border border-slate-200 bg-white px-3 py-1.5 font-medium text-slate-700 shadow-sm transition-all hover:border-slate-300 hover:bg-slate-50"
+                            >
                                 <svg className="h-3.5 w-3.5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
                                     <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M15 17h5l-1.405-1.405A2.032 2.032 0 0118 14.158V11a6.002 6.002 0 00-4-5.659V5a2 2 0 10-4 0v.341C7.67 6.165 6 8.388 6 11v3.159c0 .538-.214 1.055-.595 1.436L4 17h5m6 0v1a3 3 0 11-6 0v-1m6 0H9" />
                                 </svg>
@@ -133,11 +134,11 @@ export function ReferenceLinks({
                         }
 
                         return (
-                                    <a
-                                        key={`deployment-${idx}`}
-                                        href={href}
-                                        className="inline-flex items-center gap-1.5 rounded-lg border border-slate-200 bg-white px-3 py-1.5 font-medium text-slate-700 shadow-sm transition-all hover:border-slate-300 hover:bg-slate-50"
-                                    >
+                            <a
+                                key={`deployment-${idx}`}
+                                href={href}
+                                className="inline-flex items-center gap-1.5 rounded-lg border border-slate-200 bg-white px-3 py-1.5 font-medium text-slate-700 shadow-sm transition-all hover:border-slate-300 hover:bg-slate-50"
+                            >
                                 <svg className="h-3.5 w-3.5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
                                     <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M7 16a4 4 0 01-.88-7.903A5 5 0 1115.9 6L16 6a5 5 0 011 9.9M15 13l-3-3m0 0l-3 3m3-3v12" />
                                 </svg>
@@ -151,11 +152,11 @@ export function ReferenceLinks({
                 <div>
                     <p className="mb-1 text-[10px] font-medium uppercase tracking-wide text-slate-400">Services</p>
                     {renderList(services.map((svc) => (
-                                <a
-                                    key={`svc-${svc}`}
-                                    href={`/services/${svc}`}
-                                    className="inline-flex items-center gap-1.5 rounded-lg border border-slate-200 bg-white px-3 py-1.5 font-medium text-slate-700 shadow-sm transition-all hover:border-slate-300 hover:bg-slate-50"
-                                >
+                        <a
+                            key={`svc-${svc}`}
+                            href={`/services/${svc}`}
+                            className="inline-flex items-center gap-1.5 rounded-lg border border-slate-200 bg-white px-3 py-1.5 font-medium text-slate-700 shadow-sm transition-all hover:border-slate-300 hover:bg-slate-50"
+                        >
                             <svg className="h-3.5 w-3.5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
                                 <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M5 12h14M5 12a2 2 0 01-2-2V6a2 2 0 012-2h14a2 2 0 012 2v4a2 2 0 01-2 2M5 12a2 2 0 00-2 2v4a2 2 0 002 2h14a2 2 0 002-2v-4a2 2 0 00-2-2m-2-4h.01M17 16h.01" />
                             </svg>
@@ -168,11 +169,11 @@ export function ReferenceLinks({
                 <div>
                     <p className="mb-1 text-[10px] font-medium uppercase tracking-wide text-slate-400">Teams</p>
                     {renderList(teams.map((team: string) => (
-                                <a
-                                    key={`team-${team}`}
-                                    href={`/teams/${team}`}
-                                    className="inline-flex items-center gap-1.5 rounded-lg border border-slate-200 bg-white px-3 py-1.5 font-medium text-slate-700 shadow-sm transition-all hover:border-slate-300 hover:bg-slate-50"
-                                >
+                        <a
+                            key={`team-${team}`}
+                            href={`/teams/${team}`}
+                            className="inline-flex items-center gap-1.5 rounded-lg border border-slate-200 bg-white px-3 py-1.5 font-medium text-slate-700 shadow-sm transition-all hover:border-slate-300 hover:bg-slate-50"
+                        >
                             <svg className="h-3.5 w-3.5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
                                 <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M17 20h5v-2a3 3 0 00-5.356-1.857M17 20H7m10 0v-2c0-.656-.126-1.283-.356-1.857M7 20H2v-2a3 3 0 015.356-1.857M7 20v-2c0-.656.126-1.283.356-1.857m0 0a5.002 5.002 0 019.288 0M15 7a3 3 0 11-6 0 3 3 0 016 0zm6 3a2 2 0 11-4 0 2 2 0 014 0zM7 10a2 2 0 11-4 0 2 2 0 014 0z" />
                             </svg>
@@ -189,12 +190,12 @@ export function ReferenceLinks({
                             const label = `${t}`;
                             const href = t ? `/tickets?ticketId=${encodeURIComponent(t)}` : "/tickets";
                             return (
-                                        <a
-                                            key={`ticket-${t}`}
-                                            href={href}
-                                            className="inline-flex items-center gap-1.5 rounded-lg border border-slate-200 bg-white px-3 py-1.5 font-medium text-slate-700 shadow-sm transition-all hover:border-slate-300 hover:bg-slate-50"
-                                            title="Open in tickets"
-                                        >
+                                <a
+                                    key={`ticket-${t}`}
+                                    href={href}
+                                    className="inline-flex items-center gap-1.5 rounded-lg border border-slate-200 bg-white px-3 py-1.5 font-medium text-slate-700 shadow-sm transition-all hover:border-slate-300 hover:bg-slate-50"
+                                    title="Open in tickets"
+                                >
                                     <svg className="h-3.5 w-3.5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
                                         <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M15 5v2m0 4v2m0 4v2M5 5a2 2 0 00-2 2v3a2 2 0 110 4v3a2 2 0 002 2h14a2 2 0 002-2v-3a2 2 0 110-4V7a2 2 0 00-2-2H5z" />
                                     </svg>
@@ -218,12 +219,12 @@ export function ReferenceLinks({
                                     : "(unnamed)";
                             const tooltip = `${m.start || "?"} → ${m.end || "?"}${m.scope ? ` • Scope: ${JSON.stringify(m.scope)}` : ""}`;
                             return (
-                                        <a
-                                            key={`metric-${idx}`}
-                                            href={buildMetricHref(m)}
-                                            className="inline-flex items-center gap-1.5 rounded-lg border border-slate-200 bg-white px-3 py-1.5 font-medium text-slate-700 shadow-sm transition-all hover:border-slate-300 hover:bg-slate-50"
-                                            title={`Open in metrics • ${tooltip}`}
-                                        >
+                                <a
+                                    key={`metric-${idx}`}
+                                    href={buildMetricHref(m)}
+                                    className="inline-flex items-center gap-1.5 rounded-lg border border-slate-200 bg-white px-3 py-1.5 font-medium text-slate-700 shadow-sm transition-all hover:border-slate-300 hover:bg-slate-50"
+                                    title={`Open in metrics • ${tooltip}`}
+                                >
                                     <svg className="h-3.5 w-3.5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
                                         <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 19v-6a2 2 0 00-2-2H5a2 2 0 00-2 2v6a2 2 0 002 2h2a2 2 0 002-2zm0 0V9a2 2 0 012-2h2a2 2 0 012 2v10m-6 0a2 2 0 002 2h2a2 2 0 002-2m0 0V5a2 2 0 012-2h2a2 2 0 012 2v14a2 2 0 01-2 2h-2a2 2 0 01-2-2z" />
                                     </svg>
@@ -259,6 +260,23 @@ export function ReferenceLinks({
                     )}
                 </div>
             ) : null}
+            {isExpanded && orchestrationPlans?.length ? (
+                <div>
+                    <p className="mb-1 text-[10px] font-medium uppercase tracking-wide text-slate-400">Orchestration Plans</p>
+                    {renderList(orchestrationPlans.map((planId: string) => (
+                        <a
+                            key={`plan-${planId}`}
+                            href={`/orchestration/plans/${planId}`}
+                            className="inline-flex items-center gap-1.5 rounded-lg border border-slate-200 bg-white px-3 py-1.5 font-medium text-slate-700 shadow-sm transition-all hover:border-slate-300 hover:bg-slate-50"
+                        >
+                            <svg className="h-3.5 w-3.5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                                <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M4 5a1 1 0 011-1h14a1 1 0 011 1v2a1 1 0 01-1 1H5a1 1 0 01-1-1V5zM4 13a1 1 0 011-1h6a1 1 0 011 1v6a1 1 0 01-1 1H5a1 1 0 01-1-1v-6zM16 13a1 1 0 011-1h2a1 1 0 011 1v6a1 1 0 01-1 1h-2a1 1 0 01-1-1v-6z" />
+                            </svg>
+                            {planId}
+                        </a>
+                    )))}
+                </div>
+            ) : null}
         </div>
     );
 }