@claudexor/schema 2.0.0 → 2.1.1

package/generated/ControlCredentialProfileCreateResponse.schema.json

@@ -0,0 +1,142 @@
+{
+  "$ref": "#/definitions/ControlCredentialProfileCreateResponse",
+  "definitions": {
+    "ControlCredentialProfileCreateResponse": {
+      "type": "object",
+      "properties": {
+        "profile": {
+          "type": "object",
+          "properties": {
+            "profile_id": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Stable user-chosen profile identifier (unique per harness)."
+            },
+            "harness_id": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Harness family this profile belongs to."
+            },
+            "display_name": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Human label shown wherever the profile appears."
+            },
+            "credential_kind": {
+              "type": "string",
+              "enum": [
+                "config_dir_login",
+                "oauth_token",
+                "api_key"
+              ],
+              "description": "Credential transport a profile isolates: a scoped vendor config-dir login, a stored OAuth token, or a stored API key."
+            },
+            "isolation_locator": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "default": null,
+              "description": "Canonical absolute config-dir path for config_dir_login profiles; null for secret-ref kinds."
+            },
+            "secret_ref": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "default": null,
+              "description": "Namespaced secret-store name (e.g. claude_oauth:work) for oauth_token/api_key profiles; null for config_dir_login."
+            },
+            "enabled": {
+              "type": "boolean",
+              "default": true,
+              "description": "Disabled profiles are never routable."
+            },
+            "created_at": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "ISO-8601 timestamp string."
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "When the profile was registered; null for hand-written config entries.",
+              "default": null
+            }
+          },
+          "required": [
+            "profile_id",
+            "harness_id",
+            "display_name",
+            "credential_kind"
+          ],
+          "additionalProperties": false,
+          "description": "Durable non-secret registry entry for one credential identity of one harness; secret material lives in the vendor dir or the secret store, never here."
+        },
+        "status": {
+          "type": "object",
+          "properties": {
+            "profile_id": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Non-empty identifier string."
+            },
+            "harness_id": {
+              "$ref": "#/definitions/ControlCredentialProfileCreateResponse/properties/status/properties/profile_id"
+            },
+            "availability": {
+              "type": "string",
+              "enum": [
+                "available",
+                "unavailable",
+                "unknown"
+              ]
+            },
+            "verification": {
+              "type": "string",
+              "enum": [
+                "passed",
+                "failed",
+                "not_run"
+              ]
+            },
+            "detail": {
+              "type": "string",
+              "description": "Redacted human-readable probe evidence."
+            },
+            "last_verified_at": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ControlCredentialProfileCreateResponse/properties/profile/properties/created_at/anyOf/0"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "When a probe last verified this profile; null = never verified.",
+              "default": null
+            }
+          },
+          "required": [
+            "profile_id",
+            "harness_id",
+            "availability",
+            "verification"
+          ],
+          "additionalProperties": false,
+          "description": "Doctor-owned readiness projection for one credential profile; never durable config."
+        }
+      },
+      "required": [
+        "profile",
+        "status"
+      ],
+      "additionalProperties": false,
+      "description": "The registered profile with its initial doctor readiness projection."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlCredentialProfileDeleteResponse.schema.json

@@ -0,0 +1,107 @@
+{
+  "$ref": "#/definitions/ControlCredentialProfileDeleteResponse",
+  "definitions": {
+    "ControlCredentialProfileDeleteResponse": {
+      "type": "object",
+      "properties": {
+        "profile": {
+          "type": "object",
+          "properties": {
+            "profile_id": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Stable user-chosen profile identifier (unique per harness)."
+            },
+            "harness_id": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Harness family this profile belongs to."
+            },
+            "display_name": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Human label shown wherever the profile appears."
+            },
+            "credential_kind": {
+              "type": "string",
+              "enum": [
+                "config_dir_login",
+                "oauth_token",
+                "api_key"
+              ],
+              "description": "Credential transport a profile isolates: a scoped vendor config-dir login, a stored OAuth token, or a stored API key."
+            },
+            "isolation_locator": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "default": null,
+              "description": "Canonical absolute config-dir path for config_dir_login profiles; null for secret-ref kinds."
+            },
+            "secret_ref": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "default": null,
+              "description": "Namespaced secret-store name (e.g. claude_oauth:work) for oauth_token/api_key profiles; null for config_dir_login."
+            },
+            "enabled": {
+              "type": "boolean",
+              "default": true,
+              "description": "Disabled profiles are never routable."
+            },
+            "created_at": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "ISO-8601 timestamp string."
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "When the profile was registered; null for hand-written config entries.",
+              "default": null
+            }
+          },
+          "required": [
+            "profile_id",
+            "harness_id",
+            "display_name",
+            "credential_kind"
+          ],
+          "additionalProperties": false,
+          "description": "The removed registry entry."
+        },
+        "removed": {
+          "type": "boolean",
+          "const": true
+        },
+        "credentialCleanup": {
+          "type": "string",
+          "enum": [
+            "config_dir_removed",
+            "secret_deleted",
+            "none"
+          ],
+          "description": "What credential material was deleted alongside the registry entry."
+        },
+        "cleanupWarning": {
+          "type": "string",
+          "description": "Present when the registry entry was removed but cleanup failed (orphan left)."
+        }
+      },
+      "required": [
+        "profile",
+        "removed",
+        "credentialCleanup"
+      ],
+      "additionalProperties": false,
+      "description": "Receipt for a credential-profile removal."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlCredentialProfilesResponse.schema.json

@@ -0,0 +1,155 @@
+{
+  "$ref": "#/definitions/ControlCredentialProfilesResponse",
+  "definitions": {
+    "ControlCredentialProfilesResponse": {
+      "type": "object",
+      "properties": {
+        "profiles": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "profile": {
+                "type": "object",
+                "properties": {
+                  "profile_id": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Stable user-chosen profile identifier (unique per harness)."
+                  },
+                  "harness_id": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Harness family this profile belongs to."
+                  },
+                  "display_name": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Human label shown wherever the profile appears."
+                  },
+                  "credential_kind": {
+                    "type": "string",
+                    "enum": [
+                      "config_dir_login",
+                      "oauth_token",
+                      "api_key"
+                    ],
+                    "description": "Credential transport a profile isolates: a scoped vendor config-dir login, a stored OAuth token, or a stored API key."
+                  },
+                  "isolation_locator": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "default": null,
+                    "description": "Canonical absolute config-dir path for config_dir_login profiles; null for secret-ref kinds."
+                  },
+                  "secret_ref": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "default": null,
+                    "description": "Namespaced secret-store name (e.g. claude_oauth:work) for oauth_token/api_key profiles; null for config_dir_login."
+                  },
+                  "enabled": {
+                    "type": "boolean",
+                    "default": true,
+                    "description": "Disabled profiles are never routable."
+                  },
+                  "created_at": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "minLength": 1,
+                        "description": "ISO-8601 timestamp string."
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "When the profile was registered; null for hand-written config entries.",
+                    "default": null
+                  }
+                },
+                "required": [
+                  "profile_id",
+                  "harness_id",
+                  "display_name",
+                  "credential_kind"
+                ],
+                "additionalProperties": false,
+                "description": "Durable non-secret registry entry for one credential identity of one harness; secret material lives in the vendor dir or the secret store, never here."
+              },
+              "status": {
+                "type": "object",
+                "properties": {
+                  "profile_id": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Non-empty identifier string."
+                  },
+                  "harness_id": {
+                    "$ref": "#/definitions/ControlCredentialProfilesResponse/properties/profiles/items/properties/status/properties/profile_id"
+                  },
+                  "availability": {
+                    "type": "string",
+                    "enum": [
+                      "available",
+                      "unavailable",
+                      "unknown"
+                    ]
+                  },
+                  "verification": {
+                    "type": "string",
+                    "enum": [
+                      "passed",
+                      "failed",
+                      "not_run"
+                    ]
+                  },
+                  "detail": {
+                    "type": "string",
+                    "description": "Redacted human-readable probe evidence."
+                  },
+                  "last_verified_at": {
+                    "anyOf": [
+                      {
+                        "$ref": "#/definitions/ControlCredentialProfilesResponse/properties/profiles/items/properties/profile/properties/created_at/anyOf/0"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "When a probe last verified this profile; null = never verified.",
+                    "default": null
+                  }
+                },
+                "required": [
+                  "profile_id",
+                  "harness_id",
+                  "availability",
+                  "verification"
+                ],
+                "additionalProperties": false,
+                "description": "Doctor-owned readiness projection for one credential profile; never durable config."
+              }
+            },
+            "required": [
+              "profile",
+              "status"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Every registered credential profile paired with its doctor readiness projection."
+        }
+      },
+      "required": [
+        "profiles"
+      ],
+      "additionalProperties": false,
+      "description": "Credential-profile registry listing with per-profile doctor readiness."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlGcReceipt.schema.json

@@ -0,0 +1,170 @@
+{
+  "$ref": "#/definitions/ControlGcReceipt",
+  "definitions": {
+    "ControlGcReceipt": {
+      "type": "object",
+      "properties": {
+        "schema_version": {
+          "type": "number",
+          "const": 1,
+          "default": 1
+        },
+        "dry_run": {
+          "type": "boolean",
+          "description": "Whether disk was left untouched."
+        },
+        "started_at": {
+          "type": "string",
+          "description": "Pass start (ISO 8601)."
+        },
+        "finished_at": {
+          "type": "string",
+          "description": "Pass end (ISO 8601)."
+        },
+        "policy": {
+          "type": "object",
+          "properties": {
+            "runs_max_age_days": {
+              "type": "integer",
+              "exclusiveMinimum": 0
+            },
+            "reviews_max_age_days": {
+              "type": "integer",
+              "exclusiveMinimum": 0
+            },
+            "keep_last_runs_per_project": {
+              "type": "integer",
+              "minimum": 0
+            }
+          },
+          "required": [
+            "runs_max_age_days",
+            "reviews_max_age_days",
+            "keep_last_runs_per_project"
+          ],
+          "additionalProperties": false,
+          "description": "The effective retention policy this pass applied."
+        },
+        "examined_runs": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Run trees examined."
+        },
+        "deleted_runs": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "run_id": {
+                "type": "string",
+                "description": "Deleted (or would-be-deleted) run id."
+              },
+              "project_root": {
+                "type": "string",
+                "description": "Canonical project root owning the run tree."
+              },
+              "freed_bytes": {
+                "type": "integer",
+                "minimum": 0,
+                "description": "Bytes the tree occupied."
+              }
+            },
+            "required": [
+              "run_id",
+              "project_root",
+              "freed_bytes"
+            ],
+            "additionalProperties": false
+          },
+          "default": [],
+          "description": "Run trees deleted (or would-be under dry_run), tombstones left behind."
+        },
+        "kept": {
+          "type": "object",
+          "properties": {
+            "active": {
+              "type": "integer",
+              "minimum": 0,
+              "default": 0
+            },
+            "recent": {
+              "type": "integer",
+              "minimum": 0,
+              "default": 0
+            },
+            "young": {
+              "type": "integer",
+              "minimum": 0,
+              "default": 0
+            },
+            "referenced": {
+              "type": "integer",
+              "minimum": 0,
+              "default": 0
+            },
+            "actionable": {
+              "type": "integer",
+              "minimum": 0,
+              "default": 0
+            },
+            "unknown_state": {
+              "type": "integer",
+              "minimum": 0,
+              "default": 0
+            }
+          },
+          "additionalProperties": false,
+          "description": "Why every surviving candidate survived."
+        },
+        "deleted_reviews": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "path": {
+                "type": "string",
+                "description": "Deleted standalone diff-review tree."
+              },
+              "freed_bytes": {
+                "type": "integer",
+                "minimum": 0
+              }
+            },
+            "required": [
+              "path",
+              "freed_bytes"
+            ],
+            "additionalProperties": false
+          },
+          "default": [],
+          "description": "Standalone diff-review trees deleted (or would-be under dry_run)."
+        },
+        "freed_bytes": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Total bytes freed (or reclaimable under dry_run)."
+        },
+        "errors": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": [],
+          "description": "Non-fatal per-tree failures; the pass continues past them."
+        }
+      },
+      "required": [
+        "dry_run",
+        "started_at",
+        "finished_at",
+        "policy",
+        "examined_runs",
+        "kept",
+        "freed_bytes"
+      ],
+      "additionalProperties": false,
+      "description": "Typed receipt of one retention pass."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/generated/ControlGcRequest.schema.json

@@ -0,0 +1,18 @@
+{
+  "$ref": "#/definitions/ControlGcRequest",
+  "definitions": {
+    "ControlGcRequest": {
+      "type": "object",
+      "properties": {
+        "dry_run": {
+          "type": "boolean",
+          "default": false,
+          "description": "Report what WOULD be deleted without touching disk."
+        }
+      },
+      "additionalProperties": false,
+      "description": "Run one retention pass over engine-owned runtime artifacts."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}