record_operator_signal

{
  "name": "record_operator_signal",
  "resource": "account",
  "tier": "reversible",
  "grant": "synthetic_estate",
  "summary": "Report a run's ending, or its result, under a source name — a company test harness's report to the platform operator, and no act on the synthetic estate: `event` is `ok`, the run ended clean, or `failed`, it did not or its result holds a failure; `source` names what the report is about and matches `^[a-z0-9_.-]{1,64}$`; the optional `detail` is at most 200 characters and is scrubbed of addresses, URLs, and minted tokens before it is written; a `source` or a `detail` containing `control_plane_`, the prefix of the platform's own log markers, in any letter case is refused, and so is a `source` containing the prefix of a credential value. The act writes one marked console line naming the calling credential, the line the operator's alert rules read, and nothing else of its own, the platform recording and metering the call as it does every action's; the tier is reversible because a line can notify the operator. Admitted to a credential holding `synthetic_estate` or `super_admin`; a malformed request answers `invalid_request`, and the row adds no refusal name.",
  "annotations": {
    "readOnlyHint": false,
    "destructiveHint": false,
    "openWorldHint": false
  }
}

{
  "name": "record_operator_signal",
  "tier": "reversible",
  "scenario": "API-L0-12",
  "summary": "Report a run's ending, or its result, under a source name. Platform operator or its harness (the `synthetic_estate` grant or `super_admin`) only. The `event` argument is `ok` or `failed`, and `source` is 1 to 64 characters of lowercase letters, digits, underscore, full stop, and hyphen. The optional `detail` is at most 200 characters, scrubbed of addresses, URLs, and minted tokens before it is written. The call writes one marked line naming the calling credential, which the operator's alert rules read, so a `failed` report can notify the operator. It writes nothing else of its own, the platform recording and metering the call as it does every action's, and it is no act on the synthetic estate. A `source` or a `detail` containing `control_plane_`, a `source` containing the prefix of a credential value, and any other malformed member refuse `invalid_request`.",
  "owners": [
    "MAPI-17"
  ]
}

{
  "request": {
    "type": "object",
    "required": [
      "event",
      "source"
    ],
    "properties": {
      "event": {
        "type": "string",
        "enum": [
          "ok",
          "failed"
        ],
        "description": "What is reported: `ok`, the run ended clean, or `failed`, it did not end clean or its result holds a failure. Any other value refuses `invalid_request`."
      },
      "source": {
        "type": "string",
        "pattern": "^[a-z0-9_.-]{1,64}$",
        "description": "The name the report is made under, which says what it is about: 1 to 64 characters of lowercase letters, digits, underscore, full stop, and hyphen. A value outside the pattern, one containing `control_plane_`, the prefix of the platform's own log markers, or one containing the prefix of a credential value refuses `invalid_request`."
      },
      "detail": {
        "type": "string",
        "maxLength": 200,
        "description": "Optional: a short account of the ending, at most 200 characters, scrubbed of addresses, URLs, and credential values before it is written. A longer value, a value that is no string, null among them, or one containing `control_plane_` in any letter case refuses `invalid_request`."
      }
    }
  },
  "response": {
    "type": "object",
    "required": [
      "contract_version",
      "recorded",
      "event",
      "source"
    ],
    "properties": {
      "contract_version": {
        "const": 1
      },
      "recorded": {
        "const": true
      },
      "event": {
        "type": "string",
        "enum": [
          "ok",
          "failed"
        ],
        "description": "The event as given."
      },
      "source": {
        "type": "string",
        "description": "The source as given."
      }
    },
    "additionalProperties": false,
    "description": "The line was written: one marked console line naming the event, the source, the scrubbed detail, and the calling credential, and one action record naming that credential (MAPI-06). The act writes nothing else of its own, and the platform records and meters the call as it does every action's (MAPI-17)."
  }
}