Skip to content

Communication Request

CommunicationRequest is the canonical public input aggregate.

Shape

CommunicationRequest
  schema_version
  semantic_graph
  obligations
  supporting_context
  context
  constraints
  capability_profile
  runtime_selector?       # optional explicit RuntimeSet pin
  request_id?             # operational
  deadline?               # operational

Example

{
  "schema_version": "1.0",
  "request_id": "example:repair-4356",
  "semantic_graph": {
    "graph_id": "graph:repair-4356",
    "nodes": [
      {
        "id": "marcel",
        "kind": "entity_ref",
        "external_ref": "orgo:user/marcel",
        "labels": {"fr": "Marcel"}
      },
      {
        "id": "machine",
        "kind": "entity_ref",
        "external_ref": "orgo:machine/4356",
        "labels": {"fr": "machine 4356"}
      },
      {
        "id": "repair",
        "kind": "concept_ref",
        "concept_ref": "local-concept:repair"
      }
    ],
    "statements": [
      {
        "id": "repair_statement",
        "predicate_ref": "local-predicate:repair_event",
        "arguments": [
          {"role_ref": "semantic-role:agent", "value_id": "marcel"},
          {"role_ref": "semantic-role:patient", "value_id": "machine"},
          {"role_ref": "semantic-role:event_type", "value_id": "repair"}
        ],
        "polarity": "positive"
      }
    ]
  },
  "obligations": [
    {
      "obligation_id": "repair_task",
      "semantic_refs": ["repair_statement"],
      "force": "DIRECT"
    }
  ],
  "context": {
    "target_language": "fr",
    "target_locale": "fr-CA",
    "formality": "informal",
    "register": "operational"
  },
  "constraints": {
    "allowed_block_kinds": ["utterance", "list"],
    "opening_policy": "allowed",
    "closing_policy": "allowed",
    "list_policy": "allowed",
    "output_format": "structured"
  },
  "capability_profile": "orgo-operational-1"
}

CommunicationContext

Context may control wording, pronouns, register, politeness and segmentation, but it must not alter the obligation set.

Typical fields:

  • target language/locale;
  • speaker and recipient;
  • relationship;
  • formality;
  • politeness;
  • register;
  • tone profile;
  • channel;
  • bounded discourse context.

PresentationConstraints

Constraints describe permitted presentation forms:

  • allowed block kinds;
  • opening/closing policy;
  • list policy;
  • terminology profile;
  • optional maximum length;
  • output format.

A hard constraint that can only be met by deleting required meaning makes the request unsatisfiable.