Skip to content

smykla-skalski/service-mesh-debug

v1.2.2MIT

Diagnose and fix flaky e2e tests and connectivity issues in service mesh environments (Kuma, Istio, Linkerd, Consul). Covers 11 root causes: timing races, xDS propagation delays, Gomega misuse, pod availability races, mTLS/SDS readiness, Envoy circuit breakers, and outlier detection. Includes Python scripts for live Envoy diagnostics.

What this package declares

The file a client reads when it loads this plugin, exactly as this revision carries it.

plugin.json
{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "service-mesh-debug",
  "version": "1.2.2",
  "description": "Diagnose and fix flaky e2e tests and connectivity issues in service mesh environments (Kuma, Istio, Linkerd, Consul). Covers 11 root causes: timing races, xDS propagation delays, Gomega misuse, pod availability races, mTLS/SDS readiness, Envoy circuit breakers, and outlier detection. Includes Python scripts for live Envoy diagnostics.",
  "author": {
    "name": "Smykla Skalski Labs"
  },
  "homepage": "https://github.com/smykla-skalski/sai/tree/main/plugins/service-mesh-debug",
  "repository": "https://github.com/smykla-skalski/sai",
  "license": "MIT",
  "keywords": ["kuma", "istio", "linkerd", "consul", "envoy", "e2e", "testing", "flaky", "ginkgo", "gomega", "service-mesh", "xds", "mtls", "debugging"],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Service Mesh Debug",
        "shortDescription": "Debug flaky mesh tests and connectivity issues",
        "longDescription": "Diagnoses flaky Kuma/Ginkgo e2e tests against 11 known root causes and applies the minimal fix, and debugs live mesh connectivity (Kuma, Istio, Linkerd, Consul) with read-only Envoy admin scripts for xDS, mTLS and control plane health.",
        "developerName": "SAI",
        "category": "Developer Tools",
        "capabilities": ["Interactive"],
        "websiteURL": "https://github.com/smykla-skalski/sai/tree/main/plugins/service-mesh-debug",
        "privacyPolicyURL": "https://github.com/smykla-skalski/sai/blob/main/README.md",
        "termsOfServiceURL": "https://github.com/smykla-skalski/sai/blob/main/LICENSE",
        "defaultPrompt": [
          "Use $service-mesh-debug to find why this e2e test is flaky and propose the smallest fix.",
          "Use $service-mesh-debug to diagnose 503s between these two meshed services.",
          "Use $service-mesh-debug to check xDS and mTLS health of this sidecar pod."
        ],
        "brandColor": "#2563EB"
      }
    }
  }
}

What else this package ships

These files come with the package and this site does not publish them. They are listed so you know what is there before you install it.

  • 4Python files
  • evals.json
  • openai.yaml
View on GitHub

Client extensions

Data this package carries for particular clients. The directory lists the clients named and never reads what is addressed to them.

  • com.openai