agentharness

AgentHarness is a generic remote execution environment provisioned by a backend (e.g. OpenShell) and addressable by exec/SSH.

Schema URL

https://raw.githubusercontent.com/nlamirault/schema-hub/main/schemas/kagent.dev/agentharness_v1alpha2.json

▶ Usage examples

VS Code / yaml-language-server

# yaml-language-server: $schema=https://raw.githubusercontent.com/nlamirault/schema-hub/main/schemas/kagent.dev/agentharness_v1alpha2.json

kubeconform

kubeconform -schema-location 'https://raw.githubusercontent.com/nlamirault/schema-hub/main/schemas/{{ .Group }}/{{ .ResourceKind }}_{{ .ResourceAPIVersion }}.json' manifest.yaml

Resource Structure

apiVersionstring

APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kindstring

Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadataobject

specobject

AgentHarnessSpec describes a generic remote execution environment that agents (or human operators) can attach to via exec or SSH. An AgentHarness is distinct from a SandboxAgent: it has no agent runtime baked in. The backend is responsible for provisioning an environment that stays ready to accept incoming commands.

statusobject

AgentHarnessStatus is the observed state of an AgentHarness.