agentskeptic 1.4.0 → 2.1.0

package/schemas/registry-draft-llm-partial-v1.schema.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://agentskeptic.com/schemas/registry-draft-llm-partial-v1.schema.json",
   "title": "RegistryDraftLlmPartialV1",
-  "description": "Model output for registry draft only. Server adds schemaVersion, quickIngestInput. Not used for AJV full envelope validation.",
+  "description": "Model output for registry draft only. Server adds schemaVersion, quickIngestInput, readiness, generation. Full tools rows are validated via tools-registry.schema.json post-merge.",
   "type": "object",
   "additionalProperties": false,
   "required": ["draft", "assumptions", "warnings", "disclaimer", "model"],
@@ -16,7 +16,22 @@
           "type": "array",
           "minItems": 1,
           "items": {
-            "type": "object"
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["toolId", "effectDescriptionTemplate", "verification"],
+            "properties": {
+              "toolId": { "type": "string", "minLength": 1 },
+              "effectDescriptionTemplate": { "type": "string" },
+              "verification": {
+                "type": "object",
+                "required": ["kind"],
+                "minProperties": 1,
+                "properties": {
+                  "kind": { "type": "string", "minLength": 1 }
+                },
+                "additionalProperties": true
+              }
+            }
           }
         }
       }
@@ -33,9 +48,8 @@
     "model": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["provider", "model"],
+      "required": ["model"],
       "properties": {
-        "provider": { "type": "string", "const": "openai" },
         "model": { "type": "string", "minLength": 1 }
       }
     }

package/schemas/registry-draft-request-v1.schema.json

@@ -10,6 +10,9 @@
       "properties": {
         "inputKind": { "const": "bootstrap_pack_v1" },
         "schemaVersion": { "type": "integer", "const": 1 },
+        "draftProvider": {
+          "$ref": "#/$defs/draftProvider"
+        },
         "ddlHint": { "$ref": "#/$defs/ddlHint" },
         "bootstrapPackInput": {
           "$ref": "https://agentskeptic.com/schemas/bootstrap-pack-input-v1.schema.json"
@@ -23,6 +26,9 @@
       "properties": {
         "inputKind": { "const": "openai_tool_calls_v1" },
         "schemaVersion": { "type": "integer", "const": 1 },
+        "draftProvider": {
+          "$ref": "#/$defs/draftProvider"
+        },
         "workflowId": { "$ref": "#/$defs/workflowId" },
         "ddlHint": { "$ref": "#/$defs/ddlHint" },
         "tool_calls": {
@@ -44,6 +50,11 @@
       "type": "string",
       "maxLength": 8192,
       "pattern": "^(?!.*://)[\\s\\S]*$"
+    },
+    "draftProvider": {
+      "description": "Explicit draft backend — no silent failover; default is hosted_openai when omitted.",
+      "type": "string",
+      "enum": ["hosted_openai", "local_ollama"]
     }
   }
 }

package/schemas/registry-draft-response.schema.json

@@ -0,0 +1,89 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentskeptic.com/schemas/registry-draft-response.schema.json",
+  "title": "RegistryDraftResponseEnvelope",
+  "description": "Single SSOT envelope for assisted registry-draft (HTTP 200 success). Breaking change from deprecated v2.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "draft",
+    "assumptions",
+    "warnings",
+    "disclaimer",
+    "generation",
+    "quickIngestInput",
+    "readiness"
+  ],
+  "properties": {
+    "schemaVersion": { "type": "integer", "const": 3 },
+    "draft": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["tools"],
+      "properties": {
+        "tools": {
+          "$ref": "https://agentskeptic.com/schemas/tools-registry.schema.json"
+        }
+      }
+    },
+    "assumptions": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "warnings": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "disclaimer": { "type": "string", "minLength": 1 },
+    "generation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["backend", "model"],
+      "properties": {
+        "backend": { "type": "string", "enum": ["hosted_openai", "local_ollama"] },
+        "model": { "type": "string", "minLength": 1 }
+      }
+    },
+    "quickIngestInput": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["encoding", "body"],
+      "properties": {
+        "encoding": { "type": "string", "const": "utf8" },
+        "body": {
+          "type": "string",
+          "maxLength": 65536,
+          "description": "Deterministic NDJSON from normalized bootstrap pack (synthesizeQuickInputUtf8FromOpenAiV1)."
+        }
+      }
+    },
+    "readiness": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "reasons"],
+      "properties": {
+        "status": { "type": "string", "enum": ["ready", "review", "blocked"] },
+        "reasons": {
+          "type": "array",
+          "items": { "type": "string", "enum": ["REGISTRY_INVALID", "MERGE_FAILED", "MODEL_NON_JSON", "POINTERS_UNRESOLVED", "ASSUMPTIONS_PRESENT", "WARNINGS_PRESENT", "OK"] }
+        }
+      }
+    },
+    "diagnostics": {
+      "type": "array",
+      "description": "Optional structured hints; typically empty when readiness is ready or review.",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["code", "message"],
+        "properties": {
+          "instancePath": { "type": "string" },
+          "code": { "type": "string" },
+          "message": { "type": "string" },
+          "suggestedFix": { "type": "string" }
+        }
+      }
+    }
+  }
+}

package/schemas/registry-draft-response-v2.schema.json

@@ -1,52 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agentskeptic.com/schemas/registry-draft-response-v2.schema.json",
-  "title": "RegistryDraftResponseEnvelopeV2",
-  "type": "object",
-  "additionalProperties": false,
-  "required": ["schemaVersion", "draft", "assumptions", "warnings", "disclaimer", "model", "quickIngestInput"],
-  "properties": {
-    "schemaVersion": { "type": "integer", "const": 2 },
-    "draft": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["tools"],
-      "properties": {
-        "tools": {
-          "$ref": "https://agentskeptic.com/schemas/tools-registry.schema.json"
-        }
-      }
-    },
-    "assumptions": {
-      "type": "array",
-      "items": { "type": "string" }
-    },
-    "warnings": {
-      "type": "array",
-      "items": { "type": "string" }
-    },
-    "disclaimer": { "type": "string", "minLength": 1 },
-    "model": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["provider", "model"],
-      "properties": {
-        "provider": { "type": "string", "const": "openai" },
-        "model": { "type": "string", "minLength": 1 }
-      }
-    },
-    "quickIngestInput": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["encoding", "body"],
-      "properties": {
-        "encoding": { "type": "string", "const": "utf8" },
-        "body": {
-          "type": "string",
-          "maxLength": 65536,
-          "description": "NDJSON in quick ingest form; same cap tier as HTTP request body for registry-draft."
-        }
-      }
-    }
-  }
-}