hook-surface:stop

{
  "id": "hook-surface:stop",
  "_kind": "HookSurface",
  "_file": "channels-hooks/hook-surfaces/canonical/stop.yaml",
  "_cluster": "channels-hooks",
  "attributes": {
    "eventName": "Stop (canonical)",
    "displayName": "Stop (canonical)",
    "kind": "canonical",
    "direction": "event",
    "blocking": true,
    "family": "in-process",
    "payloadSchema": {
      "type": "object",
      "required": [
        "session_id",
        "transcript_path"
      ],
      "properties": {
        "session_id": {
          "type": "string"
        },
        "transcript_path": {
          "type": "string"
        },
        "stop_hook_active": {
          "type": "boolean",
          "description": "True when the parent agent is already inside a Stop hook (avoid recursion)."
        },
        "reason": {
          "type": "string"
        }
      }
    },
    "description": "Fires when the agent is about to stop the current turn. Blocking;\nhandlers can request continuation.\n"
  },
  "outgoingEdges": [],
  "incomingEdges": [
    {
      "from": "agent-core-impl:a5c.core@current",
      "to": "hook-surface:stop",
      "kind": "fires_hook",
      "attributes": {}
    },
    {
      "from": "agent-core-impl:claude-agent-sdk.core@current",
      "to": "hook-surface:stop",
      "kind": "fires_hook",
      "attributes": {}
    },
    {
      "from": "agent-core-impl:claude-code.core@1.x",
      "to": "hook-surface:stop",
      "kind": "fires_hook",
      "attributes": {}
    },
    {
      "from": "agent-runtime-impl:claude-code.runtime@1.x",
      "to": "hook-surface:stop",
      "kind": "exposes",
      "attributes": {}
    },
    {
      "from": "hook-mapping:stop-codex",
      "to": "hook-surface:stop",
      "kind": "maps_hook",
      "attributes": {}
    },
    {
      "from": "hook-mapping:stop-cursor",
      "to": "hook-surface:stop",
      "kind": "maps_hook",
      "attributes": {}
    },
    {
      "from": "hook-mapping:stop-pi",
      "to": "hook-surface:stop",
      "kind": "maps_hook",
      "attributes": {}
    },
    {
      "from": "hook-mapping:stop-oh-my-pi",
      "to": "hook-surface:stop",
      "kind": "maps_hook",
      "attributes": {}
    },
    {
      "from": "hook-mapping:stop-codex",
      "to": "hook-surface:stop",
      "kind": "maps_hook",
      "attributes": {}
    },
    {
      "from": "hook-mapping:stop-claude-code",
      "to": "hook-surface:stop",
      "kind": "maps_hook",
      "attributes": {}
    },
    {
      "from": "hook-surface:codex.on-stop",
      "to": "hook-surface:stop",
      "kind": "canonicalized_to",
      "attributes": {}
    },
    {
      "from": "hook-surface:claude.stop",
      "to": "hook-surface:stop",
      "kind": "canonicalized_to",
      "attributes": {}
    }
  ]
}