@claudexor/schema 5.0.2 → 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/ControlQueuedRunInfo.schema.json

@@ -12,7 +12,7 @@
         "storeId": {
           "type": "string",
           "minLength": 1,
-          "description": "Identity of the durable engine store that accepted this group member, stable across restarts."
+          "description": "Identity of the durable engine store that accepted this command, stable across restarts. A group member always carries it; an ordinary receipt carries it only for a request sending `X-Claudexor-Store-Identity: 1`, and it stays absent, meaning unknown, when the store has no identity to give."
         },
         "jobId": {
           "type": "string",

package/generated/ControlResource.schema.json

@@ -14,6 +14,11 @@
           "const": "model",
           "description": "Immutable model-operation purpose; absent means a legacy or ordinary attachment."
         },
+        "lifetime": {
+          "type": "string",
+          "const": "managed",
+          "description": "managed: its caller may later release the ID (POST /v2/resources/:id/release), after which no new reference is admitted while already accepted work keeps the bytes. Absent: indefinite reuse."
+        },
         "kind": {
           "type": "string",
           "enum": [

package/generated/ControlResourceRelease.schema.json

@@ -0,0 +1,44 @@
+{
+  "$ref": "#/definitions/ControlResourceRelease",
+  "definitions": {
+    "ControlResourceRelease": {
+      "type": "object",
+      "properties": {
+        "storeId": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Durable store that released the resource."
+        },
+        "resourceId": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Non-empty identifier string."
+        },
+        "sha256": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Content hash in algo:hex form, e.g. \"sha256:abcd...\"."
+        },
+        "state": {
+          "type": "string",
+          "const": "released"
+        },
+        "releasedAt": {
+          "type": "string",
+          "minLength": 1,
+          "description": "The first release; a repeat answers the same instant."
+        }
+      },
+      "required": [
+        "storeId",
+        "resourceId",
+        "sha256",
+        "state",
+        "releasedAt"
+      ],
+      "additionalProperties": false,
+      "description": "Receipt of a released managed resource. Not a deletion: bytes stay while accepted commands, turns or drafts hold them or another live resource shares the digest."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlResourceReleaseRequest.schema.json

@@ -0,0 +1,27 @@
+{
+  "$ref": "#/definitions/ControlResourceReleaseRequest",
+  "definitions": {
+    "ControlResourceReleaseRequest": {
+      "type": "object",
+      "properties": {
+        "expectedStoreId": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Store UUID saved with the import; a different store is refused before any effect."
+        },
+        "sha256": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Digest of the resource receipt being released."
+        }
+      },
+      "required": [
+        "expectedStoreId",
+        "sha256"
+      ],
+      "additionalProperties": false,
+      "description": "Release a managed resource: no new run, turn, retry, continuation or draft may reference it afterwards; already accepted work keeps its bytes. Naturally idempotent."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}