@growthub/cli 0.13.4 → 0.13.5

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/app/data-model/components/OrchestrationRunTracePanel.jsx

@@ -215,6 +215,43 @@ async function copyToClipboard(text) {
   }
 }
 
+function formatRewardScore(value) {
+  const n = Number(value);
+  if (!Number.isFinite(n)) return "—";
+  return n.toFixed(2);
+}
+
+function SwarmSection({ swarm }) {
+  if (!swarm || typeof swarm !== "object") return null;
+  const tasks = Array.isArray(swarm.tasks) ? swarm.tasks : [];
+  if (tasks.length === 0 && !swarm.orchestrator?.plan && !swarm.synthesis?.answer) return null;
+  const completed = tasks.filter((t) => t?.status === "completed").length;
+  const score = swarm.reward ? formatRewardScore(swarm.reward.score) : "—";
+  const kind = swarm.reward?.kind || "structural-v1";
+  const synthesis = swarm.synthesis || null;
+  return (
+    <section className="dm-run-console__section">
+      <h3>Swarm</h3>
+      <p className="dm-swarm-summary__line">
+        <span><strong>{completed}/{tasks.length}</strong></span>
+        <span>score <strong>{score}</strong></span>
+        <span className="dm-swarm-summary__kind" title={swarm.reward?.note || ""}>{kind}</span>
+      </p>
+      {synthesis?.answer ? (
+        <details className="dm-swarm-phase" open>
+          <summary>
+            synthesizer
+            {synthesis.parsedOutcomeScore != null
+              ? ` · ${Number(synthesis.parsedOutcomeScore).toFixed(2)}`
+              : ""}
+          </summary>
+          <pre>{synthesis.answer}</pre>
+        </details>
+      ) : null}
+    </section>
+  );
+}
+
 function InputsSection({ payload }) {
   const runInputs = payload?.runInputs;
   const summary = payload?.inputSummary;
@@ -477,6 +514,9 @@ export function OrchestrationRunTracePanel({
   const payload = activeConsoleRecord?.payload || {};
   const output = activeConsoleRecord?.output || {};
   const context = activeConsoleRecord?.context || {};
+  const swarmPayload = activeConsoleRecord?.swarm
+    || (activeRawRecord && activeRawRecord.swarm)
+    || null;
 
   return (
     <section className="dm-run-console" aria-label="Live runs console">
@@ -710,6 +750,7 @@ export function OrchestrationRunTracePanel({
                 <CodeBlock label="Command" body={payload.command} />
                 <CodeBlock label="Instructions" body={payload.instructions} />
               </section>
+              <SwarmSection swarm={swarmPayload} />
               <InputsSection payload={payload} />
             </div>
           )}

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/app/data-model/components/WorkspaceGraphInspectorPanel.jsx

@@ -0,0 +1,226 @@
+"use client";
+
+/**
+ * Growthub Workspace Metadata Graph V1 — read-only inspector panel.
+ *
+ * Surfaces a selected metadata node's dependencies + dependents + warnings.
+ *
+ * Mounting status (V1):
+ *   This component SHIPS with the worker kit but is NOT yet mounted by the
+ *   existing builder / workflow / data-model surfaces. Mounting is
+ *   intentionally deferred to a follow-up PR so the V1 scope stays focused
+ *   on the typed projection + GET route. Operators that want the inspector
+ *   now can import it directly:
+ *
+ *     import { WorkspaceGraphInspectorPanel } from "@/app/data-model/components/WorkspaceGraphInspectorPanel.jsx";
+ *
+ *   Intended future entry points:
+ *
+ *     - Widget sidecar: View dependencies
+ *     - Workflow sidecar: View dependencies
+ *     - Run console: View graph lineage
+ *     - Data Model row sidecar: View dependents
+ *     - Workspace Settings: Metadata Graph
+ *
+ * V1 invariants:
+ *   - Read-only. No edits. No deletes.
+ *   - No fetch of provider data — only `GET /api/workspace/metadata-graph`.
+ *   - No secrets rendered.
+ */
+
+import { useEffect, useMemo, useState } from "react";
+import { findDependencies, findDependents } from "@/lib/workspace-metadata-graph";
+
+const RELATION_LABELS = {
+  containsWidget: "contains widget",
+  bindsToObject: "binds to object",
+  usesField: "uses field",
+  filteredByField: "filtered by field",
+  sortedByField: "sorted by field",
+  backedBySourceRecord: "backed by source record",
+  scopedToEntity: "scoped to entity",
+  containsNode: "contains node",
+  usesSandbox: "uses sandbox",
+  readsObject: "reads object",
+  writesObject: "writes object",
+  requiresRunInput: "requires run input",
+  callsIntegration: "calls integration",
+  usesAgentHost: "uses agent host",
+  executedWorkflow: "executed workflow",
+  executedSandbox: "executed sandbox",
+  usedAgentHost: "used agent host",
+  producedArtifact: "produced artifact",
+  belongsToIntegration: "belongs to integration",
+  boundToIntegration: "bound to integration"
+};
+
+const NODE_TYPE_LABELS = {
+  dashboard: "Dashboard",
+  widget: "Widget",
+  dataModelObject: "Data Model object",
+  field: "Field",
+  view: "View",
+  workflow: "Workflow",
+  workflowNode: "Workflow node",
+  runInput: "Run input",
+  sandbox: "Sandbox",
+  agentHost: "Agent host",
+  integration: "Integration",
+  integrationEntity: "Integration entity",
+  sourceRecord: "Source record",
+  run: "Run",
+  outputArtifact: "Output artifact"
+};
+
+function relationLabel(relation) {
+  return RELATION_LABELS[relation] || relation;
+}
+
+function nodeTypeLabel(type) {
+  return NODE_TYPE_LABELS[type] || type;
+}
+
+export function WorkspaceGraphInspectorPanel({ selectedNodeId, onSelectNode }) {
+  const [graph, setGraph] = useState(null);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const [internalSelectedId, setInternalSelectedId] = useState(selectedNodeId || "");
+
+  useEffect(() => {
+    let canceled = false;
+    setLoading(true);
+    setError(null);
+    fetch("/api/workspace/metadata-graph")
+      .then((response) => {
+        if (!response.ok) throw new Error(`HTTP ${response.status}`);
+        return response.json();
+      })
+      .then((envelope) => {
+        if (canceled) return;
+        setGraph(envelope?.graph || { nodes: [], edges: [] });
+      })
+      .catch((err) => {
+        if (canceled) return;
+        setError(err?.message || "Failed to load metadata graph");
+      })
+      .finally(() => {
+        if (!canceled) setLoading(false);
+      });
+    return () => { canceled = true; };
+  }, []);
+
+  useEffect(() => {
+    if (selectedNodeId && selectedNodeId !== internalSelectedId) {
+      setInternalSelectedId(selectedNodeId);
+    }
+  }, [selectedNodeId, internalSelectedId]);
+
+  const nodes = graph?.nodes || [];
+  const selected = useMemo(
+    () => nodes.find((node) => node.id === internalSelectedId) || null,
+    [nodes, internalSelectedId]
+  );
+
+  const dependencies = useMemo(
+    () => (graph && selected ? findDependencies(graph, selected.id) : []),
+    [graph, selected]
+  );
+  const dependents = useMemo(
+    () => (graph && selected ? findDependents(graph, selected.id) : []),
+    [graph, selected]
+  );
+
+  const handleSelect = (nodeId) => {
+    setInternalSelectedId(nodeId);
+    if (typeof onSelectNode === "function") onSelectNode(nodeId);
+  };
+
+  return (
+    <div className="workspace-graph-inspector" aria-label="Workspace metadata graph inspector">
+      <header className="workspace-graph-inspector-header">
+        <h3>Workspace metadata graph</h3>
+        <p className="workspace-graph-inspector-subtitle">
+          Read-only projection of dashboards, widgets, workflows, sandboxes, and runs.
+        </p>
+      </header>
+
+      {loading && <p className="workspace-graph-inspector-loading">Loading metadata graph…</p>}
+      {error && (
+        <p className="workspace-graph-inspector-error" role="alert">
+          Could not load metadata graph: {error}
+        </p>
+      )}
+
+      <div className="workspace-graph-inspector-body">
+        <aside className="workspace-graph-inspector-list">
+          <h4>Nodes ({nodes.length})</h4>
+          <ul>
+            {nodes.map((node) => (
+              <li key={node.id}>
+                <button
+                  type="button"
+                  className={`workspace-graph-inspector-node-button${node.id === internalSelectedId ? " is-selected" : ""}`}
+                  onClick={() => handleSelect(node.id)}
+                >
+                  <span className="workspace-graph-inspector-node-type">{nodeTypeLabel(node.type)}</span>
+                  <span className="workspace-graph-inspector-node-label">{node.label || node.id}</span>
+                </button>
+              </li>
+            ))}
+          </ul>
+        </aside>
+
+        <section className="workspace-graph-inspector-detail">
+          {!selected && <p className="workspace-graph-inspector-empty">Select a node to view dependencies.</p>}
+          {selected && (
+            <>
+              <h4>{nodeTypeLabel(selected.type)} · {selected.label}</h4>
+              <dl className="workspace-graph-inspector-summary">
+                {Object.entries(selected.summary || {}).map(([key, value]) => (
+                  <div key={key}>
+                    <dt>{key}</dt>
+                    <dd>{Array.isArray(value) ? value.join(", ") || "—" : (value === null || value === "" ? "—" : String(value))}</dd>
+                  </div>
+                ))}
+              </dl>
+
+              <section className="workspace-graph-inspector-edges">
+                <h5>Depends on ({dependencies.length})</h5>
+                <ul>
+                  {dependencies.length === 0 && <li className="workspace-graph-inspector-empty">No dependencies.</li>}
+                  {dependencies.map(({ node, relation }) => (
+                    <li key={`dep::${node.id}::${relation}`}>
+                      <button type="button" onClick={() => handleSelect(node.id)}>
+                        <span className="workspace-graph-inspector-relation">{relationLabel(relation)}</span>
+                        <span className="workspace-graph-inspector-node-type">{nodeTypeLabel(node.type)}</span>
+                        <span className="workspace-graph-inspector-node-label">{node.label || node.id}</span>
+                      </button>
+                    </li>
+                  ))}
+                </ul>
+              </section>
+
+              <section className="workspace-graph-inspector-edges">
+                <h5>Used by ({dependents.length})</h5>
+                <ul>
+                  {dependents.length === 0 && <li className="workspace-graph-inspector-empty">Nothing depends on this node yet.</li>}
+                  {dependents.map(({ node, relation }) => (
+                    <li key={`from::${node.id}::${relation}`}>
+                      <button type="button" onClick={() => handleSelect(node.id)}>
+                        <span className="workspace-graph-inspector-relation">{relationLabel(relation)}</span>
+                        <span className="workspace-graph-inspector-node-type">{nodeTypeLabel(node.type)}</span>
+                        <span className="workspace-graph-inspector-node-label">{node.label || node.id}</span>
+                      </button>
+                    </li>
+                  ))}
+                </ul>
+              </section>
+            </>
+          )}
+        </section>
+      </div>
+    </div>
+  );
+}
+
+export default WorkspaceGraphInspectorPanel;

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/app/globals.css

@@ -8398,3 +8398,19 @@ body.workspace-rail-collapsed .workspace-builder.dm-workflow-page {
 .dm-run-setup__actions { display: flex; gap: 8px; justify-content: flex-end; flex-wrap: wrap; }
 .dm-run-setup__actions .dm-btn-outline,
 .dm-run-setup__actions .dm-workflow-chip-btn { display: inline-flex; align-items: center; gap: 6px; }
+
+/* Agent swarm — sidecar editor (re-uses dm-orchestration-config tokens) */
+.dm-agent-swarm-panel__row { display: flex; align-items: center; gap: 6px; }
+.dm-agent-swarm-panel__row > span:first-child { flex: 1; font-size: 11px; font-weight: 600; color: #6b7280; text-transform: uppercase; letter-spacing: 0.04em; }
+.dm-agent-swarm-panel__row .dm-btn-outline { display: inline-flex; align-items: center; gap: 4px; font-size: 11px; padding: 3px 7px; }
+.dm-agent-swarm-panel__subagent { border: 1px solid #edf0f3; border-radius: 4px; padding: 8px 10px; display: flex; flex-direction: column; gap: 6px; }
+.dm-agent-swarm-panel__role { flex: 1; border: 1px solid #d1d5db; border-radius: 4px; padding: 4px 6px; font-size: 12px; color: #111827; background: #fff; }
+.dm-agent-swarm-panel__weights { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 6px; }
+
+/* Agent swarm — condensed run trace summary */
+.dm-swarm-summary__line { display: flex; flex-wrap: wrap; gap: 6px 12px; font-size: 11px; color: #6b7280; align-items: center; margin: 0 0 6px; }
+.dm-swarm-summary__line strong { color: #111827; font-weight: 600; }
+.dm-swarm-summary__kind { font-size: 10px; text-transform: uppercase; letter-spacing: 0.04em; color: #6b7280; border: 1px solid #e5e7eb; border-radius: 999px; padding: 1px 6px; }
+.dm-swarm-phase { border: 1px solid #edf0f3; border-radius: 4px; padding: 6px 8px; font-size: 11px; }
+.dm-swarm-phase summary { cursor: pointer; color: #6b7280; font-weight: 500; }
+.dm-swarm-phase pre { margin: 6px 0 0; font-size: 11px; white-space: pre-wrap; color: #111827; max-height: 240px; overflow: auto; }

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/app/workflows/WorkflowSurface.jsx

@@ -31,9 +31,11 @@ import { findSandboxRowByWorkflowRef } from "@/lib/nav-workflows";
 import {
   addCanonicalNodeToGraph,
   buildBlankOrchestrationGraphShell,
+  buildDefaultAgentSwarmGraph,
   buildDefaultOrchestrationGraphFromRegistry,
   getNextCanonicalNodeId,
   getOrchestrationGraphUiState,
+  isAgentSwarmGraph,
   parseOrchestrationGraph,
   redactSecretsFromText,
   serializeOrchestrationGraph,
@@ -45,8 +47,19 @@ import { OrchestrationGraphCanvas } from "../data-model/components/Orchestration
 import { OrchestrationGraphEmptyCanvas } from "../data-model/components/OrchestrationGraphEmptyCanvas.jsx";
 import { OrchestrationNodeConfigPanel } from "../data-model/components/OrchestrationNodeConfigPanel.jsx";
 import { OrchestrationRunTracePanel } from "../data-model/components/OrchestrationRunTracePanel.jsx";
+import { AgentSwarmPanel } from "../data-model/components/AgentSwarmPanel.jsx";
 import { RunSetupPanel } from "./RunSetupPanel.jsx";
-import { discoverRunInputSchema } from "@/lib/orchestration-run-inputs";
+import { describeRunInputMetadataItems, discoverRunInputSchema } from "@/lib/orchestration-run-inputs";
+import { selectWorkflowNodeInputSchema } from "@/lib/workspace-metadata-selectors";
+
+// Workspace Metadata Graph V1 — read-only dependency metadata for workflow
+// sidecars. The runtime path (sandbox-run, publish, draft/live) is
+// unchanged; this only exposes typed dependency descriptors so the sidecar
+// can render "this node requires N inputs from M source nodes".
+const WORKFLOW_METADATA_SELECTORS = Object.freeze({
+  describeRunInputMetadataItems,
+  selectWorkflowNodeInputSchema
+});
 
 function resolveRegistryRowForSandbox(workspaceConfig, sandboxRow) {
   const graph = parseOrchestrationGraph(sandboxRow?.orchestrationGraph);
@@ -382,9 +395,10 @@ export default function WorkflowSurface() {
   const graphUiState = getOrchestrationGraphUiState(orchestrationGraph);
   const graphUnset = graphUiState === "unset";
   const graphBlankShell = graphUiState === "blank-shell";
+  const swarmMode = useMemo(() => isAgentSwarmGraph(orchestrationGraph), [orchestrationGraph]);
   const nextNodeId = useMemo(
-    () => (orchestrationGraph ? getNextCanonicalNodeId(orchestrationGraph) : "input"),
-    [orchestrationGraph]
+    () => (orchestrationGraph && !swarmMode ? getNextCanonicalNodeId(orchestrationGraph) : null),
+    [orchestrationGraph, swarmMode]
   );
 
   const selectedNode = useMemo(() => {
@@ -649,6 +663,16 @@ export default function WorkflowSurface() {
     setDirty(true);
   }
 
+  function startAgentSwarm() {
+    const graph = buildDefaultAgentSwarmGraph({
+      agentHost: String(sandboxRow?.agentHost || "").trim()
+    });
+    setOrchestrationGraph(graph);
+    setSelectedNodeId("orchestrator");
+    setConfigTab("swarm");
+    setDirty(true);
+  }
+
   function applyPastedGraph(text) {
     const parsed = parseOrchestrationGraph(text);
     if (parsed) {
@@ -871,6 +895,7 @@ export default function WorkflowSurface() {
                     disabled={false}
                     onStartFromRegistry={registryRow ? startFromRegistry : undefined}
                     onStartBlank={startBlank}
+                    onStartAgentSwarm={startAgentSwarm}
                     onPasteGraph={applyPastedGraph}
                   />
                 ) : graphBlankShell ? (
@@ -932,7 +957,27 @@ export default function WorkflowSurface() {
                   />
                 </div>
               )}
-              {graphUiState === "populated" && !runSetupOpen && !addTarget && selectedNode && (
+              {graphUiState === "populated" && !runSetupOpen && !addTarget && selectedNode && swarmMode && selectedNode?.type === "thinAdapter" && (
+                <div className="dm-orchestration-sidecar__config-col">
+                  <div className="dm-workflow-panel-head">
+                    <button type="button" className="dm-workflow-icon-btn" onClick={() => setSelectedNodeId("")} aria-label="Close side panel">
+                      <X size={14} />
+                    </button>
+                    <span>Agent swarm</span>
+                    <em>agent-swarm-v1</em>
+                  </div>
+                  <AgentSwarmPanel
+                    graph={orchestrationGraph}
+                    disabled={false}
+                    onGraphChange={(updater) => {
+                      setOrchestrationGraph((g) => (typeof updater === "function" ? updater(g) : updater));
+                      setDirty(true);
+                    }}
+                  />
+                  {graphError && <p className="dm-orchestration-config__error">{graphError}</p>}
+                </div>
+              )}
+              {graphUiState === "populated" && !runSetupOpen && !addTarget && selectedNode && !(swarmMode && selectedNode?.type === "thinAdapter") && (
                 <div className="dm-orchestration-sidecar__config-col">
                   <div className="dm-workflow-panel-head">
                     <button type="button" className="dm-workflow-icon-btn" onClick={() => setSelectedNodeId("")} aria-label="Close side panel">

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/app/workspace-builder.jsx

@@ -81,11 +81,24 @@ import { governedWorkspaceIntegrationCatalog } from "@/lib/domain/integrations";
 import { OBJECT_TYPE_PRESETS, listWorkspaceDataModelTables } from "@/lib/workspace-data-model";
 import {
   computeChartProjectionDebug,
-  computeChartValuesFromRows
+  computeChartValuesFromRows,
+  deriveWidgetDependencyContract
 } from "@/lib/workspace-chart-values";
+import { selectObjectFilterableFields, selectObjectSortableFields } from "@/lib/workspace-metadata-selectors";
 import { HelperSidecar } from "./data-model/components/HelperSidecar.jsx";
 import { WorkspaceRail } from "./workspace-rail.jsx";
 
+// Workspace Metadata Graph V1 — typed dependency contracts.
+// Used by sidecar dependency summaries; the existing chart hydration path
+// continues to compute values via `computeChartValuesFromRows`. These
+// selectors only describe the widget's typed contract — they never mutate
+// config or trigger network calls.
+const WORKSPACE_METADATA_SELECTORS = Object.freeze({
+  deriveWidgetDependencyContract,
+  selectObjectFilterableFields,
+  selectObjectSortableFields
+});
+
 const DEFAULT_CHART_TYPE = "bar-vertical";
 const DEFAULT_FILTER_OP = "and";
 const DEFAULT_FILTER_OPERATOR = "contains";