Skip to content

Middleware Channel Call Result v1

Source schema: doc/schemas/middleware-channel-call-result.v1.schema.json

Redacted host-capability result with explicit retry and policy failure semantics.

Governing Basis

Project Lineage

Fields

Field Required Shape Description
schema yes const: middleware-channel-call-result.v1
schema/v yes const: 1
outcome yes enum: succeeded, refused, failed
result/schema yes string | null
result yes any
failure yes unspecified

Definitions

Definition Shape Description
failure object

Conditional Rules

Rule 1

When:

{
  "properties": {
    "outcome": {
      "const": "succeeded"
    }
  },
  "required": [
    "outcome"
  ]
}

Then:

{
  "properties": {
    "result/schema": {
      "type": "string"
    },
    "result": {
      "not": {
        "type": "null"
      }
    },
    "failure": {
      "type": "null"
    }
  }
}

Rule 2

When:

{
  "properties": {
    "outcome": {
      "const": "refused"
    }
  },
  "required": [
    "outcome"
  ]
}

Then:

{
  "properties": {
    "result/schema": {
      "type": "null"
    },
    "result": {
      "type": "null"
    },
    "failure": {
      "allOf": [
        {
          "$ref": "#/$defs/failure"
        },
        {
          "properties": {
            "class": {
              "const": "policy-denied"
            }
          }
        }
      ]
    }
  }
}

Rule 3

When:

{
  "properties": {
    "outcome": {
      "const": "failed"
    }
  },
  "required": [
    "outcome"
  ]
}

Then:

{
  "properties": {
    "result/schema": {
      "type": "null"
    },
    "result": {
      "type": "null"
    },
    "failure": {
      "allOf": [
        {
          "$ref": "#/$defs/failure"
        },
        {
          "properties": {
            "class": {
              "enum": [
                "retryable",
                "terminal"
              ]
            }
          }
        }
      ]
    }
  }
}

Field Semantics

schema

  • Required: yes
  • Shape: const: middleware-channel-call-result.v1

schema/v

  • Required: yes
  • Shape: const: 1

outcome

  • Required: yes
  • Shape: enum: succeeded, refused, failed

result/schema

  • Required: yes
  • Shape: string | null

result

  • Required: yes
  • Shape: any

failure

  • Required: yes
  • Shape: unspecified

Definition Semantics

$defs.failure

  • Shape: object