@growthub/cli 0.14.0 → 0.14.1

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/app/api/workspace/helper/apply/route.js

@@ -43,6 +43,17 @@ import {
 } from "@/lib/workspace-helper-apply";
 import { RESOLVER_PROPOSAL_TYPE, buildResolverProposal, validateResolverProposal } from "@/lib/workspace-resolver-proposal";
 import { writeResolverProposalFile } from "@/lib/server-resolver-write";
+import {
+  SWARM_PROPOSAL_TYPES,
+  SWARM_RUN_RESUME_PROPOSAL_TYPE,
+  SWARM_WORKFLOWS_OBJECT_ID,
+  validateSwarmRunProposal,
+  buildSandboxRowFromSwarmProposal,
+  deriveHelperWidgetCausationState,
+  upsertSwarmRunRow,
+  findSwarmRunRows,
+  summarizeSwarmRunProposal,
+} from "@/lib/workspace-swarm-proposal";
 
 const HELPER_APPLY_SOURCE_KEY = "helper:apply:receipts";
 
@@ -133,6 +144,65 @@ function normalizeApplyProposal(proposal, config, context = {}) {
   return normalizeDataModelObjectProposal(normalizeResolverProposal(proposal, config), config, context.integrationId);
 }
 
+/**
+ * Swarm lane (SWARM_RUN_CONTRACT_V1) — normalize a validated swarm proposal
+ * into the next workspace config plus an artifact target the sidecar cockpit
+ * can open. The model's intent payload is reduced through
+ * buildDefaultAgentSwarmGraph inside buildSandboxRowFromSwarmProposal — final
+ * graph JSON from the model is never trusted verbatim. Nothing executes here;
+ * runs stay behind POST /api/workspace/sandbox-run.
+ *
+ * Returns { ok, config, artifact, summary, error? }.
+ */
+function normalizeSwarmRunProposal(proposal, workspaceConfig) {
+  const validation = validateSwarmRunProposal(proposal);
+  if (!validation.ok) {
+    return { ok: false, config: workspaceConfig, artifact: null, summary: "", error: validation.error };
+  }
+
+  if (proposal.type === SWARM_RUN_RESUME_PROPOSAL_TYPE) {
+    const name = String(proposal.payload?.name || "").trim();
+    const matches = findSwarmRunRows(workspaceConfig, { name });
+    if (matches.length === 0) {
+      return {
+        ok: false,
+        config: workspaceConfig,
+        artifact: null,
+        summary: "",
+        error: `no governed swarm workflow named "${name}" to resume`,
+      };
+    }
+    // Resume is a governed pointer, not an execution: the receipt records the
+    // intent and the cockpit re-launches through sandbox-run.
+    return {
+      ok: true,
+      config: workspaceConfig,
+      artifact: { surface: "swarm-run", objectId: matches[0].objectId, name: matches[0].row.Name },
+      summary: summarizeSwarmRunProposal(proposal),
+    };
+  }
+
+  const helperState = deriveHelperWidgetCausationState(workspaceConfig);
+  if (!helperState.ready) {
+    return {
+      ok: false,
+      config: workspaceConfig,
+      artifact: null,
+      summary: "",
+      error: helperState.guidance,
+    };
+  }
+
+  const row = buildSandboxRowFromSwarmProposal(workspaceConfig, proposal);
+  const nextConfig = upsertSwarmRunRow(workspaceConfig, row);
+  return {
+    ok: true,
+    config: nextConfig,
+    artifact: { surface: "swarm-run", objectId: SWARM_WORKFLOWS_OBJECT_ID, name: row.Name },
+    summary: summarizeSwarmRunProposal(proposal),
+  };
+}
+
 async function POST(request) {
   let body;
   try {
@@ -177,7 +247,10 @@ async function POST(request) {
     normalizeApplyProposal(proposal, currentConfig, { integrationId: fallbackIntegrationId })
   );
   const resolverProposals = normalizedProposals.filter((p) => p?.type === RESOLVER_PROPOSAL_TYPE);
-  const configProposals = normalizedProposals.filter((p) => p?.type !== RESOLVER_PROPOSAL_TYPE);
+  const swarmProposals = normalizedProposals.filter((p) => SWARM_PROPOSAL_TYPES.includes(p?.type));
+  const configProposals = normalizedProposals.filter(
+    (p) => p?.type !== RESOLVER_PROPOSAL_TYPE && !SWARM_PROPOSAL_TYPES.includes(p?.type)
+  );
 
   for (const proposal of resolverProposals) {
     const validation = validateResolverProposal(proposal);
@@ -201,6 +274,23 @@ async function POST(request) {
     }
   }
 
+  // Swarm lane — governed sandbox-environment rows in the EXISTING dataModel
+  // patch field. Apply creates/updates the row; execution stays behind
+  // POST /api/workspace/sandbox-run, launched explicitly from the cockpit.
+  for (const proposal of swarmProposals) {
+    const result = normalizeSwarmRunProposal(proposal, workingConfig);
+    if (!result.ok) {
+      skipped.push({ proposal, reason: result.error || "invalid swarm proposal" });
+      continue;
+    }
+    workingConfig = result.config;
+    applied.push({
+      ...buildApplyReceipt({ ...proposal, affectedField: "dataModel" }, appliedAt, reviewedBy, sessionId),
+      artifact: result.artifact,
+      summary: result.summary,
+    });
+  }
+
   for (const proposal of configProposals) {
     if (
       !proposal ||
@@ -238,7 +328,11 @@ async function POST(request) {
   // refreshes in the same atomic write as the proposed mutations).
   // resolver.create writes a server file (affectedField "server-file"), so it
   // must NOT contribute a field to the config PATCH — exclude it here.
-  const mutatingApplied = applied.filter((r) => r.type !== "explain.object" && r.affectedField !== "server-file");
+  // swarm.run.resume is a governed pointer (no config mutation) — exclude it
+  // alongside explain.object so it never forces a config write on its own.
+  const mutatingApplied = applied.filter(
+    (r) => r.type !== "explain.object" && r.type !== SWARM_RUN_RESUME_PROPOSAL_TYPE && r.affectedField !== "server-file"
+  );
 
   // Upsert the thread row so audit history reflects this apply turn even
   // when nothing mutated (all skipped / explain-only) and even when the
@@ -308,6 +402,9 @@ async function POST(request) {
         "dataModel.row.add": "create_object",
         "repair.binding": "repair",
         "explain.object": "explain",
+        "swarm.run.propose": "swarm",
+        "swarm.workflow.save": "swarm",
+        "swarm.run.resume": "swarm",
       };
       const proposalIntent = firstProposal?.type ? TYPE_TO_INTENT_HINT[firstProposal.type] : null;
       const safeIntent = existingRow.intent || proposalIntent || "explain";

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/app/api/workspace/helper/query/route.js

@@ -70,6 +70,7 @@ const VALID_INTENTS = [
   "edit_view",
   "repair",
   "explain",
+  "swarm",
 ];
 
 const HELPER_SOURCE_KEY_PREFIX = "helper";

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/app/api/workspace/sandbox-run/route.js

@@ -338,6 +338,8 @@ async function runServerlessScheduler({
 function buildRunResponse({
   runId,
   ranAt,
+  objectId,
+  name,
   runLocality,
   schedulerRegistryId,
   runtime,
@@ -359,6 +361,10 @@ function buildRunResponse({
   const base = {
     runId,
     ranAt,
+    // Identity travels with the persisted record so run-console consumers
+    // (lineage, swarm projection title) don't depend on the row context.
+    objectId: objectId ? String(objectId).trim() : undefined,
+    name: name ? String(name).trim() : undefined,
     runLocality,
     schedulerRegistryId: schedulerRegistryId ? String(schedulerRegistryId).trim() : null,
     runtime,
@@ -439,14 +445,7 @@ async function GET(request) {
   });
 }
 
-async function POST(request) {
-  let body;
-  try {
-    body = await request.json();
-  } catch {
-    return NextResponse.json({ ok: false, error: "invalid JSON body" }, { status: 400 });
-  }
-
+async function executeSandboxRun(body, { emit } = {}) {
   const objectId = typeof body?.objectId === "string" ? body.objectId.trim() : "";
   const name = typeof body?.name === "string" ? body.name.trim() : "";
   const useDraft = body?.useDraft === true;
@@ -580,7 +579,8 @@ async function POST(request) {
         instructions,
         command,
         timeoutMs,
-        sandboxName: rowForRun.Name || name
+        sandboxName: rowForRun.Name || name,
+        onEvent: emit
       }
     });
     if (graphResult !== null) {
@@ -665,6 +665,8 @@ async function POST(request) {
   const response = buildRunResponse({
     runId,
     ranAt,
+    objectId,
+    name: rowForRun.Name || name,
     runLocality,
     schedulerRegistryId: runLocality === "serverless" ? schedulerRegistryId : null,
     runtime,
@@ -754,4 +756,63 @@ async function POST(request) {
   });
 }
 
+async function POST(request) {
+  const accept = request.headers.get("accept") || "";
+  let body;
+  try {
+    body = await request.json();
+  } catch {
+    return NextResponse.json({ ok: false, error: "invalid JSON body" }, { status: 400 });
+  }
+
+  const wantsStream = body?.stream === true || accept.includes("application/x-ndjson");
+  if (!wantsStream) {
+    return executeSandboxRun(body);
+  }
+
+  const encoder = new TextEncoder();
+  const stream = new ReadableStream({
+    start(controller) {
+      const emit = (event) => {
+        controller.enqueue(encoder.encode(`${JSON.stringify(event)}\n`));
+      };
+      emit({
+        kind: "growthub-sandbox-run-delta-v1",
+        type: "sandbox-run.accepted",
+        emittedAt: new Date().toISOString(),
+        objectId: typeof body?.objectId === "string" ? body.objectId.trim() : "",
+        name: typeof body?.name === "string" ? body.name.trim() : ""
+      });
+      executeSandboxRun(body, { emit })
+        .then(async (response) => {
+          const finalPayload = await response.json().catch(() => ({ ok: false, error: "stream final payload unreadable" }));
+          emit({
+            kind: "growthub-sandbox-run-delta-v1",
+            type: "sandbox-run.final",
+            emittedAt: new Date().toISOString(),
+            status: response.status,
+            payload: finalPayload
+          });
+        })
+        .catch((error) => {
+          emit({
+            kind: "growthub-sandbox-run-delta-v1",
+            type: "sandbox-run.final",
+            emittedAt: new Date().toISOString(),
+            status: 500,
+            payload: { ok: false, error: error?.message || "sandbox run failed" }
+          });
+        })
+        .finally(() => controller.close());
+    }
+  });
+
+  return new Response(stream, {
+    headers: {
+      "content-type": "application/x-ndjson; charset=utf-8",
+      "cache-control": "no-store"
+    }
+  });
+}
+
 export { GET, POST };

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

@@ -14,7 +14,7 @@ const HELPER_AGENT_CHOICES = [
   { id: "gemini_local", label: "Gemini CLI (local)", body: "Uses Gemini CLI." },
   { id: "opencode_local", label: "OpenCode (local)", body: "Uses OpenCode on this machine." },
   { id: "pi_local", label: "Pi (local)", body: "Uses Pi on this machine." },
-  { id: "qwen_code_local", label: "Qwen Code (local)", body: "Uses Qwen Code on this machine." },
+  { id: "qwen_local", label: "Qwen Code (local)", body: "Uses Qwen Code on this machine." },
 ];
 
 const HELPER_EXECUTION_ADAPTERS = [

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

@@ -1,7 +1,7 @@
 "use client";
 
 import { useMemo } from "react";
-import { Plus, Trash2 } from "lucide-react";
+import { Check, Plus, Trash2 } from "lucide-react";
 import { HOST_AUTH_CATALOG } from "@/lib/sandbox-agent-host-catalog";
 
 function getHostOptions() {
@@ -11,31 +11,63 @@ function getHostOptions() {
   }));
 }
 
-function patchOrchestrator(graph, patch) {
+function nodeSandboxRecordRef(objectId, rowName, nodeId) {
+  return {
+    objectId: String(objectId || "").trim(),
+    rowName: String(rowName || "").trim(),
+    nodeId: String(nodeId || "").trim()
+  };
+}
+
+function withRecordRef(patch, objectId, rowName, nodeId) {
+  return {
+    ...patch,
+    sandboxRecordRef: nodeSandboxRecordRef(objectId, rowName, nodeId)
+  };
+}
+
+function WorkflowCheckbox({ checked, disabled, onChange, children, title }) {
+  return (
+    <label className="dm-orchestration-config__field dm-orchestration-config__field-inline dm-workflow-check" title={title}>
+      <input
+        type="checkbox"
+        checked={checked}
+        disabled={disabled}
+        onChange={(event) => onChange?.(event.target.checked)}
+      />
+      <span className="dm-workflow-check__box" aria-hidden="true">
+        {checked ? <Check size={13} strokeWidth={2.4} /> : null}
+      </span>
+      <span>{children}</span>
+    </label>
+  );
+}
+
+function patchOrchestrator(graph, patch, objectId, rowName) {
   const nodes = Array.isArray(graph?.nodes) ? graph.nodes : [];
   return {
     ...graph,
     nodes: nodes.map((node) =>
       node?.type === "thinAdapter"
-        ? { ...node, config: { ...(node.config || {}), ...patch } }
+        ? { ...node, config: { ...(node.config || {}), ...withRecordRef(patch, objectId, rowName, node.id) } }
         : node
     )
   };
 }
 
-function patchSynthesis(graph, patch) {
+function patchSynthesis(graph, patch, objectId, rowName) {
   const nodes = Array.isArray(graph?.nodes) ? graph.nodes : [];
   return {
     ...graph,
     nodes: nodes.map((node) =>
       node?.type === "tool-result"
-        ? { ...node, config: { ...(node.config || {}), ...patch } }
+        ? { ...node, config: { ...(node.config || {}), ...withRecordRef(patch, objectId, rowName, node.id) } }
         : node
     )
   };
 }
 
-function patchSubagent(graph, nodeId, patch) {
+function patchSubagent(graph, nodeId, patch, objectId, rowName) {
   const nodes = Array.isArray(graph?.nodes) ? graph.nodes : [];
   return {
     ...graph,
@@ -44,7 +76,7 @@ function patchSubagent(graph, nodeId, patch) {
         ? {
             ...node,
             label: patch.role != null ? String(patch.role) : node.label,
-            config: { ...(node.config || {}), ...patch }
+            config: { ...(node.config || {}), ...withRecordRef(patch, objectId, rowName, node.id) }
           }
         : node
     )
@@ -107,7 +139,7 @@ function patchSwarmConfig(graph, patch) {
   return { ...graph, swarm: { ...base, ...patch } };
 }
 
-export function AgentSwarmPanel({ graph, onGraphChange, disabled }) {
+export function AgentSwarmPanel({ graph, objectId, rowName, onGraphChange, disabled }) {
   const hostOptions = useMemo(getHostOptions, []);
   if (!graph || typeof graph !== "object") return null;
 
@@ -133,7 +165,7 @@ export function AgentSwarmPanel({ graph, onGraphChange, disabled }) {
               rows={3}
               value={orchestrator?.config?.prompt || ""}
               disabled={disabled || !orchestrator}
-              onChange={(e) => patchGraph((g) => patchOrchestrator(g, { prompt: e.target.value }))}
+              onChange={(e) => patchGraph((g) => patchOrchestrator(g, { prompt: e.target.value }, objectId, rowName))}
             />
           </label>
         </div>
@@ -163,7 +195,7 @@ export function AgentSwarmPanel({ graph, onGraphChange, disabled }) {
                     placeholder="Role"
                     value={cfg.role || node.label || ""}
                     disabled={disabled}
-                    onChange={(e) => patchGraph((g) => patchSubagent(g, node.id, { role: e.target.value }))}
+                    onChange={(e) => patchGraph((g) => patchSubagent(g, node.id, { role: e.target.value }, objectId, rowName))}
                   />
                   <button
                     type="button"
@@ -181,7 +213,7 @@ export function AgentSwarmPanel({ graph, onGraphChange, disabled }) {
                     placeholder="One-sentence charter"
                     value={cfg.description || ""}
                     disabled={disabled}
-                    onChange={(e) => patchGraph((g) => patchSubagent(g, node.id, { description: e.target.value }))}
+                    onChange={(e) => patchGraph((g) => patchSubagent(g, node.id, { description: e.target.value }, objectId, rowName))}
                   />
                 </label>
                 <label className="dm-orchestration-config__field">
@@ -190,7 +222,7 @@ export function AgentSwarmPanel({ graph, onGraphChange, disabled }) {
                     rows={2}
                     value={cfg.taskPrompt || ""}
                     disabled={disabled}
-                    onChange={(e) => patchGraph((g) => patchSubagent(g, node.id, { taskPrompt: e.target.value }))}
+                    onChange={(e) => patchGraph((g) => patchSubagent(g, node.id, { taskPrompt: e.target.value }, objectId, rowName))}
                   />
                 </label>
                 <label className="dm-orchestration-config__field">
@@ -201,7 +233,7 @@ export function AgentSwarmPanel({ graph, onGraphChange, disabled }) {
                     disabled={disabled}
                     onChange={(e) => patchGraph((g) => patchSubagent(g, node.id, {
                       tools: e.target.value.split(",").map((t) => t.trim()).filter(Boolean)
-                    }))}
+                    }, objectId, rowName))}
                   />
                 </label>
                 <label className="dm-orchestration-config__field">
@@ -212,7 +244,7 @@ export function AgentSwarmPanel({ graph, onGraphChange, disabled }) {
                     placeholder="0 = inherit"
                     value={cfg.maxTokens || 0}
                     disabled={disabled}
-                    onChange={(e) => patchGraph((g) => patchSubagent(g, node.id, { maxTokens: Math.max(0, Number(e.target.value) || 0) }))}
+                    onChange={(e) => patchGraph((g) => patchSubagent(g, node.id, { maxTokens: Math.max(0, Number(e.target.value) || 0) }, objectId, rowName))}
                   />
                 </label>
                 <label className="dm-orchestration-config__field">
@@ -220,7 +252,7 @@ export function AgentSwarmPanel({ graph, onGraphChange, disabled }) {
                   <select
                     value={cfg.agentHost || ""}
                     disabled={disabled}
-                    onChange={(e) => patchGraph((g) => patchSubagent(g, node.id, { agentHost: e.target.value }))}
+                    onChange={(e) => patchGraph((g) => patchSubagent(g, node.id, { agentHost: e.target.value }, objectId, rowName))}
                   >
                     <option value="">Inherit</option>
                     {hostOptions.map((opt) => (
@@ -228,27 +260,21 @@ export function AgentSwarmPanel({ graph, onGraphChange, disabled }) {
                     ))}
                   </select>
                 </label>
-                <label className="dm-orchestration-config__field dm-orchestration-config__field-inline">
-                  <input
-                    type="checkbox"
-                    checked={cfg.required !== false}
-                    disabled={disabled}
-                    onChange={(e) => patchGraph((g) => patchSubagent(g, node.id, { required: e.target.checked }))}
-                  />
-                  <span>Required</span>
-                </label>
-                <label
-                  className="dm-orchestration-config__field dm-orchestration-config__field-inline"
+                <WorkflowCheckbox
+                  checked={cfg.required !== false}
+                  disabled={disabled}
+                  onChange={(checked) => patchGraph((g) => patchSubagent(g, node.id, { required: checked }, objectId, rowName))}
+                >
+                  Required
+                </WorkflowCheckbox>
+                <WorkflowCheckbox
+                  checked={cfg.networkAccess === true}
+                  disabled={disabled}
                   title="Network is granted only when both this and the row's networkAllow are on."
+                  onChange={(checked) => patchGraph((g) => patchSubagent(g, node.id, { networkAccess: checked }, objectId, rowName))}
                 >
-                  <input
-                    type="checkbox"
-                    checked={cfg.networkAccess === true}
-                    disabled={disabled}
-                    onChange={(e) => patchGraph((g) => patchSubagent(g, node.id, { networkAccess: e.target.checked }))}
-                  />
-                  <span>Network</span>
-                </label>
+                  Network
+                </WorkflowCheckbox>
               </div>
             );
           })}
@@ -315,7 +341,7 @@ export function AgentSwarmPanel({ graph, onGraphChange, disabled }) {
                 rows={2}
                 value={synthesis?.config?.outcomePrompt || ""}
                 disabled={disabled}
-                onChange={(e) => patchGraph((g) => patchSynthesis(g, { outcomePrompt: e.target.value }))}
+                onChange={(e) => patchGraph((g) => patchSynthesis(g, { outcomePrompt: e.target.value }, objectId, rowName))}
               />
             </label>
           </div>

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

@@ -42,6 +42,7 @@ import {
   Trash2,
   Type,
   Unlock,
+  Upload,
   Users,
   X,
   Zap,
@@ -1843,7 +1844,9 @@ function DataModelRecordDrawer({
         <header className="dm-record-drawer-head">
           <div>
             <p>Record</p>
-            <h2>{draft.Name || draft.integrationId || draft.id || `Row ${rowIndex + 1}`}</h2>
+            <h2 title={draft.Name || draft.integrationId || draft.id || `Row ${rowIndex + 1}`}>
+              {draft.Name || draft.integrationId || draft.id || `Row ${rowIndex + 1}`}
+            </h2>
           </div>
           <div className="dm-record-drawer-actions">
             {isSandbox && sidecarMode !== "graph" && sidecarMode !== "trace" && (
@@ -1854,7 +1857,7 @@ function DataModelRecordDrawer({
                 onClick={runSandbox}
               >
                 <Play size={13} aria-hidden />
-                {sandboxRunning ? "Running…" : "Run sandbox"}
+                {sandboxRunning ? "Running…" : "Execute"}
               </button>
             )}
             {!isSandbox && sandboxToolFlow !== "draft" && (
@@ -2457,9 +2460,9 @@ function DataModelTableSurface({
               const a = document.createElement("a");
               a.href = url; a.download = `${table.source.replace(/\s+/g, "-").toLowerCase()}.csv`;
               a.click(); URL.revokeObjectURL(url);
-            }}>Export CSV</button>
+            }}><Download size={13} />Export CSV</button>
           )}
-          {table.mutable && <button type="button" className="dm-btn-ghost" onClick={() => setCsvOpen((open) => !open)}>Import CSV</button>}
+          {table.mutable && <button type="button" className="dm-btn-ghost" onClick={() => setCsvOpen((open) => !open)}><Upload size={13} />Import CSV</button>}
           {table.mutable && (
             <button type="button" className="dm-btn-primary-sm" disabled={saving} onClick={() => onSave((config) => addTableRow(config, table))}>
               <Plus size={13} />Add record
@@ -3544,6 +3547,17 @@ export default function DataModelShell() {
               router.push(`/?dashboard=${encodeURIComponent(target.dashboardId)}`);
             }
           }}
+          onOpenSwarmWorkflow={(target) => {
+            const objectId = String(target?.objectId || "").trim();
+            const rowName = String(target?.name || "").trim();
+            if (!objectId || !rowName) return;
+            const params = new URLSearchParams({
+              object: objectId,
+              row: rowName,
+              field: "orchestrationGraph"
+            });
+            router.push(`/workflows?${params.toString()}`);
+          }}
           onApplied={(updatedConfig) => {
             // Anchor the user on the most recently created/updated Data Model
             // object so a helper-driven object.create lands on the surface