Skip to content

v1.2 release notes

Released: 2026-06-01 Version range: v1.2.0 — v1.2.70 Milestones: M6 (Observability), M7 (Intent Drift), M8 (MCP Layer), M10 (Serve), M12 (UI), M13 (Composer), M14 (Cost Optimization)

Highlights

HTTP server mode (swarmkit serve)

SwarmKit now runs as a persistent HTTP server with async job execution, SSE streaming, MCP endpoint, and full REST API for topology/skill/archetype CRUD. Authentication via API key or JWT (JWKS auto-discovery).

swarmkit serve ./workspace --port 8000

Web UI dashboard

Next.js 15 dashboard with 8 pages: health overview, chat, jobs, topologies, skills, archetypes, canary routes, and triggers. Real-time chat with conversation persistence and per-message token tracking.

Topology composer

Visual three-view topology editor (Structure, Relationships, Network) per design section 15.2. Create, edit, and save topologies with live YAML editing and validation.

Canary deployments

Topology-level version routing with weighted traffic splitting, per-version metrics (runs, errors, drift), and auto-promotion when criteria are met.

Dual model support

Split tool-calling and synthesis across different models. Tool calls use cheap models (Kimi K2.5), synthesis uses quality models (DeepSeek V4 Pro). 78% cost reduction demonstrated.

Workspace memory

Automatic conversation insight extraction and retrieval. Memory-writer saves structured insights after each turn; memory-reader injects relevant context into future conversations.

SQLite persistence

Jobs, conversations, and usage tracking persist across server restarts. Configurable backend (SQLite or Postgres) via workspace.yaml or environment variable.

Full changelog

Serve mode (M10)

  • FastAPI HTTP server with async job execution
  • MCP endpoint — each topology becomes an MCP tool
  • AuthProvider abstraction: NoneAuth, APIKeyAuth, JWTAuth (JWKS)
  • Server config block in workspace.yaml (max_concurrent, timeout, mcp.enabled)
  • Trigger scheduler: cron (croniter) and webhook (HMAC-SHA256)
  • Conversation HTTP endpoints: create, list, load, send message

Observability (M6)

  • SQLiteAuditProvider with structured events
  • OpenTelemetry metrics: run duration, agent steps, tool calls, governance decisions, drift scores
  • Ring buffer for prompt/response storage (local privacy)
  • Circuit breaker: max runs per minute, max total tokens per run
  • CLI: swarmkit logs, swarmkit why, swarmkit debug, swarmkit ask, swarmkit status
  • Configurable redaction patterns

Intent drift detection (M7)

  • IntentObserver with cosine similarity drift scoring
  • Schema extension: drift_threshold on topology/agent
  • Compiler wiring: automatic observation at each agent step
  • OTel drift metrics and breach counters

MCP integration layer (M8)

  • Lazy server startup: only start servers the topology needs
  • Permission tiers: open, cautious, strict, readonly per server
  • Document reader MCP server: images, draw.io, CSV, text
  • MarkItDown integration for office documents

UI (M12-M13)

  • Dashboard scaffold: Next.js 15 + Tailwind v4 + Lucide icons
  • Chat page: conversation sidebar, message bubbles, SSE progress, markdown rendering
  • Topology composer: Structure/Relationships/Network views
  • Property panel with YAML editing and save
  • Skills and archetypes pages with create/view/edit dialogs
  • Typed API client for all server endpoints

Cost optimization (M14)

  • Accurate token tracking across all LLM call paths
  • Dual model: tool_model + tool_provider on archetype/topology
  • Configurable store backend: sqlite or postgres
  • Per-message token display in chat UI

Other

  • Workspace environment configuration (workspace.env.yaml + SWARMKIT_ENV)
  • Structured delegation v2 with task plans
  • Structured agent communication (JSON/YAML between agents)
  • DAG dependency graph for parallel agent execution