@growthub/cli 0.13.2 → 0.13.5

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

@@ -0,0 +1,261 @@
+"use client";
+
+import { useMemo, useState } from "react";
+import { Play, X } from "lucide-react";
+import { RUN_INPUTS_KIND } from "@/lib/orchestration-run-inputs";
+
+/**
+ * RunSetupPanel — sidecar surface for collecting manual run inputs before a
+ * workflow execution. Mounted by WorkflowSurface only when the active
+ * orchestration graph declares a `human-input` / form node with required
+ * fields. For workflows with no manual inputs, this panel never renders.
+ *
+ * Invariants:
+ *   - UI-only validation. The server validates again before persisting.
+ *   - No secret values are accepted. Fields typed `secretRef` collect only
+ *     the ref slug. Secret-looking keys (api_key, token, password, etc.)
+ *     are coerced to secretRef on the server.
+ *   - The panel reuses .dm-workflow-panel-head, .dm-orchestration-config*,
+ *     .dm-btn-outline, .dm-workflow-chip-btn. No new design system.
+ */
+export function RunSetupPanel({ schema, running, onSubmit, onCancel }) {
+  const fields = Array.isArray(schema?.fields) ? schema.fields : [];
+  const [values, setValues] = useState(() => seedValues(fields));
+  const [touched, setTouched] = useState({});
+
+  const missing = useMemo(
+    () => fields.filter((f) => f.required && !hasValue(values[f.id], f)).map((f) => f.id),
+    [fields, values]
+  );
+
+  function patch(fieldId, raw) {
+    setValues((current) => ({ ...current, [fieldId]: raw }));
+  }
+
+  function markTouched(fieldId) {
+    setTouched((current) => ({ ...current, [fieldId]: true }));
+  }
+
+  function submit() {
+    if (missing.length > 0) {
+      const next = {};
+      for (const id of missing) next[id] = true;
+      setTouched((current) => ({ ...current, ...next }));
+      return;
+    }
+    const envelope = {
+      kind: RUN_INPUTS_KIND,
+      source: "manual",
+      values: Object.fromEntries(
+        fields
+          .map((field) => [field.id, normalizeForSubmission(field, values[field.id])])
+          .filter(([, value]) => value !== undefined)
+      ),
+      files: []
+    };
+    onSubmit?.(envelope);
+  }
+
+  if (!schema?.requiresInput || fields.length === 0) {
+    return (
+      <div className="dm-run-setup">
+        <p className="dm-run-setup__hint">This workflow has no manual inputs configured.</p>
+        <div className="dm-run-setup__actions">
+          <button type="button" className="dm-btn-outline" onClick={onCancel}>Close</button>
+        </div>
+      </div>
+    );
+  }
+
+  return (
+    <div className="dm-run-setup">
+      {schema.instructions ? (
+        <p className="dm-run-setup__instructions">{schema.instructions}</p>
+      ) : null}
+
+      <div className="dm-run-setup__fields">
+        {fields.map((field) => (
+          <RunSetupField
+            key={field.id}
+            field={field}
+            value={values[field.id]}
+            touched={Boolean(touched[field.id])}
+            onChange={(raw) => patch(field.id, raw)}
+            onBlur={() => markTouched(field.id)}
+          />
+        ))}
+      </div>
+
+      <div className="dm-run-setup__notice">
+        Inputs are validated server-side before the run. Secret-typed fields collect a ref slug only — never a raw value.
+      </div>
+
+      <div className="dm-run-setup__actions">
+        <button type="button" className="dm-btn-outline" onClick={onCancel} disabled={running}>
+          <X size={13} aria-hidden="true" /> Cancel
+        </button>
+        <button
+          type="button"
+          className="dm-workflow-chip-btn"
+          onClick={submit}
+          disabled={running || missing.length > 0}
+          title={missing.length > 0 ? `Fill required fields: ${missing.join(", ")}` : "Run workflow with these inputs"}
+        >
+          <Play size={13} aria-hidden="true" /> {running ? "Running" : "Run workflow"}
+        </button>
+      </div>
+    </div>
+  );
+}
+
+function RunSetupField({ field, value, touched, onChange, onBlur }) {
+  const showError = touched && field.required && !hasValue(value, field);
+  const inputId = `dm-run-setup-${field.id}`;
+  const help = field.helpText || (field.type === "secretRef" ? "Reference slug only — server resolves the secret." : "");
+
+  return (
+    <label className="dm-orchestration-config__field" htmlFor={inputId}>
+      <span>
+        {field.label}
+        {field.required ? <em aria-hidden="true" className="dm-run-setup__required"> *</em> : null}
+      </span>
+      {renderInput(field, value, onChange, onBlur, inputId)}
+      {help ? <small className="dm-run-setup__help">{help}</small> : null}
+      {showError ? <small className="dm-run-setup__error">Required.</small> : null}
+    </label>
+  );
+}
+
+function renderInput(field, value, onChange, onBlur, inputId) {
+  const safeValue = value == null ? "" : value;
+  switch (field.type) {
+    case "textarea":
+    case "json":
+      return (
+        <textarea
+          id={inputId}
+          rows={field.type === "json" ? 6 : 4}
+          value={typeof safeValue === "string" ? safeValue : JSON.stringify(safeValue, null, 2)}
+          onChange={(e) => onChange(e.target.value)}
+          onBlur={onBlur}
+          placeholder={field.type === "json" ? "{ }" : ""}
+        />
+      );
+    case "boolean":
+    case "checkbox":
+      return (
+        <span className="dm-run-setup__checkbox">
+          <input
+            id={inputId}
+            type="checkbox"
+            checked={Boolean(safeValue)}
+            onChange={(e) => onChange(e.target.checked)}
+            onBlur={onBlur}
+          />
+          <span>{field.helpText || "Enable"}</span>
+        </span>
+      );
+    case "number":
+    case "integer":
+      return (
+        <input
+          id={inputId}
+          type="number"
+          value={safeValue === "" ? "" : safeValue}
+          onChange={(e) => onChange(e.target.value)}
+          onBlur={onBlur}
+        />
+      );
+    case "email":
+      return (
+        <input
+          id={inputId}
+          type="email"
+          value={safeValue}
+          onChange={(e) => onChange(e.target.value)}
+          onBlur={onBlur}
+          placeholder="name@example.com"
+        />
+      );
+    case "url":
+      return (
+        <input
+          id={inputId}
+          type="url"
+          value={safeValue}
+          onChange={(e) => onChange(e.target.value)}
+          onBlur={onBlur}
+          placeholder="https://"
+        />
+      );
+    case "secretRef":
+      return (
+        <input
+          id={inputId}
+          type="text"
+          value={safeValue}
+          onChange={(e) => onChange(e.target.value)}
+          onBlur={onBlur}
+          placeholder="ENV_REF_SLUG"
+          autoComplete="off"
+        />
+      );
+    default:
+      return (
+        <input
+          id={inputId}
+          type="text"
+          value={safeValue}
+          onChange={(e) => onChange(e.target.value)}
+          onBlur={onBlur}
+        />
+      );
+  }
+}
+
+function seedValues(fields) {
+  const out = {};
+  for (const field of fields) {
+    if (field.type === "boolean" || field.type === "checkbox") out[field.id] = false;
+    else out[field.id] = "";
+  }
+  return out;
+}
+
+function hasValue(value, field) {
+  if (field?.type === "boolean" || field?.type === "checkbox") return value === true;
+  if (value == null) return false;
+  if (typeof value === "string") return value.trim().length > 0;
+  if (typeof value === "number") return Number.isFinite(value);
+  return Boolean(value);
+}
+
+function normalizeForSubmission(field, value) {
+  if (field.type === "boolean" || field.type === "checkbox") return Boolean(value);
+  if (field.type === "secretRef") {
+    const text = typeof value === "string" ? value.trim() : "";
+    return text ? { secretRef: text } : undefined;
+  }
+  if (field.type === "number" || field.type === "integer") {
+    if (value === "" || value == null) return undefined;
+    const num = Number(value);
+    return Number.isFinite(num) ? num : undefined;
+  }
+  if (field.type === "json") {
+    if (typeof value === "string") {
+      const trimmed = value.trim();
+      if (!trimmed) return undefined;
+      try {
+        return JSON.parse(trimmed);
+      } catch {
+        return trimmed;
+      }
+    }
+    return value;
+  }
+  if (typeof value === "string") {
+    const text = value.trim();
+    return text ? text : undefined;
+  }
+  return value;
+}

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,6 +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 { 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);
@@ -328,6 +343,7 @@ export default function WorkflowSurface() {
   const [graphError, setGraphError] = useState("");
   const [orchestrationGraph, setOrchestrationGraph] = useState(null);
   const [dirty, setDirty] = useState(false);
+  const [runSetupOpen, setRunSetupOpen] = useState(false);
 
   const load = useCallback(async () => {
     setLoading(true);
@@ -379,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(() => {
@@ -446,6 +463,21 @@ export default function WorkflowSurface() {
     }
   }
 
+  async function patchSandboxRuntimeFields(fields) {
+    if (resolved.rowIndex < 0 || !objectId || !fields || typeof fields !== "object") return;
+    setSaving(true);
+    setSaveMessage("");
+    try {
+      const next = patchSandboxRowInConfig(workspaceConfig, objectId, resolved.rowIndex, fields);
+      await persistWorkspace(next);
+      setSaveMessage("Updated workflow runtime settings.");
+    } catch (err) {
+      setSaveMessage(err.message || "Runtime update failed");
+    } finally {
+      setSaving(false);
+    }
+  }
+
   async function publishGraph() {
     if (resolved.rowIndex < 0 || !objectId) return;
     const serialized = serializeCurrentGraph();
@@ -536,17 +568,27 @@ export default function WorkflowSurface() {
     }
   }
 
-  async function runSandbox() {
+  const runInputSchema = useMemo(
+    () => discoverRunInputSchema(orchestrationGraph),
+    [orchestrationGraph]
+  );
+
+  async function runSandbox(options = {}) {
     if (!objectId || !rowId) return;
+    const runInputs = options && typeof options === "object" && options.runInputs && typeof options.runInputs === "object"
+      ? options.runInputs
+      : null;
     setRunning(true);
     setRunMessage("");
     try {
       const draft = await saveDraft({ orchestrationDraftStatus: "testing" });
       const draftGraph = draft?.serialized || serializeCurrentGraph();
+      const body = { objectId, name: rowId, useDraft: true, draftGraph };
+      if (runInputs) body.runInputs = runInputs;
       const res = await fetch("/api/workspace/sandbox-run", {
         method: "POST",
         headers: { "content-type": "application/json" },
-        body: JSON.stringify({ objectId, name: rowId, useDraft: true, draftGraph }),
+        body: JSON.stringify(body),
       });
       const payload = await res.json();
       const responseText = redactSecretsFromText(JSON.stringify(payload.response ?? payload, null, 2));
@@ -586,6 +628,21 @@ export default function WorkflowSurface() {
     setSidecarMode("trace");
   }
 
+  function handleTestClick() {
+    if (runInputSchema.requiresInput) {
+      setRunSetupOpen(true);
+      setSelectedNodeId("");
+      setAddTarget(null);
+      return;
+    }
+    runSandbox();
+  }
+
+  async function handleRunWithInputs(runInputs) {
+    setRunSetupOpen(false);
+    await runSandbox({ runInputs });
+  }
+
   function openGraphMode() {
     const params = new URLSearchParams(searchParams.toString());
     params.delete("run");
@@ -606,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) {
@@ -759,8 +826,8 @@ export default function WorkflowSurface() {
               </button>
             )}
             {canTest && (
-              <button type="button" className="dm-workflow-chip-btn" disabled={running || saving || publishing} onClick={runSandbox}>
-              <Play size={13} /> {running ? "Running" : "Test"}
+              <button type="button" className="dm-workflow-chip-btn" disabled={running || saving || publishing} onClick={handleTestClick}>
+              <Play size={13} /> {running ? "Running" : runInputSchema.requiresInput ? "Test with inputs" : "Test"}
               </button>
             )}
             {showPublish && (
@@ -816,9 +883,11 @@ export default function WorkflowSurface() {
             selectedRunId={runId}
             onBack={openGraphMode}
             onOpenGraph={openGraphMode}
+            onReplay={runSandbox}
+            running={running}
           />
         ) : (
-          <div className={`dm-orchestration-sidecar dm-workflow-orchestration${selectedNode || addTarget ? " has-panel" : ""}`}>
+          <div className={`dm-orchestration-sidecar dm-workflow-orchestration${selectedNode || addTarget || runSetupOpen ? " has-panel" : ""}`}>
             <div className="dm-orchestration-sidecar__body">
               <div className="dm-orchestration-sidecar__canvas-col">
                 {graphUnset ? (
@@ -826,6 +895,7 @@ export default function WorkflowSurface() {
                     disabled={false}
                     onStartFromRegistry={registryRow ? startFromRegistry : undefined}
                     onStartBlank={startBlank}
+                    onStartAgentSwarm={startAgentSwarm}
                     onPasteGraph={applyPastedGraph}
                   />
                 ) : graphBlankShell ? (
@@ -855,7 +925,24 @@ export default function WorkflowSurface() {
                   </>
                 )}
               </div>
-              {graphUiState === "populated" && addTarget && (
+              {graphUiState === "populated" && runSetupOpen && (
+                <div className="dm-orchestration-sidecar__config-col">
+                  <div className="dm-workflow-panel-head">
+                    <button type="button" className="dm-workflow-icon-btn" onClick={() => setRunSetupOpen(false)} aria-label="Close run setup panel">
+                      <X size={14} />
+                    </button>
+                    <span>Run setup</span>
+                    <em>Manual inputs</em>
+                  </div>
+                  <RunSetupPanel
+                    schema={runInputSchema}
+                    running={running}
+                    onSubmit={handleRunWithInputs}
+                    onCancel={() => setRunSetupOpen(false)}
+                  />
+                </div>
+              )}
+              {graphUiState === "populated" && !runSetupOpen && addTarget && (
                 <div className="dm-orchestration-sidecar__config-col">
                   <div className="dm-workflow-panel-head">
                     <button type="button" className="dm-workflow-icon-btn" onClick={() => setAddTarget(null)} aria-label="Close side panel">
@@ -870,7 +957,27 @@ export default function WorkflowSurface() {
                   />
                 </div>
               )}
-              {graphUiState === "populated" && !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">
@@ -884,6 +991,9 @@ export default function WorkflowSurface() {
                     registryRow={registryRow}
                     workspaceConfig={workspaceConfig}
                     sandboxRow={sandboxRow}
+                    objectId={objectId}
+                    rowName={rowId}
+                    onSandboxRowPatch={patchSandboxRuntimeFields}
                     onDeleteNode={deleteSelectedNode}
                     disabled={false}
                     activeTab={configTab}