@growthub/cli 0.14.0 → 0.14.2

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/lib/orchestration-agent-swarm.js

@@ -63,6 +63,44 @@ const MAX_SUBAGENT_OUTPUT_FOR_SYNTH = 4096;
 const PROMPT_CAPABLE_ADAPTERS = new Set(["local-agent-host", "local-intelligence"]);
 const OUTCOME_SCORE_RE = /OUTCOME_SCORE\s*[:=]\s*([01](?:\.\d+)?|\.\d+)/i;
 
+function cleanEventString(value) {
+  return redactSecretsFromText(String(value ?? "").trim());
+}
+
+function emitSwarmDelta(executionContext, payload) {
+  const emit = executionContext?.onEvent;
+  if (typeof emit !== "function") return;
+  try {
+    emit({
+      kind: "growthub-sandbox-run-delta-v1",
+      emittedAt: new Date().toISOString(),
+      runId: executionContext.runId || "",
+      ...payload
+    });
+  } catch {
+    // Observability is best-effort; execution must not fail because the
+    // browser disconnected or a cosmetic stream consumer rejected an event.
+  }
+}
+
+function taskDeltaFromResult(task) {
+  return {
+    taskId: cleanEventString(task?.taskId || task?.nodeId || ""),
+    nodeId: cleanEventString(task?.nodeId || task?.taskId || ""),
+    role: cleanEventString(task?.role || "Subagent"),
+    phaseId: cleanEventString(task?.phaseId || "dispatch") || "dispatch",
+    status: cleanEventString(task?.status || "unknown") || "unknown",
+    adapter: cleanEventString(task?.adapter || ""),
+    agentHost: cleanEventString(task?.agentHost || ""),
+    durationMs: Number.isFinite(Number(task?.durationMs)) ? Number(task.durationMs) : 0,
+    tokens: task?.tokens ?? null,
+    tools: task?.tools ?? null,
+    startedAt: cleanEventString(task?.startedAt || ""),
+    endedAt: cleanEventString(task?.endedAt || ""),
+    error: cleanEventString(task?.error || "")
+  };
+}
+
 function clampPositiveInt(value, fallback) {
   const n = Number(value);
   if (!Number.isFinite(n) || n <= 0) return fallback;
@@ -114,6 +152,21 @@ function chooseAdapterIdForSubagent({ subagentConfig, fallbackAdapterId, fallbac
   };
 }
 
+/**
+ * Truthful telemetry extraction (SWARM_RUN_CONTRACT_V1). Tokens / tool counts
+ * come ONLY from the adapter's reported metadata — when the adapter does not
+ * report a number the value is null, never an estimate.
+ */
+function extractAdapterTelemetry(result) {
+  const meta = result?.adapterMeta && typeof result.adapterMeta === "object" ? result.adapterMeta : {};
+  const tokens = meta.tokens == null || meta.tokens === "" ? null : Number(meta.tokens);
+  const tools = meta.tools == null || meta.tools === "" ? null : Number(meta.tools);
+  return {
+    tokens: Number.isFinite(tokens) && tokens >= 0 ? tokens : null,
+    tools: Number.isFinite(tools) && tools >= 0 ? tools : null
+  };
+}
+
 function describeSubagent(node) {
   const cfg = node?.config || {};
   const role = String(cfg.role || node?.label || node?.id || "subagent").trim();
@@ -235,12 +288,14 @@ async function runThroughAdapter({
   timeoutMs,
   networkAllow,
   allowList,
+  browserAccess,
   env,
   envRefSlugs,
   envRefsMissing,
   runId,
   name,
-  ranAt
+  ranAt,
+  intelligence
 }) {
   const adapter = getSandboxAdapter(adapterId);
   if (!adapter) {
@@ -277,11 +332,25 @@ async function runThroughAdapter({
       timeoutMs,
       networkAllow,
       allowList,
+      browserAccess: browserAccess === true,
       env,
       envRefSlugs,
       envRefsMissing,
       workdir,
-      ranAt: ranAt || new Date(startedAt).toISOString()
+      ranAt: ranAt || new Date(startedAt).toISOString(),
+      // local-intelligence speaks the intelligenceSandbox envelope — the
+      // phase prompt travels as userIntent; model/endpoint settings come
+      // from the governed row (slugs/URLs only, never secret values).
+      ...(adapterId === "local-intelligence"
+        ? {
+            intelligenceSandbox: {
+              userIntent: command,
+              localModel: String(intelligence?.localModel || "").trim(),
+              localEndpoint: String(intelligence?.localEndpoint || "").trim(),
+              intelligenceAdapterMode: String(intelligence?.intelligenceAdapterMode || "ollama").trim() || "ollama"
+            }
+          }
+        : {})
     });
   } catch (error) {
     return {
@@ -324,6 +393,7 @@ async function runOrchestratorPhase({ orchestratorNode, subagents, inputPayload,
   const command = buildOrchestratorCommand({ orchestratorNode, subagents, inputPayload });
   const env = { ...(executionContext.env || {}), GROWTHUB_SWARM_PHASE: "orchestrator" };
   const startedAt = Date.now();
+  const startedAtIso = new Date(startedAt).toISOString();
   const result = await runThroughAdapter({
     adapterId: resolved.adapterId,
     agentHost: resolved.agentHost,
@@ -332,14 +402,17 @@ async function runOrchestratorPhase({ orchestratorNode, subagents, inputPayload,
     timeoutMs: clampPositiveInt(orchestratorNode?.config?.timeoutMs, DEFAULT_ORCHESTRATOR_TIMEOUT_MS),
     networkAllow: executionContext.networkAllow === true,
     allowList: executionContext.allowList || [],
+    browserAccess: executionContext.browserAccess === true,
     env,
     envRefSlugs: executionContext.envRefSlugs || [],
     envRefsMissing: executionContext.envRefsMissing || [],
+    intelligence: executionContext.intelligence,
     runId: `${executionContext.runId}_orchestrator`,
     name: `${executionContext.sandboxName || "swarm"}::orchestrator`
   });
   const stdout = redactSecretsFromText(result?.stdout || "");
   const errorText = redactSecretsFromText(result?.error || "");
+  const telemetry = extractAdapterTelemetry(result);
   return {
     status: result?.ok === true && !errorText ? "completed" : "failed",
     error: errorText,
@@ -349,6 +422,11 @@ async function runOrchestratorPhase({ orchestratorNode, subagents, inputPayload,
     output: stdout,
     stderr: redactSecretsFromText(result?.stderr || ""),
     plan: stdout,
+    tokens: telemetry.tokens,
+    tools: telemetry.tools,
+    startedAt: startedAtIso,
+    endedAt: new Date().toISOString(),
+    phaseId: "plan",
     adapterMeta: { ...(result?.adapterMeta || {}), swarmPhase: "orchestrator" }
   };
 }
@@ -364,6 +442,10 @@ async function dispatchSubagentTask({
   const required = subagentConfig.required !== false;
   const taskId = subagentNode?.id || `task-${taskIndex + 1}`;
   const role = String(subagentConfig.role || subagentNode?.label || "subagent");
+  // Author-named phase (config.phase / config.phaseId) travels onto the task
+  // so the record projection groups under the same phases the declared
+  // skeleton shows. Absent → "dispatch", exactly as before.
+  const phaseId = String(subagentConfig.phase || subagentConfig.phaseId || "").trim().toLowerCase() || "dispatch";
 
   const resolved = chooseAdapterIdForSubagent({
     subagentConfig,
@@ -371,6 +453,7 @@ async function dispatchSubagentTask({
     fallbackAgentHost: executionContext.agentHost
   });
   if (!resolved.adapterId || resolved.error) {
+    const gateAt = new Date().toISOString();
     return {
       taskId,
       nodeId: taskId,
@@ -383,6 +466,11 @@ async function dispatchSubagentTask({
       stdout: "",
       stderr: "",
       error: resolved.error || "no prompt-capable adapter resolved for subagent",
+      tokens: null,
+      tools: null,
+      startedAt: gateAt,
+      endedAt: gateAt,
+      phaseId,
       adapterMeta: { swarmSubagent: true, reason: "adapter-gate" }
     };
   }
@@ -403,15 +491,20 @@ async function dispatchSubagentTask({
     command,
     timeoutMs: clampPositiveInt(subagentConfig.timeoutMs, executionContext.timeoutMs || DEFAULT_SUBAGENT_TIMEOUT_MS),
     networkAllow: subagentConfig.networkAccess === true && executionContext.networkAllow === true,
+    // Browser is a superset of network: a subagent only inherits the row's
+    // browser access through the same node-level network gate.
+    browserAccess: subagentConfig.networkAccess === true && executionContext.browserAccess === true,
     allowList: executionContext.allowList || [],
     env,
     envRefSlugs: executionContext.envRefSlugs || [],
     envRefsMissing: executionContext.envRefsMissing || [],
+    intelligence: executionContext.intelligence,
     runId: `${executionContext.runId}_${taskId}`,
     name: `${executionContext.sandboxName || "swarm"}::${taskId}`
   });
   const errorText = redactSecretsFromText(result?.error || "");
   const ok = result?.ok === true && !errorText;
+  const telemetry = extractAdapterTelemetry(result);
   return {
     taskId,
     nodeId: taskId,
@@ -425,6 +518,11 @@ async function dispatchSubagentTask({
     stdout: redactSecretsFromText(result?.stdout || ""),
     stderr: redactSecretsFromText(result?.stderr || ""),
     error: errorText,
+    tokens: telemetry.tokens,
+    tools: telemetry.tools,
+    startedAt: new Date(startedAt).toISOString(),
+    endedAt: new Date().toISOString(),
+    phaseId,
     adapterMeta: { ...(result?.adapterMeta || {}), swarmSubagent: true }
   };
 }
@@ -467,6 +565,7 @@ async function runSynthesisPhase({ synthesisNode, swarmConfig, tasks, inputPaylo
   const command = buildSynthesisCommand({ synthesisNode, swarmConfig, tasks, inputPayload });
   const env = { ...(executionContext.env || {}), GROWTHUB_SWARM_PHASE: "synthesis" };
   const startedAt = Date.now();
+  const startedAtIso = new Date(startedAt).toISOString();
   const result = await runThroughAdapter({
     adapterId: resolved.adapterId,
     agentHost: resolved.agentHost,
@@ -475,9 +574,11 @@ async function runSynthesisPhase({ synthesisNode, swarmConfig, tasks, inputPaylo
     timeoutMs: clampPositiveInt(cfg.timeoutMs, DEFAULT_SYNTHESIS_TIMEOUT_MS),
     networkAllow: executionContext.networkAllow === true,
     allowList: executionContext.allowList || [],
+    browserAccess: executionContext.browserAccess === true,
     env,
     envRefSlugs: executionContext.envRefSlugs || [],
     envRefsMissing: executionContext.envRefsMissing || [],
+    intelligence: executionContext.intelligence,
     runId: `${executionContext.runId}_synthesis`,
     name: `${executionContext.sandboxName || "swarm"}::synthesis`
   });
@@ -485,6 +586,7 @@ async function runSynthesisPhase({ synthesisNode, swarmConfig, tasks, inputPaylo
   const errorText = redactSecretsFromText(result?.error || "");
   const match = stdout.match(OUTCOME_SCORE_RE);
   const parsedOutcomeScore = match ? clamp01(match[1]) : null;
+  const telemetry = extractAdapterTelemetry(result);
   return {
     status: result?.ok === true && !errorText ? "completed" : "failed",
     ranSynthesis: true,
@@ -495,6 +597,11 @@ async function runSynthesisPhase({ synthesisNode, swarmConfig, tasks, inputPaylo
     adapter: resolved.adapterId,
     agentHost: resolved.agentHost || "",
     parsedOutcomeScore,
+    tokens: telemetry.tokens,
+    tools: telemetry.tools,
+    startedAt: startedAtIso,
+    endedAt: new Date().toISOString(),
+    phaseId: "synthesize",
     adapterMeta: { ...(result?.adapterMeta || {}), swarmPhase: "synthesis" }
   };
 }
@@ -722,19 +829,65 @@ async function runAgentSwarmGraphIfPresent({
     envRefsMissing: executionContext?.envRefsMissing || [],
     networkAllow: executionContext?.networkAllow === true,
     allowList: executionContext?.allowList || [],
+    browserAccess: executionContext?.browserAccess === true,
     timeoutMs: clampPositiveInt(timeoutMs, DEFAULT_SUBAGENT_TIMEOUT_MS),
-    sandboxName: executionContext?.sandboxName || row?.Name || "swarm"
+    sandboxName: executionContext?.sandboxName || row?.Name || "swarm",
+    onEvent: executionContext?.onEvent,
+    // Row-configured local-intelligence settings (model id, endpoint URL,
+    // adapter mode) — configuration only, never secret values.
+    intelligence: {
+      localModel: String(row?.localModel || "").trim(),
+      localEndpoint: String(row?.localEndpoint || "").trim(),
+      intelligenceAdapterMode: String(row?.intelligenceAdapterMode || "").trim() || "ollama"
+    }
   };
 
   const startedAt = Date.now();
+  emitSwarmDelta(ctx, {
+    type: "swarm.run.started",
+    status: "running",
+    name: cleanEventString(ctx.sandboxName),
+    adapter: cleanEventString(ctx.adapterId),
+    agentHost: cleanEventString(ctx.agentHost),
+    maxConcurrency,
+    phaseCount: 3,
+    taskCount: subagents.length
+  });
 
   // Phase 1: Plan ----------------------------------------------------------
+  emitSwarmDelta(ctx, {
+    type: "swarm.phase.started",
+    phaseId: "plan",
+    label: "Plan",
+    status: "running"
+  });
   const orchestratorResult = await runOrchestratorPhase({
     orchestratorNode: orchestrator,
     subagents,
     inputPayload: manualPayload,
     executionContext: ctx
   });
+  emitSwarmDelta(ctx, {
+    type: orchestratorResult.status === "failed" ? "swarm.phase.failed" : "swarm.phase.completed",
+    phaseId: "plan",
+    label: "Plan",
+    status: orchestratorResult.status,
+    agent: {
+      taskId: cleanEventString(orchestrator.id || "orchestrator"),
+      nodeId: cleanEventString(orchestrator.id || "orchestrator"),
+      role: cleanEventString(orchestrator?.config?.role || "Orchestrator"),
+      phaseId: "plan",
+      status: orchestratorResult.status,
+      adapter: cleanEventString(orchestratorResult.adapter || ""),
+      agentHost: cleanEventString(orchestratorResult.agentHost || ""),
+      durationMs: Number(orchestratorResult.durationMs) || 0,
+      tokens: orchestratorResult.tokens ?? null,
+      tools: orchestratorResult.tools ?? null,
+      startedAt: cleanEventString(orchestratorResult.startedAt || ""),
+      endedAt: cleanEventString(orchestratorResult.endedAt || ""),
+      error: cleanEventString(orchestratorResult.error || "")
+    }
+  });
 
   if (orchestratorResult.status === "failed" && String(orchestratorResult.error || "").length > 0) {
     const durationMs = Date.now() - startedAt;
@@ -747,6 +900,13 @@ async function runAgentSwarmGraphIfPresent({
       outcomeOk: false,
       synthesisResult: null
     });
+    emitSwarmDelta(ctx, {
+      type: "swarm.run.failed",
+      status: "failed",
+      phaseFailed: "plan",
+      durationMs,
+      error: cleanEventString(orchestratorResult.error || "")
+    });
     return {
       ok: false,
       exitCode: 1,
@@ -790,23 +950,68 @@ async function runAgentSwarmGraphIfPresent({
   // Phase 2: Dispatch ------------------------------------------------------
   let observedParallelism = 0;
   let activeNow = 0;
+  emitSwarmDelta(ctx, {
+    type: "swarm.phase.started",
+    phaseId: "dispatch",
+    label: "Dispatch",
+    status: "running",
+    taskCount: subagents.length
+  });
   const tasks = await runSubagentsWithConcurrency(subagents, maxConcurrency, async (subagentNode, index) => {
     activeNow += 1;
     if (activeNow > observedParallelism) observedParallelism = activeNow;
+    const subagentConfig = subagentNode?.config || {};
+    const taskId = subagentNode?.id || `task-${index + 1}`;
+    const phaseId = String(subagentConfig.phase || subagentConfig.phaseId || "").trim().toLowerCase() || "dispatch";
+    emitSwarmDelta(ctx, {
+      type: "swarm.task.started",
+      phaseId,
+      taskId: cleanEventString(taskId),
+      nodeId: cleanEventString(taskId),
+      role: cleanEventString(subagentConfig.role || subagentNode?.label || `Agent ${index + 1}`),
+      status: "running",
+      active: activeNow,
+      observedParallelism
+    });
     try {
-      return await dispatchSubagentTask({
+      const task = await dispatchSubagentTask({
         subagentNode,
         orchestratorPlan: orchestratorResult.plan,
         inputPayload: manualPayload,
         executionContext: ctx,
         taskIndex: index
       });
+      emitSwarmDelta(ctx, {
+        type: task.status === "completed" ? "swarm.task.completed" : "swarm.task.failed",
+        phaseId: task.phaseId || phaseId,
+        task: taskDeltaFromResult(task)
+      });
+      return task;
     } finally {
       activeNow -= 1;
     }
   });
+  const dispatchStatus = tasks.length > 0 && tasks.every((t) => t.status === "completed")
+    ? "completed"
+    : tasks.some((t) => t.status === "failed")
+      ? "failed"
+      : "completed";
+  emitSwarmDelta(ctx, {
+    type: dispatchStatus === "failed" ? "swarm.phase.failed" : "swarm.phase.completed",
+    phaseId: "dispatch",
+    label: "Dispatch",
+    status: dispatchStatus,
+    taskCount: tasks.length,
+    observedParallelism
+  });
 
   // Phase 3: Synthesize ----------------------------------------------------
+  emitSwarmDelta(ctx, {
+    type: "swarm.phase.started",
+    phaseId: "synthesize",
+    label: "Synthesize",
+    status: "running"
+  });
   const synthesisResult = await runSynthesisPhase({
     synthesisNode: synthesis,
     swarmConfig,
@@ -814,6 +1019,29 @@ async function runAgentSwarmGraphIfPresent({
     inputPayload: manualPayload,
     executionContext: ctx
   });
+  emitSwarmDelta(ctx, {
+    type: synthesisResult.status === "failed" ? "swarm.phase.failed" : "swarm.phase.completed",
+    phaseId: "synthesize",
+    label: "Synthesize",
+    status: synthesisResult.status,
+    agent: synthesisResult.ranSynthesis
+      ? {
+          taskId: cleanEventString(synthesis?.id || "synthesis"),
+          nodeId: cleanEventString(synthesis?.id || "synthesis"),
+          role: cleanEventString(synthesis?.label || "Synthesizer"),
+          phaseId: "synthesize",
+          status: synthesisResult.status,
+          adapter: cleanEventString(synthesisResult.adapter || ""),
+          agentHost: cleanEventString(synthesisResult.agentHost || ""),
+          durationMs: Number(synthesisResult.durationMs) || 0,
+          tokens: synthesisResult.tokens ?? null,
+          tools: synthesisResult.tools ?? null,
+          startedAt: cleanEventString(synthesisResult.startedAt || ""),
+          endedAt: cleanEventString(synthesisResult.endedAt || ""),
+          error: cleanEventString(synthesisResult.error || "")
+        }
+      : null
+  });
 
   const durationMs = Date.now() - startedAt;
   const requiredTasks = tasks.filter((t) => t.required);
@@ -863,6 +1091,15 @@ async function runAgentSwarmGraphIfPresent({
     errorText = `synthesizer returned OUTCOME_SCORE ${semanticScore} (< 0.5)`;
   }
 
+  emitSwarmDelta(ctx, {
+    type: outcomeOk ? "swarm.run.completed" : "swarm.run.failed",
+    status: swarmStatus,
+    durationMs,
+    observedParallelism: observedParallelism || (subagents.length === 1 ? 1 : 0),
+    reward,
+    error: cleanEventString(errorText || "")
+  });
+
   return {
     ok: outcomeOk,
     exitCode: outcomeOk ? 0 : 1,
@@ -888,6 +1125,12 @@ async function runAgentSwarmGraphIfPresent({
         adapter: orchestratorResult.adapter,
         agentHost: orchestratorResult.agentHost,
         durationMs: orchestratorResult.durationMs,
+        adapterMeta: orchestratorResult.adapterMeta || null,
+        tokens: orchestratorResult.tokens ?? null,
+        tools: orchestratorResult.tools ?? null,
+        startedAt: orchestratorResult.startedAt || "",
+        endedAt: orchestratorResult.endedAt || "",
+        phaseId: "plan",
         plan: clampText(orchestratorResult.plan, 4000)
       },
       tasks,
@@ -902,6 +1145,12 @@ async function runAgentSwarmGraphIfPresent({
             adapter: synthesisResult.adapter,
             agentHost: synthesisResult.agentHost,
             durationMs: synthesisResult.durationMs,
+            adapterMeta: synthesisResult.adapterMeta || null,
+            tokens: synthesisResult.tokens ?? null,
+            tools: synthesisResult.tools ?? null,
+            startedAt: synthesisResult.startedAt || "",
+            endedAt: synthesisResult.endedAt || "",
+            phaseId: "synthesize",
             answer: clampText(synthesisResult.output, 4000),
             parsedOutcomeScore: synthesisResult.parsedOutcomeScore
           }
@@ -914,6 +1163,7 @@ async function runAgentSwarmGraphIfPresent({
 export {
   runAgentSwarmGraphIfPresent,
   computeRewardTelemetry,
+  extractAdapterTelemetry,
   buildOrchestratorCommand,
   buildSubtaskCommand,
   buildSynthesisCommand,

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/lib/orchestration-graph-runner.js

@@ -281,6 +281,9 @@ async function runOrchestrationGraphIfPresent({ workspaceConfig, row, timeoutMs,
 
   const apiNode = extractApiRegistryCallNode(graph);
   if (!apiNode?.config) {
+    if ((Array.isArray(graph.nodes) ? graph.nodes : []).some((node) => node?.type === "ai-agent")) {
+      return null;
+    }
     return {
       ok: false,
       exitCode: 1,

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/lib/orchestration-graph.js

@@ -157,9 +157,10 @@ function validateOrchestrationGraph(graph) {
     } else {
       const hasThinAdapter = graph.nodes.some((n) => n?.type === "thinAdapter");
       const hasApi = graph.nodes.some((n) => n?.type === "api-registry-call");
+      const hasAiAgent = graph.nodes.some((n) => n?.type === "ai-agent");
       const hasResult = graph.nodes.some((n) => n?.type === "tool-result");
-      if (!hasThinAdapter && !hasApi) errors.push("orchestrationGraph requires an api-registry-call node");
-      if (!hasThinAdapter && !hasResult) errors.push("orchestrationGraph requires a tool-result node");
+      if (!hasThinAdapter && !hasApi && !hasAiAgent) errors.push("orchestrationGraph requires an executable node");
+      if (!hasThinAdapter && !hasAiAgent && !hasResult) errors.push("orchestrationGraph requires a tool-result node");
     }
   }
   if (!Array.isArray(graph.edges)) {
@@ -712,6 +713,7 @@ function buildCanonicalNode(nodeId, registryRow = {}, options = {}) {
 function getNextCanonicalNodeId(graph) {
   const parsed = parseOrchestrationGraph(graph) || graph;
   if ((parsed?.nodes || []).some((n) => n?.type === "thinAdapter")) return null;
+  if ((parsed?.nodes || []).some((n) => n?.type === "ai-agent")) return null;
   const ids = new Set((parsed?.nodes || []).map((n) => String(n.id)));
   for (const id of CANONICAL_NODE_ORDER) {
     if (!ids.has(id)) return id;
@@ -844,6 +846,12 @@ function buildDefaultAgentSwarmGraph(options = {}) {
         role: String(agent.role || agent.id || "Subagent"),
         description: String(agent.description || "").trim(),
         taskPrompt: String(agent.taskPrompt || "").trim(),
+        // Optional author-named phase — groups this subagent in the cockpit
+        // (e.g. "ping" / "echo" / "verify"). Absent → the single Dispatch
+        // phase, exactly as before.
+        ...(String(agent.phase || agent.phaseId || "").trim()
+          ? { phase: String(agent.phase || agent.phaseId).trim().toLowerCase() }
+          : {}),
         tools: Array.isArray(agent.tools) ? agent.tools.map((t) => String(t || "").trim()).filter(Boolean) : [],
         agentHost: String(agent.agentHost || agentHost || "").trim(),
         adapter: String(agent.adapter || "").trim(),