doloop-machine/openapi.json at main · ekras-doloop/doloop-machine · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
{
  "openapi": "3.0.3",
  "info": {
    "title": "doloop machine",
    "version": "0.1.0",
    "description": "Deterministic, objective checks for AI output. Send an output, get a verdict that is the same every time (same input -> same input_sha256 -> same verdict). Bring your own model; the machine never touches it. Use it to catch an agent looping, drifting, sliding back, or producing slop, and to tie out numbers against a source."
  },
  "servers": [{ "url": "https://api.doloop.io" }],
  "paths": {
    "/v1/check": {
      "post": {
        "summary": "Check an output and get a deterministic verdict",
        "operationId": "check",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["text"],
                "properties": { "text": { "type": "string", "description": "the AI output to check" } }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "the verdict",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "verdict": { "type": "string", "enum": ["pass", "fail"] },
                    "finding_count": { "type": "integer" },
                    "findings": { "type": "array", "items": { "type": "object" } },
                    "input_sha256": { "type": "string", "description": "hash of the input; identical input gives identical hash gives identical verdict" }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/check-code": {
      "post": {
        "summary": "Check a code snippet and get a deterministic verdict (code donkey)",
        "operationId": "checkCode",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["code"],
                "properties": {
                  "code": { "type": "string", "description": "the code to check" },
                  "language": { "type": "string", "description": "language hint, e.g. python; default auto" }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "the verdict",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "verdict": { "type": "string", "enum": ["pass", "fail"] },
                    "finding_count": { "type": "integer" },
                    "findings": { "type": "array", "items": { "type": "object" } },
                    "input_sha256": { "type": "string", "description": "hash of the input; identical input gives identical hash gives identical verdict" }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/check-design": {
      "post": {
        "summary": "Check a live URL for visual-hierarchy hygiene (design donkey)",
        "operationId": "checkDesign",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["url"],
                "properties": { "url": { "type": "string", "description": "the live page to check" } }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "the verdict",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "verdict": { "type": "string", "enum": ["pass", "fail"] },
                    "findings": { "type": "array", "items": { "type": "object" } },
                    "counts": { "type": "object", "description": "distinct font sizes / weights / widths / colors" }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/check-chart": {
      "post": {
        "summary": "Check a chart image (presentations donkey, vision path; not byte-deterministic)",
        "operationId": "checkChart",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "image_url": { "type": "string", "description": "URL of the chart image" },
                  "image_b64": { "type": "string", "description": "base64 of the chart image" }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "the verdict",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "verdict": { "type": "string", "enum": ["pass", "fail"] },
                    "findings": { "type": "array", "items": { "type": "object" } }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/donkeys": {
      "get": {
        "summary": "List the six donkeys (the checks the machine runs)",
        "operationId": "listDonkeys",
        "responses": { "200": { "description": "the donkey roster" } }
      }
    },
    "/v1/chat/completions": {
      "post": {
        "summary": "OpenAI-compatible BYOL proxy; forwards your call with your key and attaches the verdict",
        "operationId": "proxyChat",
        "responses": { "200": { "description": "the provider response with a doloop verdict attached" } }
      }
    },
    "/health": {
      "get": { "summary": "liveness", "operationId": "health", "responses": { "200": { "description": "ok" } } }
    }
  }
}