Skip to content

Releases: AgentCTL-dev/source-code

v1.1.0

Choose a tag to compare

@AndriiTsok AndriiTsok released this 04 Jul 15:47

agentctl v1.1.0 — agentd resumable-workflow interop + a CRD grouping/observability pass.

agentd interop (additive; contract_version unchanged)

  • New surfaces.workflow contract surface (dialect + checkpoint); the resumable-workflow capability is dialect >= 2 && checkpoint. Typed client gains WorkflowSurface + a resumable() helper.
  • TASK_STATE_INPUT_REQUIRED is documented as non-terminal for checkpoint builds (keep polling/streaming), and SendMessage(message.taskId) is the gate-reply continuation (-32004 when nothing is waiting).
  • Gateway: a gate-reply message/send now routes to the fleet member that owns the paused task (task affinity), instead of round-robining to a fresh worker that would spuriously return -32004.

CRD changes (breaking, pre-adoption — agentctl.dev/v1alpha1)

  • Grouping: spec.model: {pool, id}; spec.capabilities: {exec, egress, secrets}; AgentFleet.spec.work: {source, maxAttempts, claimTtl} (claimTtlMs → Go-duration string; the redelivery/lease policy is now delivered to the coordinator). scaling.min/maxminReplicas/maxReplicas; scaling.target.signalmetric.
  • Validation: CEL invariants — instruction required for once/loop/schedule; a reactive agent must carry a wake source (subscribe, a workflow, or the a2a surface).
  • Observability: ModelPool/MCPServerSet gain status.conditions + a Ready column; a shared agentctl kubectl category on all four kinds; Agent columns point at the model binding.
  • Removed: the unenforced access.public flag; the substrate docs now state plainly that only stock-unix renders today (kata-hybrid/sidecar-emptydir are roadmap tiers).

Install

helm install agentctl oci://ghcr.io/agentctl-dev/charts/agentctl \
  --namespace agentctl-system --create-namespace --version 1.1.0

Images: ghcr.io/agentctl-dev/<component>:1.1.0. Upgrades cleanly from 1.0.0 (OLM replaces: agentctl.v1.0.0).

agentctl v1.0.0

Choose a tag to compare

@AndriiTsok AndriiTsok released this 03 Jul 18:17

agentctl is the Kubernetes control plane for provisioning, scaling, securing, and observing fleets of contract-conformant AI agents, on Agent Control Contract 1.0. It depends on the open contract, never on a specific agent binary.

Highlights

  • Contract 1.0 — agents are ordinary pods serving mTLS HTTPS at POST /mcp; the network is the substrate; identity (a verified mTLS client cert, or an attested source IP) is the authorization boundary. Agents are secret-free — every provider and tool credential is injected off-pod by the gateways.
  • Control plane — operator, aggregated apiserver, admission, A2A gateway, model gateway, MCP gateway, coordination (work.* claim hub), and a KEDA external scaler. All Deployments; every non-core feature gated off by default.
  • CRDs (agents.x-k8s.io/v1alpha1) — Agent, AgentFleet, ModelPool, MCPServerSet.
  • Fleet orchestration — coordinator/worker topology, a work fabric with result + dead-letter channels, per-fleet budgets, shard identity with guarded resize.

Install

helm install agentctl oci://ghcr.io/agentctl-dev/charts/agentctl \
  --version 1.0.0 -n agentctl-system --create-namespace \
  -f charts/agentctl/values-ghcr.yaml

Images + chart at ghcr.io/agentctl-dev 1.0.0. Reference agent: ghcr.io/agentd-dev/agentd:1.0.0. Docs: https://agentctl.dev