@swarmclawai/swarmclaw 1.5.71 → 1.6.1

package/README.md

@@ -399,6 +399,27 @@ Operational docs: https://swarmclaw.ai/docs/observability
 
 ## Releases
 
+### v1.6.1 Highlights
+
+Follow-up release for v1.6 with workflow starts, safer metadata handling, A2A discovery polish, and [#61](https://github.com/swarmclawai/swarmclaw/pull/61) by [@latentwill](https://github.com/latentwill). Thanks latentwill!
+
+- **Mission and protocol templates for real work.** New starter paths cover codebase review sprints, research bureau scans, content studio cycles, release readiness panels, synthesis panels, and builder review loops.
+- **Home launchpad paths.** First-run users can choose a self-hosted assistant, visual workflow, or autonomous mission path, with quality actions still one click away.
+- **A2A discovery is easier to integrate.** The canonical `/.well-known/agent-card.json` endpoint now works alongside the legacy API route and hides disabled or trashed agents from public discovery.
+- **Internal metadata stripping is safer.** Side-channel JSON is removed with balanced-object parsing and zod validation so nested payloads are scrubbed without deleting ordinary user JSON.
+- **Browser smoke gate restored.** `npm run test:e2e` now runs a Playwright smoke against health, A2A discovery, `/home`, and `/quality`, either against a live URL or a temporary local dev server.
+- **OpenCode CLI hang fixed.** OpenCode CLI delegation no longer keeps an inherited stdin pipe open, preventing hangs in non-interactive runs.
+
+### v1.6.0 Highlights
+
+Operator Quality Center release for builders running autonomous agents in production-like workflows.
+
+- **New Quality workspace.** `/quality` brings run health, failed/running counts, pending approvals, latest eval scores, and attention shortcuts into one operator surface.
+- **Eval Lab and Approval Desk.** Existing eval and approval APIs are now exposed through a practical UI for running scenarios/suites, reviewing score evidence, and approving or denying human-loop/tool/connector/skill requests.
+- **Run Review upgrades.** The run history now has source filtering and search across run id, source, errors, results, and ownership fields while keeping the existing replay/evidence sheet.
+- **Release-ready mission templates.** New templates cover Release Candidate QA, Agent Cost Audit, Connector Smoke Test, Failed Run Triage, and Weekly Agent Quality Report using the existing mission budget/report model.
+- **Home launchpad quality actions.** First-run users can jump straight to evals, approvals, failed runs, and release QA missions from the operational launchpad.
+
 ### v1.5.71 Highlights
 
 Fast-follow release for [#60](https://github.com/swarmclawai/swarmclaw/pull/60) by [@borislavnnikolov](https://github.com/borislavnnikolov). Thanks Borislav!

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmclawai/swarmclaw",
-  "version": "1.5.71",
+  "version": "1.6.1",
   "description": "Build and run autonomous AI agents with OpenClaw, Hermes, multiple model providers, orchestration, delegation, memory, skills, schedules, and chat connectors.",
   "main": "electron-dist/main.js",
   "license": "MIT",
@@ -87,9 +87,9 @@
     "test:cli": "node --test src/cli/*.test.js bin/*.test.js scripts/postinstall.test.mjs scripts/run-next-build.test.mjs scripts/run-next-typegen.test.mjs",
     "test:setup": "tsx --test src/app/api/setup/check-provider/route.test.ts src/lib/server/provider-model-discovery.test.ts src/components/auth/setup-wizard/utils.test.ts src/components/auth/setup-wizard/types.test.ts src/hooks/setup-done-detection.test.ts src/lib/setup-defaults.test.ts src/lib/server/storage-auth.test.ts src/lib/server/storage-auth-docker.test.ts",
     "test:openclaw": "tsx --test src/lib/openclaw/openclaw-agent-id.test.ts src/lib/openclaw/openclaw-endpoint.test.ts src/lib/server/agents/agent-runtime-config.test.ts src/lib/server/build-llm.test.ts src/lib/server/connectors/connector-routing.test.ts src/lib/server/connectors/openclaw.test.ts src/lib/server/connectors/swarmdock.test.ts src/lib/server/gateway/protocol.test.ts src/lib/server/llm-response-cache.test.ts src/lib/server/mcp-conformance.test.ts src/lib/server/openclaw/agent-resolver.test.ts src/lib/server/openclaw/deploy.test.ts src/lib/server/openclaw/skills-normalize.test.ts src/lib/server/session-tools/openclaw-nodes.test.ts src/lib/server/session-tools/swarmdock.test.ts src/lib/server/tasks/task-quality-gate.test.ts src/lib/server/tasks/task-validation.test.ts src/lib/server/tool-capability-policy.test.ts src/lib/providers/openai.test.ts src/lib/providers/openclaw-exports.test.ts src/app/api/openclaw/dashboard-url/route.test.ts",
-    "test:runtime": "tsx --test src/lib/server/mcp-gateway-runtime.test.ts src/lib/server/mcp-connection-pool.test.ts src/lib/server/knowledge-sources.test.ts src/lib/server/chat-execution/chat-execution-grounding.test.ts src/lib/server/chat-execution/chat-turn-preparation.test.ts src/lib/server/chat-execution/iteration-timers.test.ts src/lib/server/chat-execution/post-stream-finalization.test.ts src/lib/server/chats/clear-undo-snapshots.test.ts src/lib/server/connectors/email.test.ts src/lib/server/protocols/protocol-service.test.ts src/lib/server/runtime/run-ledger.test.ts src/lib/server/observability/otel-config.test.ts src/lib/server/safe-parse-body.test.ts src/lib/app/view-constants.test.ts src/app/api/approvals/route.test.ts src/app/api/agents/agents-route.test.ts src/app/api/tasks/tasks-route.test.ts src/app/api/chats/chat-route.test.ts src/app/api/chats/clear-route.test.ts src/app/api/chats/compact-route.test.ts src/app/api/chats/context-status-route.test.ts src/app/api/connectors/connector-doctor-route.test.ts src/app/api/healthz/route.test.ts src/app/api/logs/route.test.ts src/app/api/providers/[id]/route.test.ts src/app/api/tts/route.test.ts",
+    "test:runtime": "tsx --test src/lib/a2a/agent-card.test.ts src/lib/strip-internal-metadata.test.ts src/lib/providers/opencode-cli.test.ts src/lib/server/mcp-gateway-runtime.test.ts src/lib/server/mcp-connection-pool.test.ts src/lib/server/knowledge-sources.test.ts src/lib/server/chat-execution/chat-execution-grounding.test.ts src/lib/server/chat-execution/chat-turn-preparation.test.ts src/lib/server/chat-execution/iteration-timers.test.ts src/lib/server/chat-execution/post-stream-finalization.test.ts src/lib/server/chats/clear-undo-snapshots.test.ts src/lib/server/connectors/email.test.ts src/lib/server/protocols/protocol-service.test.ts src/lib/server/runtime/run-ledger.test.ts src/lib/server/observability/otel-config.test.ts src/lib/server/safe-parse-body.test.ts src/lib/server/missions/mission-templates.test.ts src/lib/app/view-constants.test.ts src/lib/quality/quality-summary.test.ts src/app/api/approvals/route.test.ts src/app/api/agents/agents-route.test.ts src/app/api/tasks/tasks-route.test.ts src/app/api/chats/chat-route.test.ts src/app/api/chats/clear-route.test.ts src/app/api/chats/compact-route.test.ts src/app/api/chats/context-status-route.test.ts src/app/api/connectors/connector-doctor-route.test.ts src/app/api/healthz/route.test.ts src/app/api/logs/route.test.ts src/app/api/providers/[id]/route.test.ts src/app/api/tts/route.test.ts",
     "test:builder": "tsx --test src/features/protocols/builder/utils/nodes-to-template.test.ts src/features/protocols/builder/utils/template-to-nodes.test.ts src/features/protocols/builder/validators/dag-validator.test.ts",
-    "test:e2e": "tsx .workbench/browser-e2e/run.ts",
+    "test:e2e": "node --import tsx scripts/browser-e2e-smoke.ts",
     "test:mcp:conformance": "node --import tsx ./scripts/mcp-conformance-check.ts",
     "electron:compile": "tsc -p electron/tsconfig.json",
     "electron:dev": "npm run electron:compile && electron electron-dist/main.js",

package/src/app/.well-known/agent-card.json/route.ts

@@ -0,0 +1,15 @@
+import { NextResponse } from 'next/server'
+import { buildAgentCardDiscoveryPayload } from '@/lib/a2a/agent-card'
+
+export const dynamic = 'force-dynamic'
+
+/**
+ * GET /.well-known/agent-card.json?agentId=xxx
+ *
+ * Canonical public A2A Agent Card discovery endpoint. If agentId is omitted,
+ * returns a directory of discoverable local SwarmClaw agents.
+ */
+export async function GET(req: Request) {
+  const { body, status } = buildAgentCardDiscoveryPayload(req)
+  return NextResponse.json(body, { status })
+}

package/src/app/api/.well-known/agent-card/route.ts

@@ -1,46 +1,15 @@
 import { NextResponse } from 'next/server'
-import { getAgent, listAgents } from '@/lib/server/agents/agent-repository'
-import { generateAgentCard } from '@/lib/a2a/agent-card'
+import { buildAgentCardDiscoveryPayload } from '@/lib/a2a/agent-card'
 
 export const dynamic = 'force-dynamic'
 
 /**
- * GET /.well-known/agent-card.json?agentId=xxx
+ * GET /api/.well-known/agent-card?agentId=xxx
  *
- * A2A Agent Card discovery endpoint.
- * If agentId is provided, returns the full card for that agent.
- * Otherwise, returns a directory of all non-disabled agents.
- *
- * Publicly accessible per A2A spec — no auth required for discovery.
+ * Back-compatible A2A Agent Card discovery endpoint. The canonical public
+ * well-known URL is implemented at /.well-known/agent-card.json.
  */
 export async function GET(req: Request) {
-  const { searchParams } = new URL(req.url)
-  const agentId = searchParams.get('agentId')
-  const baseUrl = `${new URL(req.url).origin}`
-
-  if (agentId) {
-    const agent = getAgent(agentId)
-    if (!agent) {
-      return NextResponse.json({ error: 'Agent not found' }, { status: 404 })
-    }
-    if (agent.disabled) {
-      return NextResponse.json({ error: 'Agent is disabled' }, { status: 404 })
-    }
-    const card = generateAgentCard(agent, baseUrl)
-    return NextResponse.json(card)
-  }
-
-  // Return directory of all active agents
-  const agents = listAgents()
-  const directory = Object.values(agents)
-    .filter(a => !a.disabled)
-    .map(a => ({
-      name: a.name,
-      description: a.description || `SwarmClaw agent: ${a.name}`,
-      agentId: a.id,
-      apiEndpoint: `${baseUrl}/api/a2a`,
-      cardUrl: `${baseUrl}/api/.well-known/agent-card?agentId=${a.id}`,
-    }))
-
-  return NextResponse.json({ agents: directory, protocolVersion: '0.3.0' })
+  const { body, status } = buildAgentCardDiscoveryPayload(req)
+  return NextResponse.json(body, { status })
 }

package/src/app/home/page.tsx

@@ -1,6 +1,6 @@
 'use client'
 
-import { useEffect, useMemo, useState } from 'react'
+import { useEffect, useMemo, useRef, useState } from 'react'
 import { useRouter } from 'next/navigation'
 import { AreaChart, Area, ResponsiveContainer, Tooltip } from 'recharts'
 import { useAppStore } from '@/stores/use-app-store'
@@ -109,6 +109,7 @@ export default function HomePage() {
   const [localhostBrowser, setLocalhostBrowser] = useState(false)
   const [pageReady, setPageReady] = useState(false)
   const [launchpadFlag, setLaunchpadFlag] = useState(false)
+  const launchpadFlagConsumedRef = useRef(false)
   const mountedRef = useMountedRef()
 
   useEffect(() => {
@@ -116,9 +117,12 @@ export default function HomePage() {
   }, [])
 
   useEffect(() => {
+    if (launchpadFlagConsumedRef.current) return
     const hasFlag = safeStorageGet(HOME_LAUNCHPAD_AFTER_SETUP_KEY) === '1'
-    setLaunchpadFlag(hasFlag)
-    if (hasFlag) safeStorageRemove(HOME_LAUNCHPAD_AFTER_SETUP_KEY)
+    if (!hasFlag) return
+    launchpadFlagConsumedRef.current = true
+    setLaunchpadFlag(true)
+    safeStorageRemove(HOME_LAUNCHPAD_AFTER_SETUP_KEY)
   }, [])
 
   const allAgents = Object.values(agents).filter((a) => !a.trashedAt)
@@ -279,6 +283,10 @@ export default function HomePage() {
             onOpenBuilder={openBuilder}
             onOpenConnectors={() => navigateTo('connectors')}
             onOpenUsage={() => navigateTo('usage')}
+            onRunEvalSuite={() => navigateTo('quality')}
+            onReviewApprovals={() => navigateTo('quality')}
+            onInspectFailedRuns={() => navigateTo('quality')}
+            onStartReleaseQaMission={() => navigateTo('missions')}
           />
         </div>
       </MainContent>

package/src/app/quality/page.tsx

@@ -0,0 +1,7 @@
+'use client'
+
+import { QualityWorkspace } from '@/components/quality/quality-workspace'
+
+export default function QualityPage() {
+  return <QualityWorkspace />
+}

package/src/components/home/home-launchpad.tsx

@@ -14,6 +14,48 @@ function SnapshotItem({ label, value, hint }: { label: string; value: string; hi
   )
 }
 
+function PathCard({
+  kicker,
+  title,
+  description,
+  primaryLabel,
+  secondaryLabel,
+  onPrimary,
+  onSecondary,
+}: {
+  kicker: string
+  title: string
+  description: string
+  primaryLabel: string
+  secondaryLabel: string
+  onPrimary: () => void
+  onSecondary: () => void
+}) {
+  return (
+    <div className="flex min-h-[220px] flex-col rounded-[18px] border border-white/[0.07] bg-white/[0.03] p-5">
+      <div className="text-[11px] font-700 uppercase tracking-[0.12em] text-text-3/55">{kicker}</div>
+      <div className="mt-3 text-[18px] font-display font-700 tracking-normal text-text">{title}</div>
+      <p className="mt-2 flex-1 text-[13px] leading-relaxed text-text-3/72">{description}</p>
+      <div className="mt-5 flex flex-wrap gap-2">
+        <button
+          type="button"
+          onClick={onPrimary}
+          className="rounded-[10px] bg-accent-bright px-3.5 py-2 text-[12px] font-display font-700 text-black transition-opacity hover:opacity-90"
+        >
+          {primaryLabel}
+        </button>
+        <button
+          type="button"
+          onClick={onSecondary}
+          className="rounded-[10px] border border-white/[0.08] bg-white/[0.04] px-3.5 py-2 text-[12px] font-display font-700 text-text-2 transition-colors hover:bg-white/[0.08]"
+        >
+          {secondaryLabel}
+        </button>
+      </div>
+    </div>
+  )
+}
+
 type Props = {
   firstAgent: Agent | null
   agentCount: number
@@ -27,6 +69,10 @@ type Props = {
   onOpenBuilder: () => void
   onOpenConnectors: () => void
   onOpenUsage: () => void
+  onRunEvalSuite: () => void
+  onReviewApprovals: () => void
+  onInspectFailedRuns: () => void
+  onStartReleaseQaMission: () => void
 }
 
 export function HomeLaunchpad({
@@ -42,20 +88,24 @@ export function HomeLaunchpad({
   onOpenBuilder,
   onOpenConnectors,
   onOpenUsage,
+  onRunEvalSuite,
+  onReviewApprovals,
+  onInspectFailedRuns,
+  onStartReleaseQaMission,
 }: Props) {
   return (
     <div className="max-w-[980px] mx-auto px-6 py-10">
-      <div className="rounded-[24px] border border-white/[0.06] bg-gradient-to-br from-white/[0.05] via-white/[0.02] to-transparent p-6">
+      <div className="rounded-[20px] border border-white/[0.06] bg-white/[0.025] p-6">
         <div className="inline-flex rounded-full border border-white/[0.08] bg-white/[0.03] px-3 py-1 text-[11px] font-700 uppercase tracking-[0.16em] text-text-3/70">
-          Launchpad
+          v1.6 Launchpad
         </div>
         <div className="mt-4 flex flex-col gap-4 lg:flex-row lg:items-start lg:justify-between">
           <div className="max-w-[620px]">
-            <h1 className="font-display text-[34px] font-700 tracking-[-0.03em] text-text">
-              Start with the result you want, not the control plane.
+            <h1 className="font-display text-[34px] font-700 tracking-normal text-text">
+              Pick a path and watch the workspace move.
             </h1>
             <p className="mt-3 text-[15px] leading-relaxed text-text-3/72">
-              SwarmClaw already has the building blocks. Use this workspace to start a live agent chat, launch a bounded session, wire a connector, or move straight into reusable workflows.
+              Start with a local assistant, a reusable workflow, or a budgeted autonomous mission. The rest of the control plane stays one click away.
             </p>
           </div>
           <div className="rounded-[18px] border border-white/[0.06] bg-white/[0.03] p-4 min-w-[240px]">
@@ -86,6 +136,36 @@ export function HomeLaunchpad({
         </div>
       </div>
 
+      <div className="mt-6 grid gap-3 lg:grid-cols-3">
+        <PathCard
+          kicker="Self-hosted assistant"
+          title={firstAgent ? `Work with ${firstAgent.name}` : 'Create the first agent'}
+          description="Open a live agent chat, then add memory, local tools, provider routing, or connector access as the work demands."
+          primaryLabel={firstAgent ? 'Open Chat' : 'Open Agents'}
+          secondaryLabel="Connect Platform"
+          onPrimary={onOpenFirstAgent}
+          onSecondary={onOpenConnectors}
+        />
+        <PathCard
+          kicker="Visual workflow"
+          title="Shape a reusable run"
+          description="Use protocol templates and the builder to turn review, research, planning, or release checks into durable workflows."
+          primaryLabel="Open Builder"
+          secondaryLabel="Use Templates"
+          onPrimary={onOpenBuilder}
+          onSecondary={onOpenProtocols}
+        />
+        <PathCard
+          kicker="Autonomous mission"
+          title="Run with budgets"
+          description="Start a mission template for release QA, research, support triage, cost audit, or failed-run review with reports and caps."
+          primaryLabel="Open Missions"
+          secondaryLabel="Quality Center"
+          onPrimary={onStartReleaseQaMission}
+          onSecondary={onRunEvalSuite}
+        />
+      </div>
+
       <div className="mt-6 grid gap-3 md:grid-cols-2 xl:grid-cols-3">
         <LaunchActionCard
           title={firstAgent ? 'Open First Agent Chat' : 'Open Agents'}
@@ -120,6 +200,30 @@ export function HomeLaunchpad({
           actionLabel="Open Usage"
           onClick={onOpenUsage}
         />
+        <LaunchActionCard
+          title="Run Eval Suite"
+          description="Open the Quality Center and run scenario or suite checks against an agent before shipping."
+          actionLabel="Open Eval Lab"
+          onClick={onRunEvalSuite}
+        />
+        <LaunchActionCard
+          title="Review Approvals"
+          description="Clear pending human-loop, tool, connector, skill, agent, and budget requests from one desk."
+          actionLabel="Open Approvals"
+          onClick={onReviewApprovals}
+        />
+        <LaunchActionCard
+          title="Inspect Failed Runs"
+          description="Filter recent run failures and open replay evidence without leaving the operator workflow."
+          actionLabel="Open Run Review"
+          onClick={onInspectFailedRuns}
+        />
+        <LaunchActionCard
+          title="Start Release QA Mission"
+          description="Use a budgeted mission template to collect release readiness evidence and quality notes."
+          actionLabel="Open Missions"
+          onClick={onStartReleaseQaMission}
+        />
       </div>
 
       <div className="mt-8 grid gap-3 md:grid-cols-2 xl:grid-cols-3">

package/src/components/layout/sidebar-rail.tsx

@@ -305,6 +305,12 @@ export function SidebarRail({
                 <polyline points="22 12 18 12 15 21 9 3 6 12 2 12" />
               </svg>
             </NavItem>
+            <NavItem view="quality" label="Quality" expanded={railExpanded} isActive={isNavActive('quality')} onClick={() => handleNavClick('quality')}>
+              <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
+                <path d="M9 12l2 2 4-4" />
+                <path d="M12 3l7 4v5c0 4.4-2.9 8.5-7 9-4.1-.5-7-4.6-7-9V7l7-4z" />
+              </svg>
+            </NavItem>
           </div>
 
           <div className={`flex flex-col gap-0.5 ${railExpanded ? '' : 'items-center'}`}>