{
  "$schema": "../../schemas/service.schema.json",
  "kind": "service",
  "name": "tcp",
  "version": "1.0.0-draft.1",
  "purpose": "TCP capability acquired through a declared System Service.",
  "declarationSchema": "../../../../Service.schema.json",
  "types": "types.json",
  "lookupParameters": {
    "type": "tcp.LookupParameters",
    "required": true
  },
  "functions": {
    "getRequestProtocol": {
      "parameters": [],
      "returns": "tcp.Protocol",
      "purpose": "Protocol selected by lookup parameters.",
      "statementOnly": false
    },
    "send": {
      "parameters": [
        {
          "name": "message",
          "type": "tcp.Message",
          "required": true
        },
        {
          "name": "asynchronous",
          "type": "core.boolean",
          "required": false,
          "default": false
        }
      ],
      "returns": {
        "nullable": "tcp.Message"
      },
      "purpose": "Response Message, or null for asynchronous submission.",
      "statementOnly": false
    }
  },
  "rules": [
    "RequestProtocol and ResponseProtocol lookup parameters select declared protocol names. getRequestProtocol returns the selected request protocol; newMessage constructs its typed message.",
    "Message load and data use the protocol section and field structure. Framing, encoding, bitmaps and TLV follow the declared protocol contract, not arbitrary socket code. A protocol bitmap selects fields by their declared identifiers from ordinary section data; it does not require a Process-created bit-set handle. Standalone native msb/lsb scalar fields have no AIScript value representation in this contract.",
    "send returns the decoded response Message. Asynchronous submission returns null, runs the complete exchange and discards its response. It is not durable delivery."
  ]
}
