toolexec-integrations¶

This repo hosts opt‑in runtime clients for toolexec backends. Core toolexec stays interface‑only; these packages supply concrete SDK integrations.

Packages¶

Package	Implements	Typical Use
`kubernetes`	`kubernetes.PodRunner`, `kubernetes.HealthChecker`	Run executions in Kubernetes Jobs/Pods via client‑go
`proxmox`	`proxmox.APIClient`	Control Proxmox LXC status/start/stop
`remotehttp`	`remote.RemoteClient`	Call remote runtime service over HTTP/SSE

Wiring Examples¶

Kubernetes¶

corekube := kubernetescore.New(kubernetescore.Config{
    Namespace: "default",
    Image:     "toolruntime-sandbox:latest",
    Client:    kubeClient,
})

Proxmox¶

backend := proxmoxcore.New(proxmoxcore.Config{
    Node:                  "pve-1",
    VMID:                  100,
    Client:                proxmoxClient,
    RuntimeClient:         runtimeClient,
    RuntimeGatewayEndpoint:"https://gateway.internal",
})

Remote HTTP¶

client, _ := remotehttp.NewClient(remotehttp.Config{
    Endpoint:  "https://runtime.example.com/v1/execute",
    AuthToken: "...",
})
backend := remote.New(remote.Config{Client: client})

Compatibility¶

Use ai-tools-stack for the authoritative version matrix. This repo tracks those versions in VERSIONS.md.