@claudexor/schema 5.1.0 → 6.0.0

package/generated/ControlHarnessMaintenanceOperation.schema.json

@@ -13,36 +13,53 @@
             "settled"
           ]
         },
-        "mechanism": {
+        "target": {
           "anyOf": [
             {
-              "type": "string",
-              "enum": [
-                "managed_npm",
-                "vendor_updater",
-                "vendor_script"
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "type": "string",
+                  "const": "latest"
+                },
+                "version": {
+                  "type": "null"
+                }
+              },
+              "required": [
+                "kind",
+                "version"
               ],
-              "description": "managed_npm installs one exact registry version in place; vendor_updater runs the vendor's own `update` on its canonical launcher (latest only); vendor_script has no engine-run update."
+              "additionalProperties": false
             },
             {
-              "type": "null"
+              "type": "object",
+              "properties": {
+                "kind": {
+                  "type": "string",
+                  "const": "version"
+                },
+                "version": {
+                  "type": "string",
+                  "pattern": "^\\d+\\.\\d+\\.\\d+(?:-[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$",
+                  "description": "One exact vendor version, never a range or a release fixture stamp."
+                }
+              },
+              "required": [
+                "kind",
+                "version"
+              ],
+              "additionalProperties": false
             }
-          ],
-          "description": "managed_npm installs one exact registry version in place; vendor_updater runs the vendor's own `update` on its canonical launcher (latest only); vendor_script has no engine-run update."
+          ]
         },
-        "target": {
+        "requester": {
           "type": "object",
           "properties": {
-            "kind": {
-              "type": "string",
-              "enum": [
-                "latest",
-                "version",
-                "previous",
-                "baseline"
-              ]
+            "source": {
+              "type": "string"
             },
-            "version": {
+            "requestId": {
               "type": [
                 "string",
                 "null"
@@ -50,8 +67,94 @@
             }
           },
           "required": [
-            "kind",
-            "version"
+            "source",
+            "requestId"
+          ],
+          "additionalProperties": false
+        },
+        "installationHome": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "commands": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "binary": {
+                "type": "string"
+              },
+              "args": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "env": {
+                "type": "object",
+                "additionalProperties": {
+                  "type": "string"
+                }
+              },
+              "script": {
+                "anyOf": [
+                  {
+                    "type": "object",
+                    "properties": {
+                      "url": {
+                        "type": "string"
+                      },
+                      "size": {
+                        "type": "integer",
+                        "exclusiveMinimum": 0
+                      },
+                      "sha256": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "url",
+                      "size",
+                      "sha256"
+                    ],
+                    "additionalProperties": false
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              }
+            },
+            "required": [
+              "binary",
+              "args",
+              "env",
+              "script"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "profileCleanup": {
+          "type": "object",
+          "properties": {
+            "plannedPaths": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "removedPaths": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          },
+          "required": [
+            "plannedPaths",
+            "removedPaths"
           ],
           "additionalProperties": false
         },
@@ -60,37 +163,50 @@
             {
               "type": "object",
               "properties": {
+                "path": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "realPath": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
                 "version": {
                   "type": [
                     "string",
                     "null"
                   ]
                 },
-                "binary": {
+                "versionOutput": {
                   "type": [
                     "string",
                     "null"
                   ]
                 },
-                "selection": {
-                  "type": "string",
-                  "enum": [
-                    "managed",
-                    "override",
-                    "path",
-                    "missing"
-                  ],
-                  "description": "managed = Claudexor's managed npm copy; override = the explicit CLAUDEXOR_<HARNESS>_BIN program; path = another copy found on the harness PATH; missing = nothing launchable."
+                "overrideEnv": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
                 },
-                "proved": {
-                  "type": "boolean"
+                "overrideValue": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
                 }
               },
               "required": [
+                "path",
+                "realPath",
                 "version",
-                "binary",
-                "selection",
-                "proved"
+                "versionOutput",
+                "overrideEnv",
+                "overrideValue"
               ],
               "additionalProperties": false
             },
@@ -100,35 +216,30 @@
           ]
         },
         "after": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ControlHarnessMaintenanceOperation/properties/before/anyOf/0"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "elsewhere": {
           "anyOf": [
             {
               "type": "object",
               "properties": {
-                "version": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
+                "before": {
+                  "$ref": "#/definitions/ControlHarnessMaintenanceOperation/properties/before/anyOf/0"
                 },
-                "binary": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "selected": {
-                  "type": "boolean",
-                  "description": "The harness now resolves this program."
-                },
-                "proved": {
-                  "type": "boolean"
+                "after": {
+                  "$ref": "#/definitions/ControlHarnessMaintenanceOperation/properties/before/anyOf/0"
                 }
               },
               "required": [
-                "version",
-                "binary",
-                "selected",
-                "proved"
+                "before",
+                "after"
               ],
               "additionalProperties": false
             },
@@ -137,14 +248,44 @@
             }
           ]
         },
+        "activeRunsAtStart": {
+          "anyOf": [
+            {
+              "type": "integer",
+              "minimum": 0
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "A fact, never permission to proceed; null when the CLI has no daemon run census."
+        },
+        "exitCode": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "outcome": {
+          "type": "string",
+          "enum": [
+            "changed",
+            "not_changed",
+            "changed_elsewhere",
+            "unknown"
+          ]
+        },
         "mutation": {
           "type": "string",
           "enum": [
             "none",
             "applied",
             "unknown"
-          ],
-          "description": "Whether installed bytes could have changed."
+          ]
         },
         "termination": {
           "type": "string",
@@ -165,7 +306,8 @@
           "items": {
             "type": "string"
           },
-          "maxItems": 40
+          "maxItems": 40,
+          "description": "Bounded, redacted vendor diagnostics, including advice when nothing changed."
         },
         "problem": {
           "anyOf": [
@@ -274,10 +416,16 @@
       },
       "required": [
         "phase",
-        "mechanism",
         "target",
+        "requester",
+        "installationHome",
+        "commands",
         "before",
         "after",
+        "elsewhere",
+        "activeRunsAtStart",
+        "exitCode",
+        "outcome",
         "mutation",
         "termination",
         "limitations",
@@ -291,7 +439,7 @@
         "finishedAt"
       ],
       "additionalProperties": false,
-      "description": "A durable harness maintenance operation; 202 on create is a handle, not success."
+      "description": "A durable maintenance operation; acceptance is a handle, not completion."
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/generated/ControlHarnessModelsQueryResponse.schema.json

@@ -10,6 +10,33 @@
               "type": "string",
               "description": "Harness the models belong to."
             },
+            "sourceProgram": {
+              "anyOf": [
+                {
+                  "type": "object",
+                  "properties": {
+                    "path": {
+                      "type": "string"
+                    },
+                    "version": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "path",
+                    "version"
+                  ],
+                  "additionalProperties": false
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
             "models": {
               "type": "array",
               "items": {
@@ -336,6 +363,9 @@
                           "harnessId": {
                             "$ref": "#/definitions/ControlHarnessModelsQueryResponse/anyOf/0/properties/harnessId"
                           },
+                          "sourceProgram": {
+                            "$ref": "#/definitions/ControlHarnessModelsQueryResponse/anyOf/0/properties/sourceProgram"
+                          },
                           "models": {
                             "$ref": "#/definitions/ControlHarnessModelsQueryResponse/anyOf/0/properties/models"
                           },

package/generated/ControlHarnessModelsResponse.schema.json

@@ -8,6 +8,33 @@
           "type": "string",
           "description": "Harness the models belong to."
         },
+        "sourceProgram": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "path": {
+                  "type": "string"
+                },
+                "version": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                }
+              },
+              "required": [
+                "path",
+                "version"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
         "models": {
           "type": "array",
           "items": {

package/generated/ControlModelAccountCatalogResponse.schema.json

@@ -90,6 +90,33 @@
                   {
                     "type": "object",
                     "properties": {
+                      "sourceProgram": {
+                        "anyOf": [
+                          {
+                            "type": "object",
+                            "properties": {
+                              "path": {
+                                "type": "string"
+                              },
+                              "version": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              }
+                            },
+                            "required": [
+                              "path",
+                              "version"
+                            ],
+                            "additionalProperties": false
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "default": null
+                      },
                       "source": {
                         "$ref": "#/definitions/ControlModelAccountCatalogResponse/properties/source"
                       },

package/generated/ControlModelCatalogQueryResponse.schema.json

@@ -6,6 +6,33 @@
         {
           "type": "object",
           "properties": {
+            "sourceProgram": {
+              "anyOf": [
+                {
+                  "type": "object",
+                  "properties": {
+                    "path": {
+                      "type": "string"
+                    },
+                    "version": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "path",
+                    "version"
+                  ],
+                  "additionalProperties": false
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
             "source": {
               "type": "string",
               "minLength": 1,

package/generated/ControlModelCatalogResponse.schema.json

@@ -4,6 +4,33 @@
     "ControlModelCatalogResponse": {
       "type": "object",
       "properties": {
+        "sourceProgram": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "path": {
+                  "type": "string"
+                },
+                "version": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                }
+              },
+              "required": [
+                "path",
+                "version"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
         "source": {
           "type": "string",
           "minLength": 1,

package/generated/ControlPendingInteraction.schema.json

@@ -113,7 +113,16 @@
             "null"
           ],
           "default": null,
-          "description": "When the interaction times out into a benign decline; null = no timeout."
+          "description": "When the interaction expires unanswered; null = no automatic expiry. A blocking question then declines benignly; an async one closes and nothing is sent."
+        },
+        "delivery": {
+          "type": "string",
+          "enum": [
+            "blocking",
+            "async"
+          ],
+          "description": "How the asking agent waits for the answer: blocking (its native tool call waits until the question is answered, declined, expired or released) or async (the agent keeps working and an answer reaches it later as its next user message). Silence, expiry and the run's end never answer either kind.",
+          "default": "blocking"
         }
       },
       "required": [

package/generated/ControlRunDetail.schema.json

@@ -9,6 +9,41 @@
           "items": {
             "type": "object",
             "properties": {
+              "programs": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "path": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "version": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "versionSource": {
+                      "type": "string",
+                      "enum": [
+                        "vendor_stream",
+                        "version_probe",
+                        "remembered",
+                        "unknown"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "path",
+                    "version",
+                    "versionSource"
+                  ],
+                  "additionalProperties": false
+                }
+              },
               "attemptId": {
                 "type": "string",
                 "minLength": 1,
@@ -706,6 +741,17 @@
                 {
                   "type": "object",
                   "properties": {
+                    "lastVendorError": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "maxLength": 1000
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
                     "requestRefusal": {
                       "anyOf": [
                         {
@@ -1330,6 +1376,11 @@
                       "items": {
                         "type": "object",
                         "properties": {
+                          "lastVendorError": {
+                            "type": "string",
+                            "maxLength": 1000,
+                            "description": "Last vendor diagnostic line, bounded and redacted; never classified."
+                          },
                           "harnessId": {
                             "type": "string",
                             "minLength": 1,
@@ -2587,6 +2638,11 @@
               "default": false,
               "description": "True while at least one interactive question awaits answer, timeout, run-terminal, or interruption release."
             },
+            "asyncQuestionsOnly": {
+              "type": "boolean",
+              "default": false,
+              "description": "True while questions are pending and every one is async: the agent keeps working and the questions are attention only. False when none is pending or any pending question is blocking."
+            },
             "processScope": {
               "anyOf": [
                 {
@@ -5030,7 +5086,16 @@
                   "null"
                 ],
                 "default": null,
-                "description": "When the interaction times out into a benign decline; null = no timeout."
+                "description": "When the interaction expires unanswered; null = no automatic expiry. A blocking question then declines benignly; an async one closes and nothing is sent."
+              },
+              "delivery": {
+                "type": "string",
+                "enum": [
+                  "blocking",
+                  "async"
+                ],
+                "description": "How the asking agent waits for the answer: blocking (its native tool call waits until the question is answered, declined, expired or released) or async (the agent keeps working and an answer reaches it later as its next user message). Silence, expiry and the run's end never answer either kind.",
+                "default": "blocking"
               }
             },
             "required": [