@claudexor/schema 1.0.0 → 2.0.0

package/generated/ControlSpecAnswersRequest.schema.json

@@ -0,0 +1,74 @@
+{
+  "$ref": "#/definitions/ControlSpecAnswersRequest",
+  "definitions": {
+    "ControlSpecAnswersRequest": {
+      "type": "object",
+      "properties": {
+        "answers": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "question_id": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Id of the question being answered."
+              },
+              "option_ids": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Non-empty identifier string."
+                },
+                "default": [],
+                "description": "Ids of the selected options."
+              },
+              "text": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "Free-text answer; null when only options were selected."
+              }
+            },
+            "required": [
+              "question_id"
+            ],
+            "additionalProperties": false,
+            "description": "The user's answer to one interview question."
+          },
+          "description": "Answers for the current interview tier."
+        },
+        "priorDecisions": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "question": {
+                "type": "string",
+                "description": "Question asked in a prior tier."
+              },
+              "answer": {
+                "type": "string",
+                "description": "The user's answer."
+              }
+            },
+            "required": [
+              "question",
+              "answer"
+            ],
+            "additionalProperties": false
+          }
+        }
+      },
+      "required": [
+        "answers"
+      ],
+      "additionalProperties": false,
+      "description": "Answers recorded against a durable spec session."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlSpecQuestionsRequest.schema.json

@@ -6,6 +6,7 @@
       "properties": {
         "prompt": {
           "type": "string",
+          "minLength": 1,
           "description": "The user's request the interview is clarifying."
         },
         "scope": {
@@ -45,6 +46,131 @@
           },
           "description": "Harnesses eligible to generate the questions."
         },
+        "n": {
+          "type": "integer",
+          "exclusiveMinimum": 0
+        },
+        "effort": {
+          "type": "string",
+          "enum": [
+            "low",
+            "medium",
+            "high",
+            "xhigh",
+            "max"
+          ],
+          "description": "Cross-harness reasoning-effort level, weakest to strongest; adapters declare the subset they support and a shared normalizer clamps requests onto the nearest supported level."
+        },
+        "paidBudget": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "type": "string",
+                  "const": "unlimited"
+                }
+              },
+              "required": [
+                "kind"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "type": "string",
+                  "const": "finite"
+                },
+                "maxUsd": {
+                  "type": "number",
+                  "minimum": 0
+                }
+              },
+              "required": [
+                "kind",
+                "maxUsd"
+              ],
+              "additionalProperties": false
+            }
+          ],
+          "description": "Incremental-cash budget: explicitly unlimited or a finite non-negative USD cap."
+        },
+        "web": {
+          "type": "string",
+          "enum": [
+            "off",
+            "auto",
+            "cached",
+            "live"
+          ],
+          "description": "External web/context policy for a run: off (no external context), auto (engine decides), cached (cached sources only), live (live web access). Separate from process/network sandboxing."
+        },
+        "reviewerModels": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/definitions/ControlSpecQuestionsRequest/properties/harnesses/items"
+          },
+          "propertyNames": {
+            "enum": [
+              "openai",
+              "anthropic",
+              "google",
+              "cursor",
+              "opencode",
+              "xai",
+              "local",
+              "unknown"
+            ]
+          }
+        },
+        "reviewerEfforts": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/definitions/ControlSpecQuestionsRequest/properties/effort"
+          },
+          "propertyNames": {
+            "enum": [
+              "openai",
+              "anthropic",
+              "google",
+              "cursor",
+              "opencode",
+              "xai",
+              "local",
+              "unknown"
+            ]
+          }
+        },
+        "reviewerPanel": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "harness": {
+                "type": "string",
+                "minLength": 1,
+                "pattern": "\\S",
+                "description": "Explicit reviewer harness id; repeated harness ids are allowed so one provider can review through multiple requested models."
+              },
+              "model": {
+                "$ref": "#/definitions/ControlSpecQuestionsRequest/properties/harnesses/items",
+                "description": "Per-reviewer model hint, passed to that harness only."
+              },
+              "effort": {
+                "$ref": "#/definitions/ControlSpecQuestionsRequest/properties/effort",
+                "description": "Per-reviewer effort hint, passed to that harness only."
+              }
+            },
+            "required": [
+              "harness"
+            ],
+            "additionalProperties": false,
+            "description": "One reviewer of an explicit reviewer panel."
+          },
+          "minItems": 1
+        },
         "priorDecisions": {
           "type": "array",
           "items": {
@@ -65,7 +191,7 @@
             ],
             "additionalProperties": false
           },
-          "description": "Already-answered decisions from prior tiers, carried so each round goes deeper instead of re-asking."
+          "description": "Prior-tier decisions carried into the next interview tier."
         }
       },
       "required": [
@@ -73,7 +199,7 @@
         "scope"
       ],
       "additionalProperties": false,
-      "description": "Request body to generate the next tier of spec interview questions."
+      "description": "Request to create a durable spec interview session."
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/generated/ControlSpecSession.schema.json

@@ -0,0 +1,249 @@
+{
+  "$ref": "#/definitions/ControlSpecSession",
+  "definitions": {
+    "ControlSpecSession": {
+      "type": "object",
+      "properties": {
+        "sessionId": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "\\S",
+          "description": "User-supplied string that must contain visible content, not just whitespace."
+        },
+        "prompt": {
+          "type": "string"
+        },
+        "scope": {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "type": "string",
+              "const": "project"
+            },
+            "root": {
+              "type": "string"
+            },
+            "context": {
+              "type": "string",
+              "enum": [
+                "auto"
+              ],
+              "description": "Project context depth; auto is the only mode."
+            }
+          },
+          "required": [
+            "kind",
+            "root",
+            "context"
+          ],
+          "additionalProperties": false
+        },
+        "state": {
+          "type": "string",
+          "enum": [
+            "grounding",
+            "questions",
+            "answered",
+            "freezing",
+            "frozen",
+            "cancelled",
+            "failed",
+            "interrupted_unknown"
+          ]
+        },
+        "planRunId": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "questions": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Question id."
+              },
+              "tier": {
+                "type": "integer",
+                "minimum": 0,
+                "default": 0,
+                "description": "Hierarchical depth of the question (0 = foundational)."
+              },
+              "prompt": {
+                "type": "string",
+                "description": "The question text shown to the user."
+              },
+              "kind": {
+                "type": "string",
+                "enum": [
+                  "single",
+                  "multi",
+                  "text"
+                ],
+                "description": "Answer shape of an interview question: single choice, multiple choice, or free text.",
+                "default": "single"
+              },
+              "options": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "Option id."
+                    },
+                    "label": {
+                      "type": "string",
+                      "description": "Human-readable option label."
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "label"
+                  ],
+                  "additionalProperties": false,
+                  "description": "One selectable option of an interview question."
+                },
+                "default": [],
+                "description": "Selectable options; empty for pure free-text questions."
+              },
+              "allow_text": {
+                "type": "boolean",
+                "default": false,
+                "description": "Whether free-text is accepted in addition to or instead of options."
+              },
+              "rationale": {
+                "type": "string",
+                "description": "Why this question matters for the spec."
+              }
+            },
+            "required": [
+              "id",
+              "prompt"
+            ],
+            "additionalProperties": false,
+            "description": "One quiz card of the spec interview."
+          }
+        },
+        "answers": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "question_id": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Id of the question being answered."
+              },
+              "option_ids": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Non-empty identifier string."
+                },
+                "default": [],
+                "description": "Ids of the selected options."
+              },
+              "text": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "default": null,
+                "description": "Free-text answer; null when only options were selected."
+              }
+            },
+            "required": [
+              "question_id"
+            ],
+            "additionalProperties": false,
+            "description": "The user's answer to one interview question."
+          }
+        },
+        "priorDecisions": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "question": {
+                "type": "string",
+                "description": "Question asked in a prior tier."
+              },
+              "answer": {
+                "type": "string",
+                "description": "The user's answer."
+              }
+            },
+            "required": [
+              "question",
+              "answer"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "specId": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "specDir": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "specPath": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "specHash": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "error": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "createdAt": {
+          "type": "string"
+        },
+        "updatedAt": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "sessionId",
+        "prompt",
+        "scope",
+        "state",
+        "planRunId",
+        "questions",
+        "answers",
+        "priorDecisions",
+        "specId",
+        "specDir",
+        "specPath",
+        "specHash",
+        "error",
+        "createdAt",
+        "updatedAt"
+      ],
+      "additionalProperties": false,
+      "description": "Durable public projection of a spec interview session."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}