tutti/packages/agent/daemon/runtime/codexproto/schema/json/v2/HookCompletedNotification.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"
    },
    "HookEventName": {
      "enum": [
        "preToolUse",
        "permissionRequest",
        "postToolUse",
        "preCompact",
        "postCompact",
        "sessionStart",
        "userPromptSubmit",
        "subagentStart",
        "subagentStop",
        "stop"
      ],
      "type": "string"
    },
    "HookExecutionMode": {
      "enum": ["sync", "async"],
      "type": "string"
    },
    "HookHandlerType": {
      "enum": ["command", "prompt", "agent"],
      "type": "string"
    },
    "HookOutputEntry": {
      "properties": {
        "kind": {
          "$ref": "#/definitions/HookOutputEntryKind"
        },
        "text": {
          "type": "string"
        }
      },
      "required": ["kind", "text"],
      "type": "object"
    },
    "HookOutputEntryKind": {
      "enum": ["warning", "stop", "feedback", "context", "error"],
      "type": "string"
    },
    "HookRunStatus": {
      "enum": ["running", "completed", "failed", "blocked", "stopped"],
      "type": "string"
    },
    "HookRunSummary": {
      "properties": {
        "completedAt": {
          "format": "int64",
          "type": ["integer", "null"]
        },
        "displayOrder": {
          "format": "int64",
          "type": "integer"
        },
        "durationMs": {
          "format": "int64",
          "type": ["integer", "null"]
        },
        "entries": {
          "items": {
            "$ref": "#/definitions/HookOutputEntry"
          },
          "type": "array"
        },
        "eventName": {
          "$ref": "#/definitions/HookEventName"
        },
        "executionMode": {
          "$ref": "#/definitions/HookExecutionMode"
        },
        "handlerType": {
          "$ref": "#/definitions/HookHandlerType"
        },
        "id": {
          "type": "string"
        },
        "scope": {
          "$ref": "#/definitions/HookScope"
        },
        "source": {
          "allOf": [
            {
              "$ref": "#/definitions/HookSource"
            }
          ],
          "default": "unknown"
        },
        "sourcePath": {
          "$ref": "#/definitions/AbsolutePathBuf"
        },
        "startedAt": {
          "format": "int64",
          "type": "integer"
        },
        "status": {
          "$ref": "#/definitions/HookRunStatus"
        },
        "statusMessage": {
          "type": ["string", "null"]
        }
      },
      "required": [
        "displayOrder",
        "entries",
        "eventName",
        "executionMode",
        "handlerType",
        "id",
        "scope",
        "sourcePath",
        "startedAt",
        "status"
      ],
      "type": "object"
    },
    "HookScope": {
      "enum": ["thread", "turn"],
      "type": "string"
    },
    "HookSource": {
      "enum": [
        "system",
        "user",
        "project",
        "mdm",
        "sessionFlags",
        "plugin",
        "cloudRequirements",
        "cloudManagedConfig",
        "legacyManagedConfigFile",
        "legacyManagedConfigMdm",
        "unknown"
      ],
      "type": "string"
    }
  },
  "properties": {
    "run": {
      "$ref": "#/definitions/HookRunSummary"
    },
    "threadId": {
      "type": "string"
    },
    "turnId": {
      "type": ["string", "null"]
    }
  },
  "required": ["run", "threadId"],
  "title": "HookCompletedNotification",
  "type": "object"
}