governed-agentic-itsm-blueprint/schemas/tool-restart-service.json at main · denis-prilepskiy/governed-agentic-itsm-blueprint · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
{
  "tool": "restart_service",
  "version": "1.2.0",
  "description": "Restart a single service instance in the allowed namespace. Supports dry-run mode for plan verification before execution.",
  "owner": "platform-engineering",
  "input_schema": {
    "type": "object",
    "properties": {
      "service": {
        "type": "string",
        "description": "Service identifier (must be in workflow scope)"
      },
      "instance_id": {
        "type": "string",
        "description": "Specific instance to restart"
      },
      "reason": {
        "type": "string",
        "description": "Human-readable reason, attached to audit log"
      },
      "dry_run": {
        "type": "boolean",
        "default": true,
        "description": "If true, return planned steps without executing"
      },
      "traceparent": {
        "type": "string",
        "description": "W3C traceparent header for distributed tracing"
      },
      "incident_id": {
        "type": "string",
        "description": "Linked incident ID for evidence trail"
      }
    },
    "required": ["service", "instance_id", "reason"]
  },
  "output_schema": {
    "type": "object",
    "properties": {
      "planned_steps": {
        "type": "array",
        "items": { "type": "string" },
        "description": "Steps that will be (or were) executed"
      },
      "execution_id": {
        "type": "string",
        "description": "Unique execution identifier for audit"
      },
      "exit_status": {
        "type": "string",
        "enum": ["PLANNED", "SUCCESS", "FAILED", "ROLLED_BACK"],
        "description": "Outcome of the tool invocation"
      },
      "started_at": {
        "type": "string",
        "format": "date-time"
      },
      "ended_at": {
        "type": "string",
        "format": "date-time"
      },
      "raw_logs_ref": {
        "type": "string",
        "description": "URI to execution logs in the evidence store"
      }
    },
    "required": ["exit_status"]
  },
  "safety": {
    "idempotent": false,
    "supports_dry_run": true,
    "max_calls_per_incident": 1,
    "requires_validation": true,
    "rollback_tool": "restart_service_rollback",
    "blast_radius": "single-instance",
    "privilege_level": "service-operator",
    "audit_required": true
  }
}