bob-skills-openapi.json

{
  "openapi": "3.0.3",
  "info": {
    "title": "Bob Skills",
    "description": "IBM Bob cognitive reasoning skills for network diagnostics and RCA. Each skill accepts a natural-language prompt and returns structured analysis output.",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "http://10.13.13.2:3900"
    }
  ],
  "paths": {
    "/api/run": {
      "post": {
        "operationId": "run_skill",
        "summary": "Run any Bob skill by name",
        "description": "Execute a named Bob skill with a natural-language prompt.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "skill",
                  "prompt"
                ],
                "properties": {
                  "skill": {
                    "type": "string",
                    "description": "Skill ID (e.g. bob-lag-derived-metrics)",
                    "example": "bob-lag-derived-metrics"
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Natural-language instruction for the skill",
                    "example": "Compile derived metrics D10-D22 for LAG_Degradation on core01-fra02, bundle ae0"
                  },
                  "workspace": {
                    "type": "string",
                    "description": "Optional: path to workspace directory"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Skill execution result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "output": {
                      "type": "string",
                      "description": "Skill reasoning and analysis output"
                    },
                    "workspaceDir": {
                      "type": "string",
                      "description": "Path to workspace with generated files"
                    },
                    "toolCalls": {
                      "type": "integer"
                    },
                    "cost": {
                      "type": "number"
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "skills"
        ]
      }
    },
    "/api/run/bob-lag-derived-metrics": {
      "post": {
        "operationId": "run_bob_lag_derived_metrics",
        "summary": "Derive LAG Metrics (D10-D22)",
        "description": "Calculate derived observability metrics D10-D22 from raw interface telemetry to detect silent LAG degradation.",
        "tags": [
          "rca-skills"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "prompt"
                ],
                "properties": {
                  "prompt": {
                    "type": "string",
                    "description": "Natural-language instruction",
                    "example": "Compile derived metrics D10-D22 for LAG_Degradation on device core01-fra02, bundle ae0. Telemetry: high discard on xe-0/1/0."
                  },
                  "workspace": {
                    "type": "string",
                    "description": "Optional: workspace directory path"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Skill output",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "output": {
                      "type": "string"
                    },
                    "workspaceDir": {
                      "type": "string"
                    },
                    "toolCalls": {
                      "type": "integer"
                    },
                    "cost": {
                      "type": "number"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/run/bob-lag-mca": {
      "post": {
        "operationId": "run_bob_lag_mca",
        "summary": "Evaluate LAG MCA Alerts (MCA-S1..S8)",
        "description": "Evaluate Metric Condition Alerts against derived metrics — fires before raw thresholds trip.",
        "tags": [
          "rca-skills"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "prompt"
                ],
                "properties": {
                  "prompt": {
                    "type": "string",
                    "description": "Natural-language instruction",
                    "example": "Evaluate MCA alert conditions MCA-S1..S8 for LAG_Degradation on core01-fra02 using derived metric findings."
                  },
                  "workspace": {
                    "type": "string",
                    "description": "Optional: workspace directory path"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Skill output",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "output": {
                      "type": "string"
                    },
                    "workspaceDir": {
                      "type": "string"
                    },
                    "toolCalls": {
                      "type": "integer"
                    },
                    "cost": {
                      "type": "number"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/run/bob-cep-fingerprint-rules": {
      "post": {
        "operationId": "run_bob_cep_fingerprint_rules",
        "summary": "CEP Fingerprint RCA",
        "description": "Correlate syslog signals, symptom patterns, and MCA alerts into a root cause analysis diagnosis.",
        "tags": [
          "rca-skills"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "prompt"
                ],
                "properties": {
                  "prompt": {
                    "type": "string",
                    "description": "Natural-language instruction",
                    "example": "Synthesize RCA for incident on core01-fra02, bundle ae0. Correlate MCA alerts with observed symptoms."
                  },
                  "workspace": {
                    "type": "string",
                    "description": "Optional: workspace directory path"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Skill output",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "output": {
                      "type": "string"
                    },
                    "workspaceDir": {
                      "type": "string"
                    },
                    "toolCalls": {
                      "type": "integer"
                    },
                    "cost": {
                      "type": "number"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}