codex/codex-rs/app-server-protocol/schema/json/v2/HooksListResponse.json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "definitions": {
    "AbsolutePathBuf": {
      "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
      "type": "string"
    },
    "HookErrorInfo": {
      "properties": {
        "message": {
          "type": "string"
        },
        "path": {
          "type": "string"
        }
      },
      "required": [
        "message",
        "path"
      ],
      "type": "object"
    },
    "HookEventName": {
      "enum": [
        "preToolUse",
        "permissionRequest",
        "postToolUse",
        "sessionStart",
        "userPromptSubmit",
        "stop"
      ],
      "type": "string"
    },
    "HookHandlerType": {
      "enum": [
        "command",
        "prompt",
        "agent"
      ],
      "type": "string"
    },
    "HookMetadata": {
      "properties": {
        "command": {
          "type": [
            "string",
            "null"
          ]
        },
        "enabled": {
          "type": "boolean"
        },
        "eventName": {
          "$ref": "#/definitions/HookEventName"
        },
        "handlerType": {
          "$ref": "#/definitions/HookHandlerType"
        },
        "key": {
          "type": "string"
        },
        "matcher": {
          "type": [
            "string",
            "null"
          ]
        },
        "pluginId": {
          "type": [
            "string",
            "null"
          ]
        },
        "source": {
          "$ref": "#/definitions/HookSource"
        },
        "sourcePath": {
          "$ref": "#/definitions/AbsolutePathBuf"
        },
        "sourceRelativePath": {
          "type": [
            "string",
            "null"
          ]
        },
        "statusMessage": {
          "type": [
            "string",
            "null"
          ]
        },
        "timeoutSec": {
          "format": "uint64",
          "minimum": 0.0,
          "type": [
            "integer",
            "null"
          ]
        }
      },
      "required": [
        "enabled",
        "eventName",
        "handlerType",
        "key",
        "source",
        "sourcePath"
      ],
      "type": "object"
    },
    "HookSource": {
      "enum": [
        "system",
        "user",
        "project",
        "mdm",
        "sessionFlags",
        "plugin",
        "legacyManagedConfigFile",
        "legacyManagedConfigMdm",
        "unknown"
      ],
      "type": "string"
    },
    "HooksListEntry": {
      "properties": {
        "cwd": {
          "type": "string"
        },
        "errors": {
          "items": {
            "$ref": "#/definitions/HookErrorInfo"
          },
          "type": "array"
        },
        "hooks": {
          "items": {
            "$ref": "#/definitions/HookMetadata"
          },
          "type": "array"
        }
      },
      "required": [
        "cwd",
        "errors",
        "hooks"
      ],
      "type": "object"
    }
  },
  "properties": {
    "data": {
      "items": {
        "$ref": "#/definitions/HooksListEntry"
      },
      "type": "array"
    }
  },
  "required": [
    "data"
  ],
  "title": "HooksListResponse",
  "type": "object"
}